> ## Documentation Index > Fetch the complete documentation index at: https://docs.alvys.com/llms.txt > Use this file to discover all available pages before exploring further. # Contratos de recargo por combustible > Configure contratos de recargo por combustible por cliente con matrices fijas, por distancia o por porcentaje, vincúlelos a las tarifas de carril y deje que Alvys aplique el recargo automáticamente. ## Descripción general Cuando despacha una carga, el costo del combustible fluctúa. Los contratos de recargo por combustible le permiten definir reglas sobre cómo se calculan y aplican los recargos por combustible a las cargas, para que no tenga que ajustar tarifas manualmente cada vez que cambian los precios del combustible. Los contratos de recargo por combustible se configuran **por cliente** y se pueden vincular a contratos de tarifas de carril. Cuando una carga coincide con un carril que tiene un contrato de recargo por combustible, el recargo se calcula automáticamente según los precios del combustible de la semana en curso. **Navegación:** Companies > seleccione un cliente > pestaña Lane Rates > Fuel Surcharge Contracts *** ## Tipos de recargo por combustible Alvys admite tres tipos de cálculo de recargo por combustible: | **Tipo** | **Cómo funciona** | **Ideal para** | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | **Fixed** | Un importe fijo en dólares por carga O una tarifa por milla. No cambia con los precios del combustible. | Contratos simples donde el recargo es un importe fijo independientemente del costo del combustible. | | **Distance** | Una matriz de rangos de precio de combustible asociados a tarifas en dólares por milla. El sistema consulta el precio actual del combustible, encuentra el nivel correspondiente y multiplica la tarifa por las millas facturables de la carga. | Contratos donde el recargo varía según el precio del combustible y se calcula por milla. | | **Percentage** | Una matriz de rangos de precio de combustible asociados a tasas porcentuales. El sistema consulta el precio actual del combustible, encuentra el nivel correspondiente y aplica el porcentaje a la tarifa de flete de línea de la carga. | Contratos donde el recargo es un porcentaje del flete de línea y varía según el precio del combustible. | *** ## Crear un contrato de recargo por combustible ## Paso 1: ir a Fuel Surcharge Contracts 1. Vaya a **Companies** > **Customers** en la barra lateral izquierda 2. Seleccione el **cliente** para el que quiera configurar el contrato para abrir su **Customer Profile** 3. Haga clic en el botón **Contracted Lanes & Fuel Surcharges** en la esquina superior derecha de la página 4. Haga clic en la pestaña **Fuel Surcharge Contracts** 5. Haga clic en **Add New Contract** ## Paso 2: configurar los detalles del contrato Complete los siguientes campos en la pestaña **Details**: | **Campo** | **Descripción** | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Contract Name** | Un nombre descriptivo para este contrato (por ejemplo, "Cliente ABC - FSC 2026"). | | **Type** | Selecciona **Fixed**, **Distance** o **Percentage** (ver arriba). | | **Sub-Type** (solo Fixed) | Elija **Flat** (un importe por carga) o **Rate Per Mile** (importe multiplicado por las millas). | | **Amount** (solo Fixed) | Ingresa el importe en dólares del recargo. | | **Load Date** | Qué fecha de la carga determina la consulta del precio del combustible: **Scheduled Pickup**, **Actual Pickup**, **Scheduled Delivery** o **Actual Delivery**. | | **Date Offset** | Qué semana de precios de combustible de la EIA usar: **Current Week**, **Previous Week**, **Begin of Month** o **Custom Range**. | | **Custom Day Offset** | Si usa Custom Range, ingrese un ajuste de días de -9 a +9 respecto a la fecha de la carga. | | **Region** | La región geográfica para la consulta del precio del combustible de la EIA (por ejemplo, "U.S."). | | **Rounding** | Cómo redondear la tarifa calculada: centavo entero, décima de centavo, centésima de centavo — redondeado o truncado. | ## Paso 3: configurar la matriz (solo Distance y Percentage) Si seleccionó **Distance** o **Percentage** como tipo, haga clic en la pestaña **Matrix** para definir sus niveles de precio de combustible. Cada fila de la matriz representa un rango de precio de combustible y la tarifa de recargo correspondiente: | **Columna** | **Descripción** | **Ejemplo** | | --------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------- | | **Start Price** | El límite inferior del rango de precio del combustible (por galón). | \$3.00 | | **End Price** | El límite superior del rango de precio del combustible (por galón). | \$3.49 | | **Rate** | Para **Distance**: la tarifa en dólares por milla. Para **Percentage**: la tasa decimal (por ejemplo, 0.05 = 5 %). | \$0.08/mi o 0.05 | **Consejos para la matriz:** * Haga clic en **Add Row** para agregar niveles uno por uno * Haga clic en **Import CSV** para importar niveles en masa desde una hoja de cálculo (haga clic primero en **Download Template** para obtener el formato correcto) * Los niveles no deben solaparse: cada precio de combustible debe caer en exactamente un rango * Los valores admiten hasta **4 decimales** para mayor precisión * Para el tipo Percentage, ingrese las tasas como decimales (0.05 = 5 %), no como porcentajes enteros ## Paso 4: habilitar y guardar 1. Haga clic en **Save** *** ## Vincular un contrato de recargo por combustible a una tarifa de carril Una vez creado un contrato de recargo por combustible, debe vincularlo a uno o más contratos de tarifas de carril para que surta efecto en las cargas. 1. Vaya a **Companies** > **Customers** en la barra lateral izquierda 2. Seleccione el **cliente** para el que quiera configurar el contrato para abrir su **Customer Profile** 3. Haga clic en el botón **Contracted Lanes & Fuel Surcharges** en la esquina superior derecha de la página 4. Abra o **cree** un **contrato** 5. En los detalles del contrato, seleccione el **Fuel Surcharge Contract** de la lista 6. Guarde el contrato de tarifa de carril Cuando una carga coincida con este carril, el recargo por combustible se calculará y aplicará automáticamente. *** ## Cómo funciona el cálculo Cuando se crea o actualiza una carga con un contrato de tarifa de carril que tiene un recargo por combustible: 1. El sistema determina la **fecha de la carga** (según la configuración Load Date del contrato) 2. Aplique el **desplazamiento de fecha** para determinar qué semana de precios de combustible usar 3. Consulte el **precio semanal del combustible de la EIA** para la región configurada 4. Según el tipo de contrato: * **Fixed (Flat):** recargo = el importe configurado * **Fixed (Per Mile):** recargo = importe × millas facturables * **Distance:** encuentra el nivel de la matriz que coincide con el precio del combustible y luego: recargo = tarifa del nivel × millas facturables * **Percentage:** encuentra el nivel de la matriz que coincide con el precio del combustible y luego: recargo = tasa del nivel × tarifa de flete de línea 5. El resultado se **redondea** según la configuración de redondeo del contrato 6. El recargo aparece como una partida separada en la carga ⚠️ **Nota:** si las fechas de la carga son futuras y los precios del combustible aún no están disponibles, el sistema marcará el recargo para recalcularlo una vez que las fechas y los precios reales estén disponibles. *** ## Ejemplo: configurar un recargo por combustible basado en distancia Supongamos que el contrato con su cliente indica: "El recargo por combustible es de $0.02 por milla por cada aumento de $0.05 en el precio del combustible por encima de \$3.00/galón". Así lo configuraría: 1. Cree un nuevo Fuel Surcharge Contract 2. Fije **Type** en **Distance** 3. Fije **Load Date** en **Scheduled Pickup** 4. Fije **Date Offset** en **Previous Week** (lo más común) 5. Fije **Region** en **U.S.** 6. En la pestaña **Matrix**, agregue filas: | **Start Price** | **End Price** | **Rate (\$/milla)** | | --------------- | ------------- | ------------------- | | \$3.00 | \$3.049 | \$0.02 | | \$3.05 | \$3.099 | \$0.04 | | \$3.10 | \$3.149 | \$0.06 | | \$3.15 | \$3.199 | \$0.08 | Si el precio del combustible de la EIA para la semana de la carga es de $3.12/galón y la carga es de 500 millas, el recargo sería: **$0.06 × 500 = \$30.00\*\* *** ## Ejemplo: configurar un recargo por combustible basado en porcentaje Si el contrato con su cliente indica: "El recargo por combustible es un porcentaje de la tarifa de flete de línea según los precios actuales del combustible". 1. Cree un nuevo Fuel Surcharge Contract 2. Fije **Type** en **Percentage** 3. Configure Load Date, Date Offset, Region y Rounding según sea necesario 4. En la pestaña **Matrix**, agregue filas: | **Start Price** | **End Price** | **Rate (decimal)** | | --------------- | ------------- | ------------------ | | \$3.00 | \$3.49 | 0.05 | | \$3.50 | \$3.99 | 0.08 | | \$4.00 | \$4.49 | 0.11 | 💡 **Las tasas porcentuales se ingresan como decimales:** 0.05 = 5 %, 0.08 = 8 %, 0.1234 = 12.34 %. No ingrese "5" para 5 %. Si el precio del combustible es $3.75 y el flete de línea es $2,000, el recargo sería: **0.08 × $2,000 = $160.00** *** ## Preguntas frecuentes * **¿De dónde obtiene Alvys los precios del combustible?** Alvys usa los precios semanales al menudeo del diésel de la **U.S. Energy Information Administration (EIA)**, publicados cada lunes. Los precios son específicos por región y se actualizan automáticamente. * **¿Puedo tener varios contratos de recargo por combustible para el mismo cliente?** Sí. Puede crear varios contratos y asignar distintos a distintos contratos de tarifas de carril del mismo cliente. * **¿Qué ocurre si el precio del combustible queda fuera de los niveles de mi matriz?** Si el precio actual del combustible no coincide con ningún nivel de la matriz, no se aplicará ningún recargo. Asegúrese de que sus niveles cubran el rango esperado de precios del combustible. * **¿Puedo importar mi matriz desde una hoja de cálculo?** Sí. En la pestaña Matrix, haga clic en **Download Template** para obtener una plantilla CSV, complete sus niveles y luego haga clic en **Import CSV** para cargarla. * **¿Qué tan precisos pueden ser los valores de la matriz?** Todos los valores de la matriz admiten hasta **4 decimales**. Esto aplica a Start Price, End Price y Amount. * **¿Para qué sirve el Date Offset?** Los precios del combustible se publican semanalmente. El Date Offset le permite controlar qué semana de precios usar respecto a la fecha de la carga. La mayoría de los clientes usan **Previous Week**, ya que los precios de la semana en curso pueden no estar publicados al momento del despacho.