> ## 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.

# Fuentes y tipos de millaje

> Configura las fuentes de millaje Customer y Dispatch en una carga para controlar facturación, pago de liquidación del conductor y recálculo automático de ruta.

<Note>
  📋 **Se aplica a:** Todos los usuarios (ver millaje); usuarios que pueden editar la carga (editar millaje)

  **Módulo:** Loads and Trips

  Alvys rastrea dos tipos de millaje en cada carga: millaje Customer usado para facturación y millaje Dispatch usado para liquidaciones de conductores. Cada tipo puede establecerse en una de varias fuentes que determinan de dónde proviene el valor de millaje y si se recalcula automáticamente cuando cambia la ruta.
</Note>

## Resumen

El millaje en Alvys controla dos flujos de facturación distintos. El millaje Customer determina lo que aparece en la factura del cliente. El millaje Dispatch se divide por viaje en Loaded Miles y Empty Miles y determina lo que se paga a los conductores.

Usar la fuente de millaje correcta en cada carga garantiza facturas precisas, liquidaciones correctas de conductores e informes confiables.

## Dónde encontrarlo

Los campos de millaje aparecen en la página de detalles de la carga en la sección Stops. Cada fila de parada muestra el millaje calculado o ingresado.

El millaje Customer es visible en la vista previa de la factura y en los detalles del encabezado de la carga. El millaje Dispatch por viaje se muestra en la sección Trips de la carga.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/9353191194ba.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=2718778c385bf2af918bd60438934582" alt="Página de detalles de la carga que muestra los campos de millaje Customer y Dispatch en la sección Stops." width="1891" height="791" data-path="images/help/9353191194ba.png" />

  * Página de detalles de la carga que muestra los campos de millaje Customer y Dispatch en la sección Stops.\*

      <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/86542718580b.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=8fc5a3611ce99b7d00d194baff259660" alt="Notion Image" width="1136" height="922" data-path="images/help/86542718580b.png" />
</Note>

## Conceptos clave

### Tipos de millaje

Alvys usa dos tipos de millaje en cada carga.

**Millaje Customer** es el total de millas usado para facturación al cliente. Aparece en la factura del cliente y en la confirmación de tarifa. Es un valor único para toda la carga.

**Millaje Dispatch** se usa para liquidaciones de conductores. Se rastrea por viaje y se divide en dos componentes: Loaded Miles (millas conducidas con carga) y Empty Miles (millas conducidas sin carga, como deadhead entre viajes).

### Fuentes de millaje

La fuente determina de dónde proviene el valor de millaje. Las fuentes disponibles difieren según el tipo de millaje.

**Automatic** (disponible para millaje Customer y Dispatch): El motor de millaje calcula las millas según las direcciones actuales de las paradas. Si se agregan, eliminan o reordenan paradas, el millaje Automatic se recalcula. Esta es la fuente recomendada para la mayoría de las cargas.

**Manual** (disponible para millaje Customer y Dispatch): Ingresas el valor de millaje directamente. El millaje manual no se recalcula cuando cambian las paradas. Se muestra una notificación para recordarte que el millaje fue ingresado por el usuario y no se actualizará automáticamente.

**Customer Contract** (disponible solo para millaje Customer): El millaje se obtiene de la tarifa de carril contratada en el perfil del cliente. Esta fuente se usa cuando el cliente tiene un contrato de tarifa de carril con un millaje definido. El millaje no se recalcula cuando cambian las paradas. Se muestra una notificación.

**Customer Tender** (disponible solo para millaje Customer): El millaje se obtiene del tender EDI transmitido por el cliente. Esta fuente solo está disponible cuando la integración EDI Tenders está activa para el cliente. El millaje no se recalcula cuando cambian las paradas. Se muestra una notificación.

### Motores de millaje

Cuando la fuente está en Automatic, uno de los siguientes motores de millaje calcula la distancia de la ruta.

**PCMiler** es el motor de millaje predeterminado en Alvys. Calcula distancias de enrutamiento comercial para camiones. La mayoría de las cargas usarán PCMiler a menos que se haya configurado un motor distinto.

**HereMaps** es un motor de enrutamiento alternativo disponible como opción de configuración.

**Google Maps** es un motor de enrutamiento alternativo disponible como opción de configuración.

**MileMaker** es un motor de enrutamiento alternativo disponible como opción de configuración.

El motor activo lo establece tu administrador de Alvys y se aplica a todo el tenant. Contacta a tu administrador si necesitas confirmar o cambiar el motor de millaje en uso.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/932ef528dd4c.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=e5b162d69b83f6baf4f07eafa7ca7f0f" alt="Global Settings donde el admin puede crear y editar Mileage Profiles para millaje customer y dispatch." width="2932" height="1360" data-path="images/help/932ef528dd4c.png" />

  \*Global Settings donde el admin puede crear y editar Mileage Profiles para millaje customer y dispatch. \*
</Note>

### Notificaciones de millaje

Cuando el millaje Customer o Dispatch está en cualquier fuente distinta de Automatic, Alvys muestra una notificación en la carga para alertar a despachadores y usuarios de facturación de que el millaje es fijo y no se recalculará.

