Skip to main content
InicioBlogGuíasCómo las marcas de comercio electrónico por suscripción pueden realizar el seguimiento de los envíos recurrentes con una API de seguimiento

Cómo las marcas de comercio electrónico por suscripción pueden realizar el seguimiento de los envíos recurrentes con una API de seguimiento

17TRACK

Para realizar el seguimiento de envíos recurrentes con una API de seguimiento, crea un registro de envío para cada paquete físico, vincúlalo al pedido de preparación correspondiente a ese ciclo de suscripción y registra su número de seguimiento cuando tu almacén o socio logístico lo proporcione. Utiliza las actualizaciones de seguimiento de la API para mostrar a los clientes dónde se encuentra ese paquete y señalar las excepciones de entrega a tu equipo. Mantén el ID de suscripción como vínculo entre ciclos, no como identificador de un paquete.

Cómo las marcas de comercio electrónico por suscripción pueden realizar el seguimiento de envíos recurrentes con una

Realiza el seguimiento del paquete, no de la suscripción

Una suscripción te indica lo que un cliente tiene programado recibir con el tiempo. Un pedido de preparación te indica lo que debe enviarse durante un ciclo. Un número de seguimiento te informa sobre un paquete concreto. Mantener estos registros separados evita que un envío retrasado de un ciclo aparezca en la página de seguimiento del siguiente.

Por ejemplo, supongamos que una caja de suscripción de mayo se divide en dos paquetes y que la caja de junio se envía mientras uno de los paquetes de mayo aún está en tránsito. El cliente debe ver dos paquetes en el pedido de mayo y un paquete separado en el pedido de junio. La actualización tardía de mayo solo debe modificar el paquete de mayo. Si envías un reemplazo, crea un nuevo registro de envío y vincúlalo al original para que el equipo de soporte pueda ver por qué existen ambos.

  • Suscripción: Guarda el ID de suscripción para que el equipo de soporte pueda encontrar el historial de envíos del cliente.
  • Ciclo y pedido: Registra el identificador del ciclo o la fecha de preparación programada, el ID del pedido y cualquier ID de preparación necesario para asociar los paquetes con el pedido correcto. No deduzcas el ciclo a partir de la fecha en que llega un evento de seguimiento.
  • Envío: Asigna a cada paquete un ID de envío interno. Guarda su transportista y número de seguimiento, la referencia de preparación correspondiente y cualquier ID de registro de seguimiento que devuelva el proveedor. Mantén las etiquetas canceladas y los números de seguimiento sustituidos fuera de la vista activa del cliente, pero conserva el historial para el equipo de soporte.

En la página de un pedido, muestra el progreso a nivel de paquete junto con cualquier resumen del pedido. Si un paquete se ha entregado y otro está en tránsito, indícalo. Muestra el pedido completo como entregado solo cuando hayan llegado todos los paquetes necesarios para completarlo, teniendo en cuenta los envíos cancelados y los reemplazos.

Conecta la preparación con la API de seguimiento

  1. Registra a partir de un evento de preparación. Activa el registro cuando un sistema de preparación, almacén o socio logístico externo envíe el transportista y el número de seguimiento. Un pago de renovación es demasiado pronto: el pedido aún puede estar esperando para ser enviado y es posible que no exista ningún número de seguimiento.
  2. Guarda el envío antes de llamar a la API. Conserva el registro de envío interno y pon en cola la solicitud de registro. Si el mismo mensaje de preparación llega dos veces, reutiliza ese registro en lugar de crear otro paquete. Si la llamada a la API agota el tiempo de espera, comprueba si la solicitud original se realizó correctamente antes de volver a intentarlo, cuando el proveedor te ofrezca una forma de hacerlo.
  3. Asocia las actualizaciones con el paquete registrado. Utiliza el identificador de registro del proveedor si se devuelve en las actualizaciones. De lo contrario, realiza la asociación mediante los identificadores especificados en su documentación y valida el resultado con tus registros de envíos. Si una actualización podría pertenecer a más de un registro, envíala para revisión en lugar de aplicarla al pedido más reciente.
  4. Separa la creación de la etiqueta del movimiento del transportista. Puede existir un número de seguimiento antes de que el transportista registre la posesión del paquete. Utiliza un mensaje como «Preparándose para la recogida del transportista» cuando solo tengas una etiqueta. Reserva «En tránsito» para la información del transportista que lo respalde.

