Skip to main content
InicioBlogGuíasSeguimiento de carga aérea frente al seguimiento de paquetes transfronterizos: ¿qué capacidades de API necesitas?

Seguimiento de carga aérea frente al seguimiento de paquetes transfronterizos: ¿qué capacidades de API necesitas?

17TRACK

Elige una API de seguimiento de carga aérea cuando tu aplicación deba supervisar conocimientos de embarque aéreo, tramos de vuelo, hitos de manipulación de la carga y cantidades de envíos. Elige una API de seguimiento de paquetes transfronterizos cuando necesites actualizaciones a nivel de paquete entre transportistas, excepciones de entrega y estado de la entrega de última milla. Si tus envíos combinan carga aérea consolidada con la entrega de paquetes individuales, necesitas ambas capas de visibilidad y una forma fiable de conectar sus identificadores.

Comparación entre el seguimiento de carga aérea y el seguimiento de paquetes transfronterizos: capacidades de la API

Para los equipos de ingeniería, los operadores logísticos y las empresas de comercio electrónico, la decisión de compra depende menos de qué API devuelve más eventos y más de si esos eventos describen la unidad de envío que realmente gestionas. Un evento de llegada de una aerolínea, por sí solo, no puede indicar a un comprador dónde está su paquete ni cuándo llegará a su puerta.

Comienza por la unidad de envío, no por el modo de transporte

La carga aérea y los paquetes transfronterizos no son categorías de envío mutuamente excluyentes. Un paquete puede viajar internacionalmente en avión, mientras la aerolínea lo gestiona como parte de un envío consolidado más grande. La distinción para seleccionar la API es el objeto operativo que se está siguiendo.

La visibilidad de la carga aérea suele centrarse en un conocimiento de embarque aéreo y en el movimiento de transporte asociado. Según la fuente, los datos pueden describir la aceptación, la salida, la llegada, la disponibilidad de la carga y la entrega. La visibilidad de los paquetes se centra en paquetes individuales y en su avance durante la recogida, el transporte internacional, el procesamiento en destino y la entrega.

Un conocimiento de embarque aéreo maestro puede representar un movimiento consolidado que contiene varios envíos subyacentes. Los conocimientos de embarque aéreos internos, las etiquetas de paquetes y los números de seguimiento del transportista de destino pueden identificar distintos niveles dentro de ese movimiento. No supongas que un proveedor de seguimiento puede descubrir o conectar automáticamente todas estas relaciones.

Área de decisiónSeguimiento de carga aéreaSeguimiento de paquetes transfronterizos
Objeto principalConocimiento de embarque aéreo, envío o tramo de transportePaquete individual y sus identificadores del transportista
Preguntas operativas¿Se aceptó, transportó, recibió o entregó la carga?¿Dónde está el paquete, qué lo está bloqueando y fue entregado?
Relaciones que deben conservarseReferencias maestras e internas, tramos, piezas y movimientos divididosVínculos entre pedidos y paquetes, entregas entre transportistas, identificadores de reemplazo y devoluciones
Responsable habitual de la acciónEquipo de expedición, transporte u operaciones de cargaEquipo de operaciones de comercio electrónico, atención al cliente o gestión de entregas
Riesgo principal de interpretaciónConsiderar un tramo o una llegada parcial como la finalización de todo el envíoConsiderar una entrega entre operadores o un evento de entrega ambiguo como la recepción por parte del comprador

Qué debe admitir una API de seguimiento de carga aérea

Identidad del conocimiento de embarque aéreo y relaciones del envío

Pregunta qué identificadores acepta la API y qué devuelve cada consulta. La compatibilidad con un conocimiento de embarque aéreo maestro no establece automáticamente la compatibilidad con la visibilidad a nivel interno. Si tus operaciones dependen de envíos internos, exige una demostración utilizando tus propias referencias y fuentes de datos autorizadas.

El modelo de datos debe conservar las relaciones entre el envío, sus tramos de transporte y cualquier parte que se desplace por separado. Para los flujos de trabajo sensibles a las cantidades, pregunta si los recuentos y pesos de las piezas están disponibles a nivel de envío, de evento o en ambos. Un total a nivel de envío no sustituye saber cuánta carga llegó a un aeropuerto concreto.

