Se aplica a: Administración · Administración de socios · Soporte
Módulo: Gestión > EDI y visibilidad
Última revisión: junio de 2026 · Propietario: Soporte
Proveedor: FourKites · Tipo de integración: Unidireccional · Dirección: Alvys envía datos de carga y transportista a FourKites; FourKites no envía datos de vuelta a Alvys.
Conecte Alvys con FourKites (también llamado 4Kites) para iniciar y gestionar el seguimiento de transportistas entrantes desde su plataforma de carga, creando y actualizando tarjetas de seguimiento automáticamente sin necesidad de introducir datos manualmente.
¿Qué hace esta integración?
La integración de FourKites (también conocida como FourKites inbound, seguimiento de 4Kites, tarjetas de seguimiento de transportistas o visibilidad de inbound) permite a los equipos de intermediación transferir datos de carga y transportistas desde Alvys a FourKites para crear y actualizar tarjetas de seguimiento. Una vez conectado, puede iniciar una solicitud de seguimiento para cualquier carga con un transportista asignado, revisar los detalles de la carga precargados en un formulario de seguimiento y supervisar el estado de cada solicitud de seguimiento directamente en la página de detalles de la carga.
Esta integración es unidireccional: los datos fluyen de Alvys a FourKites. Alvys envía a FourKites las tarjetas de carga, los detalles de las paradas, la información del transportista y los números de referencia. Alvys no recibe actualizaciones de ubicación de FourKites.
La integración se configura por filial y requiere una clave API de FourKites.
Requisitos previos
Antes de conectarse, asegúrese de tener:
Una cuenta activa de FourKites con acceso a la API.
Una clave API de FourKites (puede obtenerla en la configuración de su cuenta de FourKites o a través de su administrador de cuenta de FourKites).
Puesto de administrador, administrador de socios o soporte en Alvys.
Al menos una filial configurada en Alvys que desee habilitar para esta integración.
Conectar / Autenticar
Esta configuración se realiza una sola vez por filial. Puede habilitar varias filiales utilizando la misma clave API si su cuenta de FourKites las abarca a todas.
Abra la configuración de EDI y visibilidad. Seleccione su perfil de usuario en la esquina inferior izquierda de Alvys y, a continuación, seleccione EDI y visibilidad .
Localiza FourKites Inbound en la lista de integraciones disponibles y selecciónala para abrir el formulario de configuración.
Introduzca su clave API. En el formulario de configuración, introduzca la clave API de FourKites que obtuvo de FourKites.
Seleccione las filiales. Elija las filiales que desea habilitar para esta integración. Cada filial que seleccione utilizará la clave API que haya introducido.
Guarda y verifica. Selecciona Guardar . Alvys validará tus credenciales con FourKites. Si la clave es válida, el estado de la integración se actualizará para confirmar que la conexión está activa. Si la validación falla, verifica la clave API e inténtalo de nuevo.
Mapeo de campos y datos
Alvys envía los siguientes datos 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 orden de compra se envían como números de referencia adjuntos al envío. El nombre del cliente de la carga y su ID se envían como etiquetas en la tarjeta de FourKites, vinculando al cliente de Alvys con el cliente correspondiente en FourKites.
Para cada parada de recogida y entrega, Alvys envía la dirección (línea de dirección 1, línea de dirección 2, ciudad, estado, país), el intervalo de tiempo programado (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. FourKites no admite paradas de punto de referencia y, por lo tanto, no las envía.
Los detalles de seguimiento del transportista se envían únicamente cuando se proporcionan: número de camión, número de remolque y número de teléfono del conductor. El campo del nombre del transportista en FourKites es opcional; Alvys no lo completa automáticamente porque FourKites no tiene un identificador de nombre de transportista específico que se corresponda de forma fiable con los registros de transportistas de Alvys.
Comportamiento de sincronización
Alvys envía datos a FourKites en los siguientes escenarios:
Al seleccionar el botón de seguimiento de FourKites en una carga y enviar el formulario de seguimiento, Alvys crea un nuevo envío en FourKites. Si una solicitud de seguimiento anterior para el mismo viaje se canceló previamente, Alvys reutiliza el registro existente y lo actualiza en lugar de crear uno 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 ficha. Alvys envía la información actualizada a FourKites.
Cuando se cancela 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.
⚠️ FourKites no envía actualizaciones de ubicación ni de estado a Alvys. El estado de seguimiento que se muestra en Alvys refleja el estado de la solicitud que creó Alvys, no los datos de ubicación en tiempo real de FourKites.
Verifica que funcione.
Después de iniciar una solicitud de seguimiento en una carga:
En la página de detalles de la carga, confirme que el indicador de estado de seguimiento muestre "Listo para rastrear". Si muestra "Error", consulte la sección de Solución de problemas a continuación.
Seleccione el enlace que aparece en la página de detalles de la carga para abrir directamente la ficha de FourKites. Confirme que el número de carga, las direcciones de parada y los números de referencia sean correctos en FourKites.
En FourKites, verifique que las paradas correctas aparezcan como recogida y entrega dentro de los horarios de citas programados.
Solución de problemas
El estado de seguimiento muestra un error después de crear una solicitud.
Abra la carga en Alvys y verifique que todas las paradas de recogida y entrega tengan una dirección completa (se requieren la primera línea de la dirección, la ciudad, el estado y el país). Las paradas intermedias no se envían a FourKites.
Verifique que la clave API de FourKites en la configuración de EDI y visibilidad siga siendo válida. Las claves API se pueden rotar o cambiar en su cuenta de FourKites. Vuelva a introducir la clave y guárdela si ha cambiado.
Si las paradas tienen direcciones y la clave API es válida, póngase en contacto con el soporte de Alvys e indíquele el número de carga y el mensaje de error que aparece en la página de detalles de la carga.
La tarjeta FourKites no muestra el cliente correcto.
FourKites no tiene un campo específico para el cliente. Alvys transfiere el nombre y la identificación del cliente de carga como etiquetas en el envío de FourKites. Si la tarjeta no se asocia con el cliente de FourKites correcto, conecte la identificación del cliente de Alvys directamente con el cliente de FourKites en la configuración de su cuenta de FourKites.
El botón de seguimiento no es visible en la carga.
La integración de entrada de FourKites debe estar activa para la filial asociada a la carga. Confirme que la filial esté habilitada en la configuración de EDI y visibilidad. Si la filial está habilitada y el botón sigue sin aparecer, póngase en contacto con el soporte de Alvys.
La integración no aparece en la configuración de EDI y visibilidad.
La página de EDI y visibilidad solo es accesible para los roles de Administrador, Administrador de socios y Soporte. Si no ve esta opción de menú, su rol no incluye acceso. Póngase en contacto con el administrador de su empresa para configurar la integración.
Límites / No compatible
Las actualizaciones de ubicación de FourKites no se envían a Alvys. La integración es unidireccional (solo de Alvys a FourKites).
Las paradas de punto de referencia no son compatibles. Solo se envían a FourKites los tipos de parada de recogida y entrega.
En FourKites, Alvys no rellena automáticamente el campo del nombre del transportista. Puede introducirlo manualmente en el formulario de seguimiento.
La integración se configura por filial. Una filial que no esté habilitada no mostrará el botón de seguimiento de FourKites en las cargas.
Si un envío no utiliza números de pedido ni números de orden de compra, esos campos de referencia aparecerán vacíos en la ficha de FourKites. La ficha se creará igualmente utilizando el número de envío.
Preguntas frecuentes
P: ¿Necesito introducir el nombre de la empresa de transporte al iniciar una solicitud de seguimiento?
R: No. El campo del nombre del transportista es opcional. FourKites acepta la solicitud sin él y la tarjeta de carga se crea correctamente. Si es necesario, puede agregar el nombre del transportista manualmente en el formulario de seguimiento.
P: ¿Recibe Alvys actualizaciones de ubicación en tiempo real de FourKites?
R: No. Esta integración solo envía datos de Alvys a FourKites. Las coordenadas de ubicación en tiempo real y las actualizaciones del estado de entrega en FourKites se visualizan directamente en FourKites; 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 filial?
A: La integración se configura a nivel de filial para que la configuración de seguimiento se segmente correctamente para cada unidad de negocio. Esto le permite controlar qué filiales envían datos de carga a FourKites y cuáles no.
P: ¿Puedo usar la misma clave API de FourKites para varias filiales?
R: Sí. Puede introducir la misma clave API y habilitar varias filiales en un único guardado de configuración.
P: ¿Qué sucede si detengo una solicitud de seguimiento en Alvys?
A: 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 ha detenido.
P: Mi flujo de trabajo no utiliza números de pedido ni números de orden de compra. ¿Seguirá funcionando la integración con FourKites?
R: Sí. Si un envío no utiliza números de pedido ni números de orden de compra, esos campos de referencia aparecerán vacíos en la ficha de FourKites. La ficha se crea y actualiza igualmente utilizando el número de envío.