La API de seguimiento de 17TRACK es una opción para esta configuración. Su documentación para desarrolladores es la referencia para registrar números de seguimiento y recibir actualizaciones de seguimiento. Utiliza esas actualizaciones para mantener el registro del paquete en tu sistema; conserva las reglas de asignación de ciclos, finalización de pedidos y notificación al cliente en tu aplicación de comercio electrónico. Antes del lanzamiento, realiza pruebas con paquetes de tus rutas de transportistas y socios de preparación reales, en lugar de depender únicamente de una lista de transportistas.

Haz que las actualizaciones puedan procesarse dos veces de forma segura

Cuando tu proveedor ofrezca webhooks, utilízalos para recibir actualizaciones sin consultar continuamente cada paquete. Un webhook es una solicitud HTTP que el proveedor envía a tu aplicación. Sigue los requisitos de verificación del proveedor, almacena los datos aceptados de forma duradera y confirma las solicitudes según sus reglas de respuesta documentadas. Ejecuta las tareas más lentas, como actualizar las vistas de pedidos o enviar correos electrónicos, fuera del controlador de solicitudes.

Diseña el flujo de procesamiento de modo que una actualización repetida no tenga ningún efecto adicional. Si el proveedor proporciona ID de eventos estables, utilízalos para reconocer las repeticiones. Si envía instantáneas de seguimiento en lugar de eventos individuales, compara el estado entrante y el historial de escaneos con la información que ya tienes antes de actuar. Deduplica los mensajes al cliente por separado: una notificación de entrega que ya se ha enviado no debe volver a enviarse solo porque los mismos datos de envío se procesaron dos veces.

Mantén separadas la hora en que se produjo un escaneo y la hora en que tu aplicación lo recibió. Un escaneo de tránsito que llega tarde puede formar parte del historial del paquete sin sustituir un estado de entrega más reciente. Sin embargo, no supongas que todo cambio legítimo hace avanzar un paquete. Una corrección del transportista o una actualización de devolución al remitente puede requerir modificar lo que muestras. Si los nuevos datos entran en conflicto con el estado almacenado y no puedes determinar cuál es correcto, coloca el envío en una cola de revisión.

Realiza comprobaciones periódicas de los envíos abiertos que puedan necesitar atención: registros aún pendientes, paquetes sin un primer escaneo después de una entrega esperada y envíos cuyo seguimiento ha dejado de actualizarse. Cuando la API admita una consulta o actualización, utilízala de forma selectiva dentro de los límites del proveedor. Comprueba el patrón entre transportistas y almacenes antes de escalar el problema. Si las actualizaciones se detienen para muchos envíos no relacionados al mismo tiempo, investiga la integración antes de abrir casos individuales de entrega.

Convierte los datos de seguimiento en mensajes útiles para los clientes

Los clientes rara vez necesitan un correo electrónico por cada escaneo. Empieza con mensajes relacionados con algo que necesiten saber o hacer: el paquete ha entrado en la red del transportista, un intento de entrega requiere acción o el transportista informa de la entrega. Muestra la referencia del pedido y la caja o el ciclo correspondiente para que los suscriptores puedan saber a qué envío se refiere el mensaje. En un pedido dividido, identifica el paquete y deja claro si el resto del pedido aún está en camino.

  • Etiqueta creada, sin escaneo: Comprueba la entrega prevista con los registros del almacén. Si ha pasado el plazo de entrega, pide al equipo de preparación que confirme si el paquete salió de las instalaciones antes de informar al cliente de que está retrasado en tránsito.
  • El seguimiento ha dejado de avanzar: Utiliza umbrales que reflejen la ruta y el servicio, en lugar de un único temporizador para todos los paquetes. En los envíos transfronterizos, revisa el último evento del transportista antes de decidir si debes contactar con el cliente o escalar el caso.
  • Intento fallido o recogida necesaria: Indica al cliente qué acción debe realizar si el transportista proporciona instrucciones claras. Si el evento es impreciso, dirige el caso al equipo de soporte en lugar de adivinar una fecha de nueva entrega o un lugar de recogida.
  • Marcado como entregado, pero no recibido: Conserva el estado comunicado por el transportista y abre un caso de soporte separado. Tu flujo de soporte debe distinguir un informe del cliente de una corrección del transportista.