Visibilidad de los tramos de transporte y la manipulación

Exige suficiente contexto para distinguir una salida del origen de una salida de conexión, y un movimiento planificado de uno real. Los campos útiles pueden incluir aeropuertos de origen y destino, referencias de vuelo, ubicaciones de eventos y marcas de tiempo programadas frente a reales. Su disponibilidad depende de la fuente y debe verificarse, no suponerse.

Distingue también el movimiento del vuelo del movimiento de la carga. La llegada de una aeronave no demuestra por sí sola que todos los envíos asociados se hayan cargado, descargado, procesado o puesto a disposición. Pregunta si un evento es específico del envío o si se deriva de un flujo de datos del vuelo.

Movimientos parciales y significado de los hitos

Un envío de carga puede desplazarse por partes. Tu sistema no debe marcar todo el envío como llegado simplemente porque exista un evento de llegada para una parte del mismo. Prueba cómo representa la API varios vuelos, cantidades parciales, rutas modificadas y correcciones.

Las definiciones de los hitos requieren un análisis similar. La entrega a un expedidor u otra parte logística no equivale necesariamente a la entrega al consignatario final. Pide al proveedor que explique el significado operativo de los eventos de finalización y conserva ese significado en tu modelo de estados interno.

La iniciativa ONE Record de IATA proporciona una referencia sectorial relevante para el intercambio de datos de carga y las estructuras de datos estandarizadas. Sin embargo, afirmar el cumplimiento de un estándar no demuestra el acceso a todas las aerolíneas, operadores, envíos o hitos. Pregunta qué implementación, relaciones de datos, permisos y fuentes operativas están realmente disponibles.

Qué debe admitir una API de seguimiento de paquetes transfronterizos

Identificación del transportista y continuidad de las entregas

Los recorridos de los paquetes internacionales pueden involucrar a un operador de origen, un proveedor logístico transfronterizo y un transportista de entrega de destino. Una integración debe ayudarte a mantener la continuidad cuando cambia el identificador o el transportista responsable.

Comprueba si la API devuelve números de seguimiento posteriores, relaciones entre transportistas o únicamente eventos del identificador que enviaste. Si esas relaciones no están disponibles, determina si tu plataforma de envíos, almacén o socio logístico puede proporcionarlas. No prometas una vinculación automática de extremo a extremo sin probarla.

La detección del transportista también necesita una alternativa. Los patrones similares de los números de seguimiento pueden generar ambigüedad, por lo que tu integración debe permitir seleccionar explícitamente el transportista u otro método de desambiguación documentado cuando sea compatible.

Estados normalizados con evidencia original

Un modelo de estados común facilita la automatización de notificaciones entre transportistas. Pero la normalización no debe borrar la descripción original del evento, la ubicación, la marca de tiempo ni el transportista de origen.

Por ejemplo, un estado de excepción general puede representar un problema con la dirección, un retraso relacionado con aduanas o un intento de entrega fallido. Cada caso requiere acciones diferentes. Conserva el mensaje original y utiliza categorías de excepción específicas solo cuando la fuente las admita.

Resultados de entrega y excepciones prácticas

Los equipos de paquetería normalmente necesitan separar los eventos de salida para entrega, intento de entrega, disponibilidad para recogida, entrega completada y relacionados con devoluciones. Pregunta qué distinciones expone la API y si son coherentes entre los transportistas que utilizas.

Considera la prueba de entrega como un requisito independiente. Un estado de entrega completada no garantiza el acceso a una firma, fotografía, nombre del destinatario o documento. Confirma la disponibilidad, los permisos de acceso, la conservación y las restricciones de privacidad de los servicios pertinentes.

La información aduanera también tiene límites. Un evento de seguimiento que menciona las aduanas no proporciona necesariamente un registro de declaración, una explicación de los aranceles o una previsión fiable de liberación. Crea reglas de escalamiento basadas en lo que realmente dice el evento, no en un resultado legal o aduanero inferido.

