📋 Aplicable a: Administrador · Administrador de socios
Módulo: Gestión > EDI y visibilidad
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Proveedor: MacroPoint (Descartes) · Tipo de integración: Bidireccional · Dirección: Alvys envía solicitudes de seguimiento a MacroPoint; MacroPoint envía actualizaciones de ubicación y estado de vuelta a Alvys.
La integración con MacroPoint permite la visibilidad tanto de la carga entrante como de la saliente: el seguimiento de entrada obtiene la ubicación del transportista y las actualizaciones de estado en Alvys, y el seguimiento de salida comparte automáticamente los datos de ubicación y estado de la carga con los socios comerciales que utilizan MacroPoint.
Descripción general
La integración con MacroPoint proporciona visibilidad tanto de entrada como de salida para sus cargas. La visibilidad de entrada le brinda mayor control sobre la creación y el procesamiento de las solicitudes de seguimiento. La visibilidad de salida comparte automáticamente los datos de ubicación y estado con sus socios comerciales que utilizan MacroPoint para el seguimiento.
Sinónimos: Seguimiento MacroPoint, Descartes MacroPoint, visibilidad de entrada, visibilidad de salida, visibilidad bidireccional, seguimiento de transportistas.
MacroPoint se integra con Alvys para ofrecer visibilidad bidireccional de los envíos. La visibilidad de entrada (de MacroPoint a Alvys) obtiene las actualizaciones de ubicación del transportista en Alvys para que pueda supervisar las solicitudes de seguimiento directamente desde la carga. La visibilidad de salida (de Alvys a MacroPoint) envía los datos de ubicación y estado de su carga a los clientes que utilizan MacroPoint para el seguimiento de sus envíos.
Este artículo explica cómo configurar y utilizar ambas direcciones de la integración de MacroPoint.
Requisitos previos
Antes de configurar la integración entrante de MacroPoint, necesita tres credenciales de MacroPoint:
ID de MacroPoint: identificador de la cuenta de MacroPoint de su empresa
Contraseña de API: se utiliza para autenticar las solicitudes de seguimiento.
Contraseña FTP: se utiliza para enviar los datos del operador a MacroPoint a través de SFTP.
Solicite estas credenciales por correo electrónico a [email protected] o por teléfono al 1-888-544-3844, opción 2.
La integración entrante de MacroPoint requiere un plan de pago con MacroPoint. La integración saliente de MacroPoint solo requiere que el cliente que recibe las actualizaciones tenga un plan de pago con MacroPoint.
Cómo conectarse
Entrada: Configurar MacroPoint en Alvys
Una vez que tenga sus credenciales de MacroPoint, vaya a Administración y haga clic en la pestaña EDI y visibilidad.
Seleccione la filial que desea integrar con MacroPoint y haga clic en el menú desplegable Visibilidad. Elija MacroPoint Inbound. En la ventana de configuración, introduzca su ID de MacroPoint, contraseña de API y contraseña de FTP, y haga clic en Guardar.
Entrada: Configurar webhooks en MacroPoint
Para que MacroPoint pueda enviar datos de seguimiento a Alvys, configure las siguientes URL de webhook en la página de Preferencias de la empresa de MacroPoint. Reemplace XXXXX con su ID de inquilino de Alvys.
Actualizaciones de ubicación:
https://api.alvys.com/api/macropoint/locationUpdates/XXXXXEstado del pedido:
https://api.alvys.com/api/macropoint/orderStatus/XXXXXEventos del viaje:
https://api.alvys.com/api/macropoint/tripEvents/XXXXXEnvío de formularios:
https://api.alvys.com/api/macropoint/formSubmits/XXXXX
Agregue estas URL a la configuración correspondiente en su cuenta de MacroPoint en la página de Preferencias de la empresa de MacroPoint ( https://macropoint-lite.com/Secure/Company.aspx ).
Entrada: Configurar valores predeterminados de seguimiento
Tras introducir tus credenciales, puedes personalizar el comportamiento predeterminado de las solicitudes de seguimiento. Estos valores predeterminados se aplican a todas las nuevas solicitudes de seguimiento, por lo que no es necesario configurarlas manualmente una por una.
Salida: Configurar la salida de MacroPoint en Alvys
El servicio de visibilidad de salida envía datos de ubicación y estado a socios comerciales de múltiples proveedores. Este mismo servicio, que envía datos a MacroPoint, también es compatible con Project44 y FourKites. La configuración de salida de MacroPoint se realiza dentro de este servicio de visibilidad compartida.
Vaya a Administración > Integraciones > Visibilidad > Salida . Ingrese su ID y contraseña de MacroPoint. Seleccione las subsidiarias relevantes para la visibilidad de salida y configure los ajustes de uso compartido de salida, como las ubicaciones, los estados y la frecuencia de actualización que se compartirán.
Una vez configuradas, las actualizaciones automáticas se pueden configurar directamente en el perfil del cliente, de forma similar al proceso descrito en la sección "Configuración de actualización automática de EDI".
¿Qué sincroniza?
Datos entrantes recibidos de MacroPoint
MacroPoint envía los siguientes datos a Alvys a través de las URL de webhook configuradas:
Actualizaciones de ubicación: latitud y longitud GPS, marca de tiempo, fuente de datos e información del localizador para la posición actual del transportista.
Estado del pedido: códigos de estado y mensajes de la solicitud de seguimiento
Eventos del viaje: llegadas y salidas de paradas con marca de tiempo, ubicación y tipo de evento.
Envíos de formularios: envíos de formularios del conductor asociados con la solicitud de seguimiento.
Datos salientes enviados a MacroPoint
Alvys envía los siguientes datos a MacroPoint para que el cliente pueda verlos:
Datos de ubicación: coordenadas GPS obtenidas de ELD, llamadas de verificación y actualizaciones de seguimiento entrantes.
Estados de carga: los cuatro estados de salida configurables son Despachado o Cubierto (antes de la recogida), Despachado después de la primera recogida (cuando se llega a la primera parada), En tránsito y Entregado .
Cada estado se puede activar o desactivar en la configuración de salida. Solo los estados que estén activados se compartirán con la cuenta MacroPoint del cliente.
Sincronización entrante
MacroPoint consulta los dispositivos GPS del transportista a intervalos configurados y envía actualizaciones de ubicación a Alvys. Alvys procesa cada actualización y registra la posición actual del transportista, la hora estimada de llegada y los eventos de llegada o salida de paradas, asociándolos con la solicitud de seguimiento activa de la carga.
La integración entrante actualiza el estado de la solicitud de seguimiento cuando el transportista llega o sale de un punto de recogida o entrega. Estas actualizaciones son visibles en el panel de seguimiento de la carga.
Sincronización de salida
Alvys envía datos de ubicación y estado a MacroPoint de forma programada. El servicio de salida lee la posición actual de la carga desde el ELD, las llamadas de verificación o los datos de seguimiento entrantes y los transmite a MacroPoint. Los eventos de estado (como cuando una carga pasa a estado "En tránsito ") se envían en el momento en que ocurren.
Verificar que la entrada de datos funcione correctamente.
Después de configurar MacroPoint para la entrada e iniciar una solicitud de seguimiento en una carga:
Abra la carga y haga clic en la opción Seguimiento en la cinta de acciones.
En el panel de solicitud de seguimiento, ajuste el número de teléfono, la duración del seguimiento, el intervalo y otros detalles de la solicitud según sea necesario.
Haz clic en "Seguimiento" para enviar la solicitud de seguimiento a MacroPoint y comenzar la monitorización.
📋 MARCADOR DE POSICIÓN DE IMAGEN [Imagen 3 — Opción de seguimiento de la cinta de acciones, cargar macropoint-img3-action-ribbon-tracking.png]
📋 MARCADOR DE POSICIÓN DE IMAGEN [Imagen 4 — Formulario de solicitud de seguimiento, cargar macropoint-img4-track-request-form.png]
Una vez activada la solicitud de seguimiento, MacroPoint comienza a enviar actualizaciones de ubicación a Alvys. Puede gestionar la solicitud activa desde la cinta de opciones de acciones: allí encontrará opciones para pausar, reanudar o detener el seguimiento.
📋 MARCADOR DE POSICIÓN DE IMAGEN [Imagen 5 — Opciones de gestión de seguimiento, cargar macropoint-img5-tracking-management.png]
Verificar que la comunicación saliente funcione.
Tras configurar el envío de cargas desde MacroPoint, abra una carga que coincida con uno de los estados de envío habilitados (por ejemplo, una carga en estado " En tránsito" ). Verifique la cuenta de MacroPoint del cliente para confirmar que la ubicación y el estado de la carga aparecen correctamente.
Solución de problemas
No se pudo enviar la solicitud de seguimiento.
Causa: El ID de MacroPoint o la contraseña de la API introducidos en Alvys no coinciden con las credenciales proporcionadas por MacroPoint.
Verifique que el ID de MacroPoint y la contraseña de la API introducidos en Alvys coincidan con las credenciales proporcionadas por MacroPoint.
Si las credenciales se modificaron recientemente en MacroPoint, actualícelas en Alvys, en Gestión > EDI y visibilidad, en la configuración de visibilidad de la filial correspondiente.
No se encontró el operador en MacroPoint.
Causa: MacroPoint requiere que los datos del transportista estén registrados en su sistema antes de poder aceptar una solicitud de seguimiento. Al iniciar una solicitud de seguimiento, Alvys envía automáticamente los datos del transportista a MacroPoint utilizando la contraseña FTP configurada en la configuración de entrada.
Si falla el registro del operador, verifique que la contraseña FTP se haya introducido correctamente en la pantalla de configuración de entrada de MacroPoint.
No aparecen actualizaciones de ubicación en la carga
Causa: No se cumple alguna de las condiciones necesarias para la entrega de datos entrantes.
Confirme que el estado de la solicitud de seguimiento sea Activo, y no Pendiente ni con Error, en el panel de seguimiento de la carga.
Confirme que las URL de webhook se hayan introducido correctamente en la página de Preferencias de la empresa de MacroPoint, sustituyendo XXXXX por su ID de inquilino de Alvys.
Verifique que MacroPoint se conecte correctamente al punto final del webhook configurado. Si MacroPoint no puede conectarse con Alvys, no se recibirán actualizaciones de ubicación, independientemente del estado de la solicitud de seguimiento.
Si ninguna de estas condiciones se aplica a su caso, póngase en contacto con el servicio de asistencia de Alvys.
Error de validación de la solicitud de seguimiento 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 seguimiento. Una parada puede tener una dirección postal completa, pero aun así fallar si la dirección nunca se geocodificó.
Verifique que cada dirección de parada haya sido geocodificada (se le hayan asignado coordenadas) en el registro de la empresa.
Si faltan las coordenadas, edite la dirección de la empresa de la parada para activar la geocodificación y, a continuación, vuelva a intentar la solicitud de seguimiento.
El estado de salida no llega a la cuenta MacroPoint del cliente.
Causa: El estado de carga correspondiente no está habilitado en la configuración de salida, o bien no se ha seleccionado la subsidiaria de la carga.
Verifique que el estado de carga correspondiente ( Despachado o Cubierto , Despachado después de la primera recogida , En tránsito o Entregado ) esté habilitado en la configuración de visibilidad de salida en Administración > Integraciones > Visibilidad > Salida .
Confirme que la filial asignada a la carga coincide con una filial seleccionada en la configuración de salida.
Si ninguna de estas condiciones se aplica a su caso, póngase en contacto con el servicio de asistencia de Alvys.
Límites y sin soporte
Las paradas intermedias no son compatibles con las solicitudes de seguimiento de MacroPoint. Solo se incluyen las paradas de recogida y entrega en la hoja de ruta que se envía a MacroPoint.
La visibilidad de salida envía datos para MacroPoint, Project44 y FourKites a través del mismo servicio compartido. Cada proveedor se configura por separado en Administración > Integraciones > Visibilidad > Salida .
Si la dirección de una parada no ha sido geocodificada (no se le han asignado coordenadas GPS), MacroPoint rechazará la solicitud de seguimiento con un error de validación.
Preguntas frecuentes
P: ¿Cuál es la diferencia entre la visibilidad de entrada y la de salida?
A: La función de entrada le permite solicitar y gestionar el seguimiento de transportistas desde MacroPoint y recibir actualizaciones de ubicación en Alvys. La función de salida comparte automáticamente la ubicación y el estado de su carga con los clientes que utilizan MacroPoint para el seguimiento de sus mercancías.
P: ¿Necesito un plan de pago de MacroPoint tanto para llamadas entrantes como salientes?
A: Para las comunicaciones entrantes, su empresa debe tener un plan MacroPoint de pago. Para las comunicaciones salientes, solo el cliente que recibe las actualizaciones debe tener un plan MacroPoint de pago.
P: ¿Puedo pausar el seguimiento para cargas individuales?
R: Sí. Una vez que una solicitud de seguimiento está activa, puede pausarla, reanudarla o detenerla desde la cinta de acciones en la carga.
P: ¿Qué estados comparte MacroPoint con sus clientes en sus llamadas salientes?
A: MacroPoint permite compartir cuatro estados de carga: Despachado o Cubierto , Despachado después de la primera recogida , En tránsito y Entregado . Cada estado se puede habilitar o deshabilitar individualmente en la configuración de visibilidad de salida.
P: ¿Por qué se requiere la contraseña FTP para la configuración de entrada?
A: Alvys utiliza la contraseña FTP para enviar los datos del transportista a MacroPoint mediante SFTP cuando se inicia una solicitud de seguimiento. Sin esta credencial, MacroPoint no puede registrar al transportista en su sistema y las solicitudes de seguimiento fallarán.