Esta notificación aparece cerca de los campos de millaje en la página de detalles de la carga. Es informativa y no bloquea ninguna acción.

## Configuración y permisos

Ver millaje en una carga está disponible para todos los usuarios autenticados de Alvys. No se requiere ningún permiso adicional para ver valores de millaje.

Editar millaje (cambiar la fuente o ingresar un valor manual) requiere permiso para editar la carga. No se requiere un permiso específico de millaje.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/e8b621a6dbb9.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=4a5eaa61b8637047b9237abd0f9d06a1" alt="Permiso para editar millas" width="1731" height="864" data-path="images/help/e8b621a6dbb9.png" />

  *Permiso para editar millas*
</Note>

### Prioridad de fuente de millaje Customer

Cuando se crea una carga nueva, Alvys determina la fuente de millaje Customer predeterminada en el siguiente orden:

1. La fuente de millaje configurada en el perfil del cliente en Alvys.
2. La fuente de millaje predeterminada a nivel de tenant configurada en Tenant Management settings.
3. El valor predeterminado del sistema: Automatic usando PCMiler.

Si un perfil de cliente tiene una fuente de millaje configurada, esa fuente tiene prioridad sobre la configuración a nivel de tenant.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/94fd806de427.jpeg?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=6dd6b63492acf791075fbf86c2572098" alt="Configuración de fuente de millaje del perfil de cliente en el módulo Companies." width="1776" height="608" data-path="images/help/94fd806de427.jpeg" />

  *Configuración de fuente de millaje del perfil de cliente en el módulo Companies.*
</Note>

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/98207f10356e.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=dcac6e3ed0ea4dd17131cffd097a9b49" alt="Panel de configuración predeterminada de millaje en Tenant Management." width="2904" height="994" data-path="images/help/98207f10356e.png" />

  *Panel de configuración predeterminada de millaje en Tenant Management.*
</Note>

### Fuentes de millaje Dispatch

El millaje Dispatch solo admite fuentes Automatic y Manual. Customer Contract y Customer Tender no están disponibles para millaje Dispatch.

## Límites y comportamiento

* Fuentes de millaje Customer: Automatic, Manual, Customer Contract, Customer Tender.
* Fuentes de millaje Dispatch: solo Automatic y Manual.
* El millaje Automatic se recalcula siempre que se agregan, eliminan o reordenan paradas.
* El millaje Manual, Customer Contract y Customer Tender no se recalcula cuando cambia la ruta.
* Editar la parada previa de un viaje recalcula las Empty Miles en todos los viajes, sea cual sea la fuente de millaje Dispatch del viaje. El valor recalculado aparece en cuanto guarda, sin recargar la página. Si la consulta de millaje falla, las Empty Miles se borran en lugar de quedarse con la cifra anterior, así que un campo en blanco significa "aún no calculado" y no cero. Vuelva a guardar la parada previa para intentarlo de nuevo.
* Un valor de millaje Dispatch que ingresó a mano sigue sin ser sobrescrito nunca por un recálculo automático. Solo se recalcula el tramo de la parada previa que hay detrás de las Empty Miles.
* El motor de millaje predeterminado es PCMiler.
* Cambiar el motor de millaje a nivel de tenant afecta todas las cargas nuevas; las cargas existentes no se actualizan retroactivamente.
* La fuente de millaje Customer Tender solo está disponible cuando la integración EDI Tenders está activa.

## Preguntas frecuentes

**P: ¿Por qué mi millaje Customer muestra una notificación y no se recalcula cuando actualizo paradas?**

**R:** La fuente de millaje está en Manual, Customer Contract o Customer Tender. Estas fuentes son valores fijos que no se recalculan automáticamente. Para que el millaje se recalcule, cambia la fuente a Automatic.

**P: Cambié la parada previa de un viaje. ¿Por qué las Empty Miles quedaron en blanco?**

**R:** Un campo en blanco significa que la consulta de millaje no devolvió una distancia para la nueva parada previa, así que Alvys borró el valor en lugar de dejar la cifra anterior, que ya era incorrecta. Revise la dirección de la parada previa y vuelva a guardarla para recalcular. Un campo en blanco nunca equivale a cero millas.

**P: ¿Qué motor de millaje usa Alvys de forma predeterminada?**

**R:** PCMiler es el motor de millaje predeterminado. Calcula distancias de enrutamiento comercial para camiones. Los administradores pueden configurar un motor alternativo en Tenant Management settings.

**P: ¿Puedo establecer motores de millaje distintos para millaje Customer y Dispatch?**

**R:** El motor de millaje es una configuración a nivel de tenant. Se aplica a todos los cálculos de millaje Automatic, tanto Customer como Dispatch.

**P: ¿Cómo hago que un cliente siempre use una fuente de millaje específica de forma predeterminada?**

**R:** Configura la fuente de millaje en el perfil del cliente en el módulo Companies. Esa configuración anula el valor predeterminado a nivel de tenant para cualquier carga creada para ese cliente.
