Se aplica a: Admin · Partner AdminMódulo: Management > EDI y VisibilityProveedor: MacroPoint (Descartes) · Tipo de integración: Bidireccional · Dirección: Alvys envía solicitudes de tracking a MacroPoint; MacroPoint envía actualizaciones de ubicación y estado a AlvysLa integración MacroPoint permite la carga visibility de inbound y outbound: inbound tracking extrae transportista actualizaciones de ubicación y estado en Alvys, y outbound tracking comparte automáticamente la ubicación de carga y los datos de estado con los socios comerciales que utilizan MacroPoint.
Resumen
MacroPoint la integración proporciona inbound y outbound visibility para sus cargas. Inbound visibility le brinda más control sobre la tracking creación y procesamiento de solicitudes. Outbound visibility comparte automáticamente datos de ubicación y estado con sus socios comerciales que usan MacroPoint para tracking. Sinónimos: MacroPoint tracking, Descartes MacroPoint, inbound visibility, outbound visibility, bidireccional visibility, transportista tracking. MacroPoint integrates con Alvys para proporcionar envío bidireccional visibility. Inbound visibility (MacroPoint a Alvys) extrae transportista location updates en Alvys para que pueda monitorear track las solicitudes directamente desde la carga. Outbound visibility (Alvys a MacroPoint) envía la ubicación de su carga y los datos de estado a customers, quienes usan MacroPoint a track su carga. Este artículo cubre cómo configurar y utilizar ambas direcciones de la integración MacroPoint.Requisitos previos
Antes de configurar la integración MacroPoint inbound, necesita tres credenciales de MacroPoint:- MacroPoint ID: el identificador de cuenta MacroPoint de su empresa
- API contraseña: se utiliza para autenticar track solicitudes
- FTP contraseña: usado para enviar transportista details a MacroPoint a través de SFTP
Cómo conectar
Entrante: Configurar MacroPoint en Alvys
Una vez que tenga sus credenciales MacroPoint, navegue hasta Management y haga clic en las pestañas EDI y Visibility.
Entrante: Configurar webhooks en MacroPoint
Para permitir que MacroPoint envíe datos de tracking a Alvys, configure las siguientes URL de webhook en su página MacroPoint Company Preferences. **Reemplace **XXXXX **** con su Alvys Tenant ID.- Location Updates:
https://api.alvys.com/api/macropoint/locationUpdates/XXXXX - Order Status:
https://api.alvys.com/api/macropoint/orderStatus/XXXXX - viaje Events:
https://api.alvys.com/api/macropoint/tripEvents/XXXXX - Form Submits:
https://api.alvys.com/api/macropoint/formSubmits/XXXXX
Entrante: Configurar Tracklos valores predeterminados
Después de ingresar sus credenciales, puede personalizar el comportamiento predeterminado de tracking solicitudes. Estos valores predeterminados se aplican a cada nueva solicitud tracking, por lo que no es necesario configurar manualmente cada una.
- Imagen que muestra la forma Macropoint Inbound con Inbound visibility configuración*
Saliente: Configurar MacroPoint Saliente en Alvys
El servicio outbound visibility envía datos de ubicación y estado a socios comerciales de múltiples proveedores. El mismo servicio que envía datos a MacroPoint también a supports Project44 y FourKites. MacroPoint outbound la configuración se realiza dentro de este servicio visibility compartido. Navegue a Management > Integrations > Visibility > Outbound. Ingrese su MacroPoint ID y contraseña. Seleccione el subsidiaries relevante para outbound visibility y configure outbound compartir configuración, como qué locations, estados y frecuencia de actualización para compartir.
Qué se sincroniza
Datos entrantes recibidos de MacroPoint
MacroPoint envía los siguientes datos a Alvys a través de las URL de webhook configuradas:- Location updates: GPS latitud y longitud, marca de tiempo, fuente de datos e información de localización para la posición actual de transportista
- Order status: tracking solicitar códigos de estado y mensajes
- viaje events: parada de llegadas y salidas con marca de tiempo, ubicación y tipo de evento
- Form submits: envíos de formularios de conductor asociados con la solicitud tracking
Datos salientes enviados a MacroPoint
Alvys envía los siguientes datos outbound a MacroPoint para el cliente visibility:- Datos de ubicación: GPS coordenadas obtenidas de ELD, check calls y inbound tracking actualizaciones
- Estados de carga: los cuatro estados outbound configurables son Despachado o Cubierto (antes de la recogida), despachado After 1st Pickup (cuando llega a la primera parada), In Transit y Delivered
Sincronización entrante
MacroPoint sondea transportista GPS dispositivos en un intervalo configurado y envía location updates a Alvys. Alvys procesa cada actualización y registra la posición actual del transportista, la hora estimada de llegada y los eventos de parada de llegada o salida frente a la solicitud de active tracking en la carga. La integración inbound actualiza el estado de la solicitud tracking cuando el transportista llega o sale de una parada de recogida o entrega. Estas actualizaciones son visibles en el panel tracking de la carga.Sincronización saliente
Alvys envía datos de ubicación y estado a MacroPoint de forma programada. El servicio outbound lee la posición de carga actual de ELD, check calls o inbound tracking datos y los transmite a MacroPoint. Los eventos de estado (como cuando una carga se mueve a In Transit) se envían a medida que ocurren.Verifique que el entrante esté funcionando
Después de configurar MacroPoint inbound e iniciar una solicitud track en una carga:-
Abra la carga y haga clic en la opción Tracking en Action Ribbon.
- En el panel de solicitud tracking, ajuste el número de teléfono, la duración track, el intervalo y otros detalles de solicitud según sea necesario.
- Haga clic en Track para enviar la solicitud tracking a MacroPoint y comenzar a monitorear.
Verifique que la salida esté funcionando
Después de configurar MacroPoint outbound, abra una carga que coincida con uno de sus estados outbound habilitados (por ejemplo, una carga en estado In Transit). Verifique la cuenta MacroPoint del cliente para confirmar que la ubicación y el estado de la carga aparecen como se esperaba.Solución de problemas
Seguimiento de la solicitud no se envía
Causa: El MacroPoint ID o API contraseña ingresado en Alvys no coincide con las credenciales proporcionadas por MacroPoint.- Verifique que el MacroPoint ID y el API contraseña ingresados en Alvys coincidan con las credenciales proporcionadas por MacroPoint.
- Si las credenciales se cambiaron recientemente en MacroPoint, actualícelas en Alvys en Management > EDI y Visibility en la configuración Visibility de la subsidiaria correspondiente.
transportista no encontrado en MacroPoint
Causa: MacroPoint requiere que transportista details estén registrados en su sistema antes de que se pueda aceptar una solicitud de tracking. Cuando inicia una solicitud de tracking, Alvys envía automáticamente transportista details a MacroPoint usando el FTP contraseña configurado en la configuración inbound.- Si el registro transportista falla, verifique que el FTP contraseña esté ingresado correctamente en la pantalla de configuración MacroPoint Inbound.
No aparece actualizaciones de ubicación en la carga
Causa: No se cumple una de las condiciones requeridas para la entrega de datos inbound.- Confirme que el estado de la solicitud tracking sea Active, no Pending o Error, en el panel tracking de la carga.
- Confirme que las URL del webhook estén ingresadas correctamente en su página MacroPoint Company Preferences con su Alvys Tenant ID reemplazando a XXXXX.
- Compruebe que MacroPoint llegue correctamente al punto final del webhook configurado. Si MacroPoint no puede llegar a Alvys, location updates no se recibirá independientemente del estado de la solicitud track.
- Si no se aplica ninguna de estas condiciones, comuníquese con Alvys support.
Seguimiento del error de validación de solicitud en la parada de recogida o entrega
Causa: MacroPoint requiere coordenadas GPS (latitud y longitud) en todas las paradas de recogida y entrega al crear una solicitud de tracking. Una parada puede tener una dirección postal completa pero aun así fallar si la dirección nunca fue geocodificada.- Verificar que cada dirección de parada haya sido geocodificada (coordenadas asignadas) en el registro de la empresa.
- Si faltan coordenadas, edit la dirección de la empresa de la parada para activar la codificación geográfica y luego vuelva a intentar la solicitud tracking.
Saliente el estado no llega a la cuenta MacroPoint del cliente
Causa: El estado de carga relevante no está habilitado en la configuración outbound o la carga subsidiaria no está seleccionada.- Verifique que el estado de carga relevante (Enviado o Cubierto, despachado After 1st Pickup, In Transit o Delivered) esté habilitado en la configuración outbound visibility en Management > Integrations > Visibility > Outbound.
- Confirme que la filial asignada a la carga coincida con una filial seleccionada en la configuración outbound.
- Si no se aplica ninguna de estas condiciones, comuníquese con Alvys support.
Límites y no compatible
- Las paradas de waypoints no se incluyen en las solicitudes MacroPoint tracking. Solo las paradas de recogida y entrega están incluidas en la hoja de viaje enviada a MacroPoint.
- Outbound visibility envía datos para MacroPoint, Project44 y FourKites a través del mismo servicio compartido. Cada proveedor se configura por separado dentro de Management > Integrations > Visibility > Outbound.
- Si la dirección de una parada no ha sido geocodificada (no se han asignado coordenadas GPS), MacroPoint rechazará la solicitud tracking con una validación error.