Capacidades que necesitan ambos tipos de API

Ingesta y recuperación fiables de eventos

Para los flujos de trabajo basados en eventos, evalúa la entrega de webhooks, la autenticación, los reintentos, la gestión de duplicados y la recuperación después de una interrupción. Estos son requisitos de adquisición que deben verificarse, no funciones que debas suponer que ofrece todo proveedor.

Diseña tu consumidor para gestionar mensajes duplicados y fuera de orden. Almacena el momento del evento por separado del momento en que tu sistema recibió la actualización. Si no existe un identificador de evento estable, define un método documentado de deduplicación utilizando los campos disponibles.

Pregunta si puedes recuperar el historial de eventos de un envío después de perder notificaciones. Los webhooks son útiles para activar tareas; un proceso de recuperación o conciliación compatible es lo que ayuda a recuperarse cuando se pierde ese activador.

Actualidad, procedencia y gestión de marcas de tiempo

Separa tres relojes: cuándo ocurrió el evento físico, cuándo lo publicó la fuente y cuándo lo recibió tu aplicación. No todas las fuentes exponen los tres, pero mantener separadas las marcas de tiempo disponibles facilita el diagnóstico de retrasos.

Asimismo, distingue entre que no haya un evento nuevo y que una consulta haya fallado. Un historial de envío sin cambios puede reflejar un intervalo legítimo entre escaneos, una interrupción de la fuente, un identificador no reconocido o un problema de integración. Tu equipo de operaciones necesita suficiente información de diagnóstico para elegir la respuesta adecuada.

Conserva la información de zona horaria cuando se proporcione. Si una marca de tiempo de la fuente no incluye zona horaria, registra esa limitación en lugar de convertirla silenciosamente en una hora global aparentemente precisa.

Acceso, costes y controles operativos

Confirma la autenticación, el aislamiento de cuentas, la conservación de datos, los procedimientos de eliminación, los límites de frecuencia y las condiciones de asistencia en producción. Los datos de seguimiento pueden incluir información personal, por lo que debes recopilar y exponer únicamente lo que necesite tu flujo de trabajo.

Compara las condiciones comerciales con tu carga de trabajo real. Pregunta qué se factura: un envío registrado, una solicitud, una actualización u otra unidad. Aclara cómo se tratan los números no válidos, los registros duplicados, el seguimiento repetido, las consultas históricas y los excesos. Sin esas definiciones, un precio destacado no es una comparación de costes fiable.

Cuándo utilizar una API y cuándo combinar fuentes de datos

Elige una visibilidad centrada en la carga cuando tu equipo actúe sobre hitos de conocimientos de embarque aéreo, manipulación aeroportuaria, fallos de conexión o llegadas parciales de carga. El seguimiento de paquetes por sí solo no sustituye adecuadamente estos flujos de trabajo, salvo que se demuestre explícitamente el nivel de detalle de carga requerido.

Elige una visibilidad centrada en paquetes cuando tu equipo necesite actualizaciones de entrega a nivel de paquete, notificaciones a clientes, eventos del transportista de destino y gestión de excepciones de entrega. Un flujo de datos de conocimientos de embarque aéreo por sí solo no es suficiente para el seguimiento de entregas orientado al comprador.

Combina ambos cuando gestiones el transporte internacional de larga distancia y la entrega de paquetes individuales. Mantén registros separados para la consolidación y sus paquetes, y conéctalos mediante referencias proporcionadas por tu propio proceso logístico o por un flujo de datos de un socio verificado.

Por ejemplo, un comerciante puede enviar un lote consolidado por vía aérea antes de inyectarlo en destino en una red de paquetería. Registra la llegada de la carga contra la consolidación. Actualiza cada paquete únicamente cuando exista evidencia relevante para ese paquete; no conviertas la llegada del lote al aeropuerto en un evento de entrega para cada pedido.

Dónde encaja 17TRACK

Para la parte de paquetes de esta arquitectura, la API de seguimiento de 17TRACK es relevante para evaluar una integración de seguimiento multitransportista. Utiliza la documentación oficial de la API para comprobar la integración con respecto a los identificadores requeridos, los campos de respuesta, el flujo de notificaciones y los límites operativos.

