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

# Integración de combustible Pilot Flying J

> Importe transacciones de tarjeta de combustible Pilot Flying J al Fuel Report de Alvys cargando el extracto en Excel; Alvys asocia las compras con los conductores por número de tarjeta.

<Note>
  📋 **Se aplica a:** Admin · Support · Partner Admin

  **Módulo:** Management > Integrations > Fuel

  La integración de combustible Pilot Flying J le permite importar datos de transacciones de combustible desde su cuenta de tarjeta de combustible Pilot Flying J al Fuel Report de Alvys descargando un archivo de transacciones del portal Pilot Flying J y cargándolo en Alvys.
</Note>

## Qué hace esta integración

La integración de combustible Pilot Flying J le permite importar datos de transacciones de combustible desde su cuenta de tarjeta de combustible Pilot Flying J (red de combustible) al Fuel Report de Alvys. Las transacciones se asocian con los perfiles de conductor mediante el número de tarjeta de combustible de cada conductor. Es una importación manual y unidireccional: descarga un informe de transacciones (extracto) del portal Fuel Card de Pilot Flying J y carga el archivo Excel en Alvys. Alvys asocia las transacciones con los conductores usando los últimos 3 dígitos de cada número de tarjeta de combustible.

<Info>
  💡 Esta integración también se conoce como importación de tarjeta de combustible Pilot Flying J, sincronización de red de combustible o carga de transacciones de combustible. · Es manual y unidireccional (de Pilot Flying J a Alvys), sin sincronización programada ni automática.
</Info>

## Requisitos previos

Antes de configurar esta integración, confirme lo siguiente:

* Tiene acceso de **"Admin"**, **"Support"** o **"Partner Admin"** en Alvys (configurado en su rol de usuario en Company Profile).
* Sus conductores ya están agregados en Alvys.
* Tiene acceso al portal Fuel Card de Pilot Flying J.
* Conoce los últimos 3 dígitos del número de tarjeta de combustible Pilot Flying J de cada conductor.

## Conectar y autenticar

1. Haga clic en su nombre de usuario en la esquina inferior izquierda de Alvys y seleccione **Management**.
2. Seleccione la subsidiaria que desea integrar con Pilot Flying J.
3. Haga clic en el botón azul **Integrate**.
4. En la ventana emergente, abra el menú desplegable **Integration Type**.
5. Desplácese hacia abajo para encontrar **PilotFlyingJ** y selecciónelo.
6. Seleccione la subsidiaria que debe usar esta integración.
7. Haga clic en **Save**.
8. Agregue el número de tarjeta de combustible de cada conductor a su perfil para que Alvys pueda asociar las transacciones:
9. En la barra de herramientas azul de Alvys, seleccione **Assets** y luego **Drivers**.
10. Busque y haga doble clic en un conductor para abrir su perfil.
11. En la primera sección del perfil, haga clic en el signo más junto a **Fuel Card Numbers**.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/b5b32a84a9bc.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=10a5abf83e1b6e62a12b2fe8068b2990" alt="Perfil de conductor con la opción Fuel Card Numbers (+) resaltada" width="1250" height="704" data-path="images/help/b5b32a84a9bc.png" />

    *Perfil de conductor con la opción Fuel Card Numbers (+) resaltada*
12. Ingrese el número de tarjeta de combustible. Para la importación manual de Pilot Flying J, ingrese solo los **últimos 3 dígitos** del número de tarjeta de combustible.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/cb95d3c951fa.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=d3cb24efa6957c2c60ad7542ce790508" alt="Ventana emergente Add Fuel Card Number con el proveedor PilotFlyingJ" width="770" height="568" data-path="images/help/cb95d3c951fa.png" />

    *Ventana emergente Add Fuel Card Number con el proveedor PilotFlyingJ*
13. Seleccione **PilotFlyingJ** en el menú desplegable Provider.
14. Marque las casillas correspondientes si desea deducir combustible o si el combustible tiene descuento para este conductor.
15. Haga clic en **Save**.
16. Repita para cada conductor que tenga una tarjeta de combustible Pilot Flying J.
17. Descargue el informe de transacciones de combustible desde Pilot Flying J:
18. Inicie sesión en el portal Fuel Card de Pilot Flying J.
19. Vaya a **Fuel Card > Reporting/Statements > Transactions**.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=4a7364f622f26c8c249389358ddc3125" alt="Portal Pilot: Fuel Card > Reporting/Statements > Transactions" data-og-width="1360" width="1360" data-og-height="701" height="701" data-path="images/help/40a8195d86cf.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=280&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=21ccfb59b9e03043475b57efaad5987c 280w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=560&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a2615d200a36cd6224d09f8fea7bd7a5 560w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=840&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=8a676f0e0a094deea7c90f6f4021da93 840w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=1100&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=f35f6e93ce451f2c512d2a863c2760c0 1100w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=1650&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=016198e09ca2a67f85046d4619f31325 1650w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/40a8195d86cf.png?w=2500&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=075befbaad5c98504c5dacb3a44fcc3f 2500w" />

    *Portal Pilot: Fuel Card > Reporting/Statements > Transactions*
20. Elija si desea ver el informe **By Invoice** o **By Date**, seleccione el período y haga clic en **Search**.
21. Una vez generado el informe, haga clic en **Export**, seleccione **Excel** y guarde el archivo en su dispositivo.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/a5c87bb6090f.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a816f98b20d968a9a5fd8664da9e463f" alt="Exportación del informe de transacciones a Excel" width="380" height="240" data-path="images/help/a5c87bb6090f.png" />

    *Exportación del informe de transacciones a Excel*
