📋 Aplicable a: Administradores · Administradores asociados
Módulo: Gestión > Integraciones
Última revisión: junio de 2026 · Propietario: Soporte
Proveedor: Project44 (P44) · Tipo de integración: Unidireccional · Dirección: Alvys envía datos de ubicación del operador a P44
La integración con Project44 (P44) envía automáticamente datos de ubicación del transportista desde Alvys a P44 a intervalos configurados para que los remitentes puedan monitorear la carga en tiempo real; esta es una integración solo para envíos salientes.
Descripción general
La integración con Project44 (P44), también conocida como visibilidad P44 o seguimiento por parte del transportista, permite a Alvys enviar automáticamente información sobre la ubicación del transportista a P44 a intervalos de tiempo específicos. P44 es una plataforma de visibilidad logística que los remitentes utilizan para monitorear la carga en tránsito. Una vez conectado, Alvys activa las actualizaciones automáticas de ubicación para las cargas que cumplen con los requisitos, enviando datos de posición al sistema de P44 para que los remitentes puedan ver el 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 específico para su operador. Este no es un inicio de sesión estándar del portal P44. El usuario de integración se define por región (por ejemplo, Norteamérica o Europa) y por el perfil de operador de P44. Los operadores con varios SCAC podrían necesitar usuarios de integración independientes si estos SCAC están asociados a diferentes perfiles de operador.
El remitente debe habilitar el seguimiento mediante notificaciones push del transportista en el portal P44. Si el remitente no ha habilitado esta opción, no se transmitirá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 de TMS o póngase en contacto directamente con P44. P44 le pedirá una dirección de correo electrónico que usted administre y el nombre de al menos un cliente transportista para el que desee activar la integración.
Cómo conectarse
Añade la integración en Alvys.
Navegue a Administración > Integraciones.
Seleccione el tipo de integración Visibilidad y elija el Proyecto 44.
Introduzca las credenciales. Introduzca las credenciales del usuario de integración creado por P44. No utilice el inicio de sesión estándar del portal de P44; el uso de un inicio de sesión normal provocará errores de autenticación 401.
Guarda y valida. Guarda la integración y, a continuación, consulta la lista de verificación de validación en la sección "¿Qué se sincroniza?" que aparece más abajo para confirmar que la conexión funciona correctamente.
Configurar permisos del portal P44
Una vez que P44 haya creado el usuario de integración, inicie sesión con dicho usuario (o permita que P44 lo gestione) y acceda a Gestión de usuarios en el portal de P44. Localice el cliente OAuth asociado a este usuario, que normalmente se identifica como Alvys.
Agregue el permiso Carrier Push Tracking API a ese cliente OAuth. Este permiso es necesario para todas las llamadas a la API desde Alvys a P44.
Si el remitente aún no ha habilitado el seguimiento push del transportista en P44, pídale que lo haga antes de realizar la prueba. Sin esta configuración por parte del remitente, la integración se autenticará correctamente, pero el remitente no recibirá ninguna actualización.
¿Qué sincroniza?
Alvys envía actualizaciones de ubicación del transportista a P44 vinculadas al ID de envío asociado a cada carga. P44 compara los datos de ubicación recibidos con el registro de envío correcto utilizando este identificador.
En Alvys, se pueden personalizar la configuración y el origen de los eventos para cada cliente. La personalización permite controlar 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 Detalles de carga. 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: deshabilitar el envío directo desde Detalles de carga.
Por cliente: ajuste las preferencias P44 en el perfil del cliente para detener las actualizaciones de todas las cargas vinculadas a ese cliente.
Personalizar las preferencias de P44
La configuración y las fuentes de eventos de P44 se pueden personalizar para cada cliente en el Perfil del Cliente. Esto controla qué eventos de seguimiento se envían a P44 y desde qué ubicación.
Sección de preferencias P44 en el perfil del cliente que muestra la configuración de eventos y los controles de origen.
Gestionar las 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 Detalles de la carga. Puede desactivar las actualizaciones para esa carga específica directamente desde Detalles de la carga.
Pantalla de detalles de carga que muestra el indicador de actualización automática de ubicación P44 y el control para desactivarlo.
Para desactivar las actualizaciones a nivel de cliente, repita el flujo de trabajo de personalización de preferencias de P44 para el perfil de cliente correspondiente.
Utilice 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 de la API de seguimiento push del operador está habilitado en el cliente OAuth del usuario de integración en P44.
El remitente ha habilitado el seguimiento push del transportista para su transportista en el portal P44.
Las actualizaciones de ubicación de un envío de prueba aparecen en P44 bajo el ID de envío correcto.
📋 Limitaciones y funciones no compatibles: Esta integración no admite la visibilidad de datos entrantes: P44 no puede enviar datos a Alvys. · La integración de Co-Pilot con P44 no es compatible actualmente. · Los operadores con múltiples SCAC vinculados a perfiles de operador de P44 separados pueden requerir usuarios de integración separados para cada perfil.
Solución de problemas
Errores de autenticación 401
Un error 401 significa que la integración no puede autenticarse con P44. Verifique lo siguiente en orden:
Confirme que está utilizando las credenciales de usuario de integración de P44, y no las credenciales de inicio de sesión estándar del portal.
Confirme que el cliente OAuth del usuario de integración en P44 tenga habilitado el permiso de la API de seguimiento push del operador.
Confirme que el usuario de integración esté configurado para la región correcta (por ejemplo, Norteamérica frente a Europa).
Solicite al remitente que confirme que la función de seguimiento por parte del transportista está habilitada para su transportista en su portal P44.
Las actualizaciones de ubicación no aparecen para el remitente.
Si la autenticación es exitosa pero el remitente no puede ver las actualizaciones de ubicación en P44:
Confirme que el remitente ha habilitado el seguimiento push del transportista para su transportista en P44.
Confirme que el ID de envío en Alvys coincide con lo que P44 espera para el envío.
Compruebe si las actualizaciones están deshabilitadas a nivel de carga o de cliente en Alvys.
conflicto de telemática ELD
Si el transportista también envía datos telemáticos (por ejemplo, desde Samsara) con un ID de envío diferente, P44 prioriza la fuente ELD. Para solucionar esto, sincronice los ID de envío en ambas fuentes de datos o pause la transmisión telemática según sea necesario.
Problemas de cuentas interregionales
Si una empresa de transporte opera en una región (por ejemplo, la UE), pero la cuenta P44 del remitente se encuentra en otra región (por ejemplo, Norteamérica), es posible que P44 deba sincronizar la cuenta de la empresa de transporte entre regiones. Para solicitar esta sincronización, póngase en contacto directamente con el soporte técnico de P44.
Si ninguno de los pasos anteriores resuelve el problema, comuníquese con el soporte técnico de Alvys e indique el ID del envío, el correo electrónico del usuario de la integración y el error específico. El soporte técnico de Alvys se coordinará con P44 según sea necesario.
Preguntas frecuentes
P: ¿Puedo usar mi inicio de sesión habitual del portal P44 para esta integración?
R: No. Debe usar un usuario de integración dedicado creado por P44 específicamente para el acceso a la API. Usar un inicio de sesión estándar del portal provocará errores 401.
P: ¿Por qué recibo errores de autenticación 401 después de ingresar mis credenciales?
A: Confirme que utilizó las credenciales de usuario de integración dedicadas (no un inicio de sesión P44 normal), que el permiso de la API Carrier Push Tracking está habilitado en el cliente OAuth del usuario en P44 y que el remitente ha habilitado Carrier Push Tracking para su transportista en P44.
P: ¿Qué ocurre si mi operador opera en varias regiones?
R: Es posible que necesite usuarios de integración independientes para cada región, o bien, P44 puede replicar su cuenta en todas las regiones. Póngase en contacto con P44 para solicitar la replicación entre regiones.
P: ¿Cómo puedo detener las actualizaciones de ubicación para una carga específica?
A: Abra la carga en Detalles de carga y desactive el indicador de actualización automática de ubicación P44. Para detener las actualizaciones de todas las cargas de un cliente, ajuste las preferencias P44 en el Perfil del cliente.



