Integración de Project44 (P44)

​

Resumen

La integración Project44 (P44) (también denominada visibilidad P44 o seguimiento push de transportistas) permite que Alvys envíe automáticamente información de ubicación de transportistas a P44 en intervalos de tiempo específicos. P44 es una plataforma de visibilidad logística que los embarcadores usan para monitorear carga en tránsito. Una vez conectada, Alvys activa actualizaciones automáticas de ubicación en cargas elegibles, enviando datos de posición al sistema de P44 para que los embarcadores puedan ver seguimiento en tiempo real de sus envíos. Esta integración es solo de salida: Alvys envía datos a P44. P44 no envía datos de vuelta a Alvys.

​

Requisitos previos

Antes de configurar la integración en Alvys, deben cumplirse las siguientes condiciones:

• P44 debe crear un usuario de integración dedicado para su transportista. No es un inicio de sesión estándar del portal P44. El usuario de integración está delimitado por región (por ejemplo, North America o Europe) y por el perfil de transportista P44. Los transportistas con varios SCAC pueden necesitar usuarios de integración separados si esos SCAC están vinculados a perfiles de transportista diferentes.
• El embarcador debe habilitar Carrier Push Tracking para su transportista dentro del portal P44. Si el embarcador no ha habilitado este ajuste, no fluirán datos de seguimiento independientemente de cómo esté configurada la integración en Alvys.

Para solicitar un usuario de integración dedicado, complete el formulario de autoservicio TMS o contacte directamente con P44. P44 pedirá una dirección de correo electrónico que administre y el nombre de al menos un cliente embarcador para el que desea activar la integración.

​

Cómo conectar

1. Agregue la integración en Alvys.
   • Vaya a Management > Integrations.
   • Seleccione el tipo de integración Visibility y elija Project 44.

1. Introduzca credenciales. Introduzca las credenciales del usuario de integración creado por P44 proporcionadas por P44. No use un inicio de sesión estándar del portal P44; usar un inicio de sesión regular del portal causará errores de autenticación 401.
2. Guarde y valide. Guarde la integración, luego continúe con la lista de verificación de validación en la sección Qué se sincroniza a continuación para confirmar que la conexión funciona correctamente.

​

Configurar permisos del portal P44

Después de que P44 cree el usuario de integración, inicie sesión con ese usuario de integración (o pida a P44 que lo administre) y vaya a User Management en el portal P44. Localice el cliente OAuth asociado con este usuario, que normalmente está etiquetado con Alvys. Agregue el permiso Carrier Push Tracking API a ese cliente OAuth. Este permiso es necesario para todas las llamadas API desde Alvys a P44. Si el embarcador aún no ha habilitado Carrier Push Tracking para su transportista en P44, pídale que lo haga antes de probar. Sin este ajuste del lado del embarcador, la integración se autenticará correctamente pero el embarcador no recibirá actualizaciones.

​

Qué se sincroniza

Alvys envía actualizaciones de ubicación de transportistas a P44 vinculadas al Shipment ID asociado con cada carga. P44 hace coincidir los datos de ubicación entrantes con el registro de envío correcto usando este identificador. La configuración de eventos y fuentes de eventos para cada cliente se puede personalizar dentro de Alvys. La personalización controla qué eventos de ubicación se envían y desde qué fuente de datos (por ejemplo, ELD o GPS). Una vez que se cumplen las condiciones para enviar la actualización de ubicación inicial de una carga, Alvys activa el indicador de actualización automática de ubicación para P44 en Load Details. A partir de ese momento, Alvys envía información de ubicación a intervalos regulares. Las actualizaciones se pueden pausar en dos niveles:

• Por carga: deshabilite el envío directamente desde Load Details.
• Por cliente: ajuste las preferencias P44 en el Customer Profile para detener actualizaciones para todas las cargas vinculadas a ese cliente.

​

Personalizar preferencias P44

La configuración de eventos P44 y las fuentes de eventos se pueden personalizar por cliente en el Customer Profile. Esto controla qué eventos de seguimiento se envían a P44 y desde qué fuente de ubicación.