No consideres la evaluación de una API de paquetes como confirmación de su funcionalidad para carga aérea. Si también necesitas relaciones entre conocimientos maestros e internos, detalles de tramos de vuelo o movimientos parciales de piezas, solicita confirmación explícita y respuestas de ejemplo para esos requisitos. La función adecuada de un producto viene determinada por los flujos de trabajo que puede demostrar, no por la amplitud de la palabra «seguimiento».

Realiza una prueba de concepto antes de comprometerte

Utiliza envíos representativos de tus transportistas, rutas y tipos de servicio reales. Incluye envíos completados con resultados conocidos, así como envíos activos. Una consulta exitosa para un único envío sencillo no basta para validar la integración.

  1. Define la decisión que debe respaldar cada evento. Algunos ejemplos son investigar una conexión de carga perdida, contactar a un comprador por un problema con la dirección o enviar una notificación de entrega.
  2. Construye un conjunto de pruebas representativo. Incluye entregas entre transportistas, periodos sin actividad, intentos de entrega, devoluciones y movimientos divididos de carga cuando sea relevante.
  3. Comprueba la precisión a nivel de objeto. Confirma si cada evento corresponde a un vuelo, envío, parte o paquete individual.
  4. Compara con la fuente operativa. Comprueba los hitos faltantes, las marcas de tiempo, las ubicaciones, los mensajes originales y la gestión de correcciones frente a los registros del transportista o socio a los que estés autorizado a acceder.
  5. Prueba la recuperación ante fallos. Prueba eventos duplicados, eventos retrasados, identificadores no válidos, transportistas ambiguos, interrupciones de webhooks y conciliación.
  6. Valida la economía y la responsabilidad. Estima el coste a partir de tu carga de trabajo y asigna la responsabilidad de los problemas de datos de origen, los fallos de integración y la comunicación con los clientes.

Establece los criterios de aceptación antes de revisar los resultados. Deben abarcar los campos requeridos, el significado de los eventos, el comportamiento de recuperación y los retrasos de actualización aceptables para cada flujo de trabajo. Una notificación al cliente y una intervención de carga pueden requerir umbrales diferentes.

Preguntas frecuentes

¿Puede una sola API de seguimiento cubrir carga aérea y paquetes?

Potencialmente, pero confirma el modelo de datos y el acceso a las fuentes para ambos. Un punto de acceso compartido no demuestra la compatibilidad con cantidades de carga, tramos de vuelo, relaciones internas o entregas entre transportistas. Solicita demostraciones independientes para los dos flujos de trabajo.

¿Puedo utilizar un número de conocimiento de embarque aéreo para seguir un paquete individual?

No necesariamente. Un conocimiento de embarque aéreo puede identificar un envío mayor en lugar de un paquete individual. Necesitas una relación verificada entre ese envío y el identificador del paquete para conectar sus historiales.

¿«Seguimiento en tiempo real» significa una ubicación física continua?

No lo des por supuesto. El seguimiento puede basarse en eventos operativos publicados a intervalos en lugar de telemetría de ubicación continua. Pregunta qué activa las actualizaciones, qué marcas de tiempo se exponen y si algún dato de ubicación procede de una fuente de sensores independiente.

¿Son mejores los webhooks que las consultas periódicas?

Los webhooks son útiles para recibir notificaciones de eventos sin realizar solicitudes de estado repetidas. Las consultas periódicas u otro mecanismo de recuperación aún pueden respaldar la conciliación y la recuperación. Elige un diseño basándote en el comportamiento y los límites documentados del proveedor, así como en tu tolerancia a actualizaciones perdidas o retrasadas.

¿Un evento de entrega completada demuestra que el comprador recibió el envío?

No en todos los contextos. La finalización de la carga puede describir la entrega a una parte logística, mientras que los eventos de entrega de paquetes dependen del proceso de entrega del transportista. Verifica la definición del evento y obtén pruebas de entrega independientes cuando tu flujo de trabajo lo requiera.

Fuentes