Proporciona al personal de soporte una vista única del ciclo, el pedido, el historial de paquetes y los mensajes ya enviados. Para cada excepción, asigna un responsable y un siguiente paso. El equipo de preparación puede investigar una entrega omitida, logística puede hacer seguimiento de una excepción del transportista y soporte puede gestionar la comunicación con el cliente. Un estado de seguimiento describe el paquete; no decide si corresponde un reemplazo o un reembolso.

Prueba la superposición antes del lanzamiento

Comienza con un socio de preparación y un conjunto de envíos que refleje cómo despacha realmente los pedidos. Incluye un ciclo con varios paquetes, una etiqueta anulada, un reemplazo y un envío antiguo que siga abierto cuando se envíe el ciclo siguiente. Después, reproduce deliberadamente un webhook duplicado y entrega un evento antiguo después de uno más reciente. Comprueba el registro del paquete, la página de pedido del cliente, la vista de soporte y el registro de notificaciones. Una prueba que solo verifique una respuesta correcta de la API puede pasar por alto el error más costoso: actualizar el pedido equivocado o enviar un mensaje al cliente equivocado.

Supervisa los fallos de registro, la proporción de paquetes aptos que se registran correctamente, los primeros escaneos que llegan más tarde de lo previsto y las actualizaciones no asociadas. Si realizas un seguimiento de la latencia de las actualizaciones, distingue el tiempo entre un evento del transportista y su recepción del tiempo que tarda tu propio sistema en procesarlo. Esto te ayuda a decidir si debes investigar el flujo de datos del transportista, tu endpoint de webhook o una cola dentro de tu aplicación.

Amplía a más rutas cuando puedas responder a tres preguntas sobre cualquier paquete: ¿A qué ciclo pertenece? ¿Qué informó por última vez el transportista? ¿Quién actúa si la actualización falta o es incorrecta? Si alguna respuesta no está clara, corrige la asociación de registros o el flujo de excepciones antes de añadir más reglas de notificación.

Preguntas frecuentes

¿Puede una API de seguimiento informar a los clientes de cuándo se enviará su próxima caja de suscripción?

Utiliza el calendario de suscripción y el sistema de preparación para conocer la próxima fecha de envío prevista. Una API de seguimiento sirve para un paquete concreto una vez que existe información de seguimiento. Una fecha de envío prevista, una estimación de entrega del transportista y una entrega confirmada son datos distintos y deben etiquetarse por separado.

¿Qué ocurre si el almacén sustituye un número de seguimiento después de enviar un correo electrónico?

Marca la etiqueta antigua como sustituida y vincula el nuevo número de seguimiento al mismo pedido. Si tu correo electrónico dirige a una página de seguimiento a nivel de pedido, actualiza esa página para que el cliente pueda encontrar el paquete activo sin necesitar el enlace original del transportista. Envía una corrección cuando el cambio afecte a información sobre la que el cliente deba actuar.

¿Qué ocurre si un socio de preparación envía números de seguimiento sin códigos de transportista?

Pide al socio un campo de transportista coherente o una correspondencia con sus códigos de servicio de envío. Si tu API ofrece detección del transportista, verifica cómo funciona con las etiquetas del socio antes de confiar en ella. Envía las coincidencias ambiguas a revisión en lugar de elegir un transportista basándote únicamente en el número de seguimiento.

¿Las suscripciones pausadas u omitidas necesitan registros de seguimiento?

No se necesita un registro de paquete para un ciclo que nunca se envía. Si un envío anterior sigue abierto, continúa realizando su seguimiento aunque la suscripción esté pausada, omitida o cancelada. El estado de la suscripción controla la preparación futura; no te indica qué ocurrió con un paquete que ya salió del almacén.

Fuentes