22. Cargue el archivo de transacciones de combustible en Alvys. Antes de cargar, confirme que cada conductor tenga el número de tarjeta de combustible correcto (últimos 3 dígitos) ingresado en su perfil.
23. En la barra de herramientas azul de Alvys, seleccione **Reports** y luego **Fuel Report**.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a376db96e46185e1f2d9716fb740c99b" alt="Barra de herramientas de Alvys: Reports > Fuel Report" data-og-width="670" width="670" data-og-height="530" height="530" data-path="images/help/bb9cc9ea003d.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=280&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=6eb5f1c283551323c7b837a833627bce 280w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=560&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=3cf4773fac33a88dbd9ceac4ef2391c2 560w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=840&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=2e03024b535a825a0357002362cd8e53 840w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=1100&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=1e5e635a1a429f472b39bd898bd2e362 1100w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=1650&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=e1fa7110f4b6be75205e3df386322f64 1650w, https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/bb9cc9ea003d.png?w=2500&fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=7268a31f2d47434085515dbdb1dfeb58 2500w" />

    *Barra de herramientas de Alvys: Reports > Fuel Report*
24. Haga clic en el botón azul **Transaction File Upload**.
25. En la ventana emergente, seleccione **PilotFlyingJ** en el menú desplegable **Integration Type**.

    <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/a56c19909557.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=b44e18f55e1847ba6f05f73d5faeed15" alt="Ventana emergente Quick Upload con PilotFlyingJ como Integration Type" width="1010" height="525" data-path="images/help/a56c19909557.png" />

    *Ventana emergente Quick Upload con PilotFlyingJ como Integration Type*
26. Haga clic en el botón azul para buscar su archivo, o arrastre y suelte el archivo Excel que exportó desde el portal Pilot Flying J.
27. Cargue el archivo.
28. Una vez completada la carga, use el filtro de rango **Transaction Date** en Fuel Report para revisar las transacciones importadas.

## Field & Data Mapping

* **Clave de asociación:** Alvys asocia las transacciones con los perfiles de conductor mediante el número de tarjeta de combustible. Para Pilot Flying J, solo se usan los **últimos 3 dígitos** del número de tarjeta de combustible. Cada perfil de conductor debe tener los últimos 3 dígitos correctos ingresados, con **PilotFlyingJ** seleccionado como proveedor, antes de cargar un archivo de transacciones.
* **Formato de archivo:** Alvys acepta la exportación estándar en Excel del portal Fuel Card. No se admiten archivos personalizados o reformateados.

## Comportamiento de sincronización

La integración Pilot Flying J importa datos de transacciones de combustible desde su cuenta Fuel Card de Pilot Flying J al Fuel Report de Alvys.

* **Dirección:** Unidireccional, de Pilot Flying J a Alvys, mediante carga manual de archivo Excel. No hay importación programada ni automática.

<Warning>
  ⚠️ Solo se usan los últimos 3 dígitos del número de tarjeta de combustible Pilot Flying J para asociar con conductores. · Ingresar más o menos dígitos impedirá que las transacciones se asocien. · Cargar el mismo archivo nuevamente puede crear entradas duplicadas.
</Warning>

## Verificar que funciona

Después de cargar, use el filtro de rango **Transaction Date** en Fuel Report para confirmar que las transacciones importadas aparecen y están asociadas con los conductores correctos.

## Solución de problemas

### Las transacciones de combustible no aparecen después de la carga

Confirme que el número de tarjeta de combustible de cada conductor en Alvys muestre los últimos 3 dígitos de su tarjeta Pilot Flying J y que **PilotFlyingJ** esté seleccionado como proveedor en el perfil del conductor. Alvys usa este número para asociar las transacciones del archivo cargado con el conductor correcto.

### La ventana emergente de carga no muestra PilotFlyingJ como opción

Confirme que la integración Pilot Flying J esté activa en Management > Integrations. Si la integración no aparece, vuelva a los pasos de conexión y reactívela para la subsidiaria correcta.

### El archivo Excel no se carga

Confirme que el archivo sea la exportación sin modificar del portal Pilot Flying J en formato Excel. Modificar la estructura del archivo antes de cargarlo puede provocar que falle la importación.

## Límites y no admitido

* La importación es manual y unidireccional (de Pilot Flying J a Alvys); no hay sincronización programada ni automática.
* Solo se admite la exportación estándar en Excel del portal Fuel Card. No se admiten archivos personalizados o reformateados.
* Solo se usan los últimos 3 dígitos del número de tarjeta de combustible para la asociación.

## Preguntas frecuentes

**P: ¿Cuántos dígitos del número de tarjeta de combustible debo ingresar en el perfil del conductor?**

**R:** Para la importación manual de Pilot Flying J, ingrese solo los últimos 3 dígitos del número de tarjeta de combustible en el perfil del conductor.

**P: ¿Con qué frecuencia debo cargar informes de transacciones de combustible?**

**R:** Depende de su calendario de informes y liquidación. Muchos equipos cargan semanalmente o después de cada período de facturación.

**P: ¿Qué pasa si las transacciones de un conductor no aparecen después de cargar el archivo?**

**R:** Confirme que el conductor tenga los últimos 3 dígitos correctos de su número de tarjeta de combustible Pilot Flying J ingresados en su perfil y que **PilotFlyingJ** esté seleccionado como proveedor. Si el número de tarjeta o el proveedor es incorrecto, las transacciones no se pueden asociar con ese conductor.

**P: ¿Puedo cargar el mismo archivo más de una vez?**

**R:** Cargar el mismo archivo nuevamente puede generar entradas duplicadas. Revise Fuel Report antes de volver a cargar para comprobar si las transacciones ya aparecen.
