Integración entrante de FourKites

​

¿Qué hace esta integración?

La integración entrante de FourKites (también llamada FourKites inbound, seguimiento 4Kites, tarjetas de seguimiento de transportistas o visibilidad entrante) permite a los equipos de corretaje enviar datos de carga y transportista desde Alvys a FourKites para crear y actualizar tarjetas de seguimiento. Una vez conectada, puede iniciar una solicitud de seguimiento en cualquier carga que tenga un transportista asignado, revisar detalles de carga prellenados en un formulario de seguimiento y monitorear el estado de cada solicitud de seguimiento directamente en la página de detalles de la carga. Esta es una integración unidireccional: los datos fluyen de Alvys a FourKites. Alvys envía tarjetas de carga, detalles de paradas, información del transportista y números de referencia a FourKites. Las actualizaciones de ubicación de FourKites no se devuelven a Alvys. La integración se configura por subsidiaria y requiere una clave de API de FourKites.

​

Requisitos previos

Antes de conectar, asegúrese de tener:

• Una cuenta activa de FourKites con acceso a API.
• Una clave de API de FourKites (obténgala desde la configuración de su cuenta de FourKites o de su gerente de cuenta de FourKites).
• Rol Admin, Partner Admin o Support en Alvys.
• Al menos una subsidiaria configurada en Alvys que desee habilitar para esta integración.

​

Conectar / Autenticar

Esta configuración se completa una vez por subsidiaria. Puede habilitar múltiples subsidiarias usando la misma clave de API si su cuenta de FourKites las cubre todas.

1. Abra la configuración de EDI & Visibility. Seleccione su perfil de usuario en la esquina inferior izquierda de Alvys, luego seleccione EDI & Visibility.
2. Localice FourKites Inbound en la lista de integraciones disponibles y selecciónelo para abrir el formulario de configuración.
3. Ingrese su clave de API. En el formulario de configuración, ingrese la FourKites API Key que obtuvo de FourKites.
4. Seleccione subsidiarias. Elija qué subsidiarias desea habilitar para esta integración. Cada subsidiaria seleccionada usará la clave de API que ingresó.
5. Guarde y verifique. Seleccione Save. Alvys validará sus credenciales contra FourKites. Si la clave es válida, el estado de la integración se actualiza para confirmar que la conexión está activa. Si la validación falla, verifique la clave de API e intente de nuevo.

​

Mapeo de campos y datos

Los siguientes datos se envían desde Alvys a FourKites cuando se crea o actualiza una solicitud de seguimiento: Alvys envía el número de carga como identificador principal en la tarjeta de FourKites. El número de pedido y el número de PO se envían como números de referencia adjuntos al envío. El nombre del cliente de la carga y el ID del cliente se envían como etiquetas en la tarjeta de FourKites, vinculando el cliente de la carga de Alvys con el cliente correspondiente en FourKites. Para cada parada de recogida y entrega, Alvys envía la dirección de la parada (línea de dirección 1, línea de dirección 2, ciudad, estado, país), la ventana de cita programada (horas de cita más temprana y más tardía en la zona horaria local de la parada), el tipo de parada (recogida o entrega) y el nombre de la parada. Las paradas waypoint no son compatibles con FourKites y no se envían. Los detalles de seguimiento del transportista se envían solo cuando se proporcionan: número de camión, número de remolque y número de teléfono del conductor. El campo de nombre del transportista en FourKites es opcional; Alvys no lo completa automáticamente porque FourKites no tiene un identificador dedicado de nombre de transportista que se mapee de forma confiable a los registros de transportistas de Alvys.

​

Comportamiento de sincronización

Alvys envía datos a FourKites en los siguientes escenarios:

• Cuando selecciona el botón FourKites Tracking en una carga y envía el formulario de seguimiento, Alvys crea un nuevo envío en FourKites. Si una solicitud de seguimiento anterior para el mismo viaje se detuvo antes, Alvys reutiliza el registro existente y lo actualiza en lugar de crear un duplicado.
• Cuando los detalles de la carga cambian después de que una solicitud de seguimiento está activa, puede volver a abrir el formulario de seguimiento y actualizar la tarjeta. Alvys envía la información actualizada a FourKites.
• Cuando detiene una solicitud de seguimiento en la página de detalles de la carga, Alvys elimina el envío correspondiente de FourKites y registra el estado como detenido.

​

Verificar que funciona

Después de iniciar una solicitud de seguimiento en una carga:

1. En la página de detalles de la carga, confirme que el indicador de estado de seguimiento muestra Ready to Track. Si muestra Error, consulte la sección Solución de problemas a continuación.
2. Seleccione el enlace que aparece en la página de detalles de la carga para abrir la tarjeta de FourKites directamente. Confirme que el número de carga, las direcciones de parada y los números de referencia son correctos en FourKites.
3. En FourKites, verifique que las paradas correctas aparecen como recogida y entrega con las ventanas de cita programadas.

​

Solución de problemas

​

El estado de seguimiento muestra Error después de crear una solicitud

1. Abra la carga en Alvys y verifique que todas las paradas de recogida y entrega tengan una dirección completa (se requieren línea de dirección 1, ciudad, estado y país). Las paradas waypoint no se envían a FourKites.
2. Verifique que la clave de API de FourKites en la configuración de EDI & Visibility sigue siendo válida. Las claves de API pueden rotarse o cambiarse en su cuenta de FourKites. Vuelva a ingresar la clave y guarde si ha cambiado.
3. Si las paradas tienen direcciones y la clave de API es válida, contacte al soporte de Alvys con el número de carga y el mensaje de error mostrado en la página de detalles de la carga.

​

La tarjeta de FourKites no muestra el cliente correcto

• FourKites no tiene un campo dedicado de cliente. Alvys pasa el nombre del cliente de la carga y el ID como etiquetas en el envío de FourKites. Si la tarjeta no se asocia con el cliente correcto de FourKites, conecte el ID de cliente de Alvys con el cliente de FourKites directamente en la configuración de su cuenta de FourKites.

​

El botón Tracking no es visible en la carga

• La integración FourKites Inbound debe estar activa para la subsidiaria asociada con la carga. Confirme que la subsidiaria está habilitada en la configuración de EDI & Visibility. Si la subsidiaria está habilitada y el botón aún no es visible, contacte al soporte de Alvys.

​

La integración no aparece en la configuración de EDI & Visibility

• La página EDI & Visibility es accesible solo para roles Admin, Partner Admin y Support. Si no ve esta opción de menú, su rol no incluye acceso. Contacte al Admin de su empresa para configurar la integración.

​

Límites / no compatibles

• Las actualizaciones de ubicación de FourKites no se devuelven a Alvys. La integración es unidireccional (solo de Alvys a FourKites).
• Las paradas waypoint no son compatibles. Solo se envían a FourKites los tipos de parada de recogida y entrega.
• El campo de nombre del transportista en FourKites no se completa automáticamente por Alvys. Puede ingresarlo manualmente en el formulario de seguimiento.
• La integración se configura por subsidiaria. Una subsidiaria que no esté habilitada no mostrará el botón FourKites Tracking en las cargas.
• Si una carga no usa números de pedido o PO, esos campos de referencia estarán vacíos en la tarjeta de FourKites. La tarjeta aún se creará usando el número de carga.

​

Preguntas frecuentes

P: ¿Necesito ingresar el nombre del transportista al iniciar una solicitud de seguimiento? R: No. El campo de nombre del transportista es opcional. FourKites acepta la solicitud sin él y la tarjeta de carga se crea correctamente. Puede agregar el nombre del transportista manualmente en el formulario de seguimiento si es necesario. P: ¿Alvys recibe actualizaciones de ubicación en vivo de FourKites? R: No. Esta integración envía datos solo de Alvys a FourKites. Las coordenadas de ubicación en vivo y las actualizaciones de estado de entrega en FourKites son visibles en FourKites directamente; no se devuelven a la página de detalles de la carga de Alvys. P: ¿Por qué necesito configurar la integración por separado para cada subsidiaria? R: La integración se configura a nivel de subsidiaria para que la configuración de seguimiento esté segmentada correctamente para cada unidad de negocio. Esto le da control sobre qué subsidiarias envían datos de carga a FourKites y cuáles no. P: ¿Puedo usar la misma clave de API de FourKites para múltiples subsidiarias? R: Sí. Puede ingresar la misma clave de API y habilitar múltiples subsidiarias en una sola operación de guardado de configuración. P: ¿Qué sucede si detengo una solicitud de seguimiento en Alvys? R: Alvys envía una solicitud de eliminación a FourKites, que elimina el envío de FourKites. El estado de seguimiento en Alvys se actualiza para reflejar que el seguimiento se detuvo. P: Mi flujo de trabajo no usa números de pedido ni PO. ¿La integración con FourKites seguirá funcionando? R: Sí. Si una carga no usa números de pedido ni PO, esos campos de referencia estarán vacíos en la tarjeta de FourKites. La tarjeta aún se crea y actualiza usando el número de carga.

​

Profundice

• Integración saliente de FourKites