​

Administrar actualizaciones automáticas de ubicación

Una vez que se cumplen las condiciones iniciales para una carga, Alvys activa el indicador de actualización automática de ubicación para P44 en Load Details. Puede deshabilitar actualizaciones para esa carga específica directamente desde Load Details. Para deshabilitar actualizaciones a nivel de cliente, repita el flujo de trabajo Personalizar preferencias P44 para el Customer Profile correspondiente. Use esta lista de verificación después de la configuración para confirmar que la integración funciona correctamente:

• La integración se autentica sin errores 401.
• El permiso Carrier Push Tracking API está habilitado en el cliente OAuth del usuario de integración en P44.
• El embarcador ha habilitado Carrier Push Tracking para su transportista en el portal P44.
• Las actualizaciones de ubicación de un envío de prueba aparecen en P44 bajo el Shipment ID correcto.

​

Solución de problemas

​

Errores de autenticación 401

Un error 401 significa que la integración no puede autenticarse con P44. Compruebe lo siguiente en orden:

1. Confirme que está usando las credenciales del usuario de integración P44 dedicado, no un inicio de sesión estándar del portal.
2. Confirme que el cliente OAuth del usuario de integración en P44 tiene habilitado el permiso Carrier Push Tracking API.
3. Confirme que el usuario de integración está delimitado a la región correcta (por ejemplo, North America frente a Europe).
4. Pida al embarcador que confirme que Carrier Push Tracking está habilitado para su transportista en su portal P44.

​

Las actualizaciones de ubicación no aparecen para el embarcador

Si la autenticación tiene éxito pero el embarcador no puede ver actualizaciones de ubicación en P44:

1. Confirme que el embarcador ha habilitado Carrier Push Tracking para su transportista en P44.
2. Confirme que el Shipment ID en Alvys coincide con lo que P44 espera para el envío.
3. Compruebe si las actualizaciones están deshabilitadas a nivel de carga o cliente en Alvys.

​

Conflicto de telemática ELD

Si el transportista también envía datos de telemática (por ejemplo, desde Samsara) usando un Shipment ID diferente, P44 prioriza la fuente ELD. Para resolverlo, alinee los Shipment IDs en ambas fuentes de datos o pause la transmisión de telemática según sea necesario.

​

Problemas de cuenta entre regiones

Si un transportista opera en una región (por ejemplo, EU) pero la cuenta P44 del embarcador está en otra región (por ejemplo, North America), P44 puede necesitar reflejar la cuenta del transportista entre regiones. Contacte directamente con el soporte de P44 para solicitarlo. Si ninguno de los pasos anteriores resuelve el problema, contacte con Alvys Support y proporcione el Shipment ID, el correo electrónico del usuario de integración y el error específico. Alvys Support coordinará con P44 según sea necesario.

​

Preguntas frecuentes

P: ¿Puedo usar mi inicio de sesión regular del portal P44 para esta integración? R: No. Debe usar un usuario de integración dedicado creado por P44 específicamente para acceso API. Usar un inicio de sesión estándar del portal causará errores 401. P: ¿Por qué recibo errores de autenticación 401 después de introducir mis credenciales? R: Confirme que usó las credenciales del usuario de integración dedicado (no un inicio de sesión P44 regular), que el permiso Carrier Push Tracking API está habilitado en el cliente OAuth del usuario en P44, y que el embarcador ha habilitado Carrier Push Tracking para su transportista en P44. P: ¿Qué pasa si mi transportista opera en varias regiones? R: Puede necesitar usuarios de integración separados delimitados a cada región, o P44 puede reflejar su cuenta entre regiones. Contacte con P44 para solicitar reflejo entre regiones. P: ¿Cómo detengo las actualizaciones de ubicación para una carga específica? R: Abra la carga en Load Details y deshabilite el indicador de actualización automática de ubicación P44. Para detener actualizaciones para todas las cargas bajo un cliente, ajuste las preferencias P44 en el Customer Profile.

​

Profundizar

• How to Set Up and Manage Integrations in Alvys