Skip to main content
InicioBlogGuías¿Por qué los marketplaces de segunda mano necesitan una API de seguimiento de envíos?

¿Por qué los marketplaces de segunda mano necesitan una API de seguimiento de envíos?

17TRACK

Los marketplaces de artículos de segunda mano necesitan una API de seguimiento de envíos cuando las actualizaciones de entrega deben ofrecer algo más que un enlace de seguimiento. Al incorporar los eventos de envío a los propios sistemas del marketplace, una API puede ayudar a los compradores a seguir sus compras, a los vendedores a demostrar el progreso del envío y a los equipos de soporte a investigar los problemas de entrega. Su mayor valor consiste en conectar la visibilidad del envío con las operaciones del marketplace sin tratar los datos de seguimiento como prueba de la identidad, el estado o la autenticidad de un artículo.

Por qué los marketplaces de artículos de segunda mano necesitan una API de seguimiento de envíos

Para los responsables de producto, los equipos de ingeniería y los operadores de marketplaces, la decisión no consiste simplemente en determinar si se deben mostrar las ubicaciones de los paquetes. Consiste en saber si un registro de envío compartido mejoraría la forma en que la plataforma gestiona el despacho del vendedor, la comunicación con el comprador, las excepciones de entrega y las disputas.

Por qué los envíos de artículos de segunda mano crean un problema de visibilidad diferente

Un marketplace de artículos de segunda mano puede coordinar transacciones entre muchos vendedores individuales en lugar de despachar todo desde un almacén controlado. Los vendedores pueden utilizar diferentes transportistas, comprar etiquetas a través de distintos canales y entregar los paquetes en momentos diferentes. Por lo tanto, el marketplace debe distinguir lo que informa un vendedor de lo que ha registrado un transportista.

La reventa también cambia lo que ocurre cuando algo sale mal durante la entrega. Es posible que una determinada chaqueta usada, pieza de colección o artículo reacondicionado no tenga un reemplazo idéntico disponible. Los equipos de soporte necesitan una descripción clara del envío antes de decidir qué investigar o cómo explicar al comprador el siguiente paso.

Consideremos una transacción ilustrativa: un vendedor marca una cámara usada como enviada e introduce un número de seguimiento. Al principio, el transportista solo muestra información electrónica del envío. Más tarde, aparece un escaneo de aceptación, seguido de un intento de entrega. Esos eventos representan diferentes estados operativos. Agruparlos todos bajo “enviado” deja al comprador mal informado y proporciona poco fundamento al equipo de soporte para actuar.

Una API de seguimiento puede poner estas distinciones a disposición del marketplace. Sin embargo, la plataforma debe decidir qué significa cada evento según sus propias reglas.

Qué hace una API de seguimiento de envíos —y qué no hace

Una API de seguimiento de envíos ofrece una forma programática de enviar identificadores de envío y recuperar información de seguimiento. Dependiendo del servicio y de la integración, las actualizaciones pueden obtenerse mediante solicitudes de API, notificaciones webhook o una combinación de ambas. Un webhook es un mensaje que se envía a tu aplicación cuando hay una actualización disponible.

El resultado útil no es solo el texto del estado más reciente del transportista. Es un historial del envío que el marketplace puede asociar con un pedido, un vendedor, un comprador y un caso de soporte.

  • Experiencia del comprador: Mostrar el progreso dentro de la página del pedido en lugar de exigir a los compradores que interpreten sitios web independientes de los transportistas.
  • Operaciones del vendedor: Distinguir un número de seguimiento enviado de un envío con actividad registrada por el transportista.
  • Flujos de trabajo de soporte: Presentar los eventos del envío junto con los detalles de la transacción y las comunicaciones anteriores.
  • Gestión de excepciones: Dirigir determinados problemas de entrega a una cola para su investigación.
  • Informes operativos: Examinar los patrones de despacho y entrega utilizando hitos claramente definidos.

Estas son posibles aplicaciones, no resultados automáticos. Una integración de seguimiento no crea por sí misma una política de disputas, garantiza la entrega, verifica el contenido del paquete ni proporciona un seguro de envío. Del mismo modo, comprar una etiqueta, organizar la recogida, calcular el franqueo y hacer seguimiento de un paquete son capacidades independientes. No asumas que una sola API incluye todas ellas.

Cinco flujos de trabajo de marketplace que se benefician de los datos de seguimiento compartidos

1. Separar las declaraciones del vendedor de la actividad del transportista

“El vendedor dice que lo envió” y “el transportista registró la aceptación” deben ser hechos independientes en el registro del pedido. Por lo general, un evento de creación de etiqueta no debe presentarse como confirmación de que el transportista tiene físicamente el paquete.

Conserva por separado la declaración de despacho del vendedor, la hora en que se envió el seguimiento y cualquier evento relevante del transportista. Esto permite al equipo de soporte explicar la falta de un escaneo de aceptación sin acusar inmediatamente al vendedor de no haber enviado el paquete. Los escaneos ausentes o retrasados requieren una investigación, no una conclusión automática.

2. Ofrecer actualizaciones útiles a los compradores sin crear una falsa certeza

Los compradores necesitan saber qué ha cambiado y si deben actuar. Un escaneo de aceptación puede requerir únicamente una actualización discreta en la página del pedido. Un evento de paquete listo para recoger puede justificar una notificación, mientras que un intento de entrega fallido puede necesitar una explicación más clara del siguiente paso.

Las notificaciones deben reflejar la información recibida realmente. No inventes una fecha de entrega cuando no se haya proporcionado ninguna. Si hay una fecha estimada disponible, indícala como estimación y conserva su fuente. Evita describir el seguimiento como continuamente activo: las actualizaciones dependen de los eventos del transportista, la disponibilidad de los datos y el comportamiento de procesamiento de la integración.

3. Organizar las excepciones de entrega

Un paquete que espera ser recogido necesita una respuesta diferente a la de uno que está regresando a su remitente. En lugar de incluir todos los envíos no entregados en una única cola de problemas, define colas en torno a condiciones que permitan actuar.

  • Sin aceptación registrada: Comprueba la información de entrega del vendedor y las indicaciones del transportista.
  • Intento de entrega fallido: Muestra las instrucciones disponibles para una nueva entrega o recogida.
  • A la espera de recogida: Notifica al comprador cuando haya información fiable sobre la recogida.
  • En proceso de devolución: Dirige el pedido al proceso de devoluciones o soporte correspondiente.
  • Entregado, pero disputado: Conserva el evento de entrega y abre una investigación independiente.

Establece umbrales de inactividad según el servicio de envío y la ruta cuando sea práctico. Una única regla de retraso universal puede crear alertas innecesarias para los servicios más lentos y, al mismo tiempo, pasar por alto problemas en los más rápidos.

4. Respaldar disputas y decisiones sobre pagos

Los eventos de envío pueden contribuir a la cronología de una transacción, pero no deben convertirse en la única autoridad para una decisión financiera. Un escaneo de entrega no demuestra que el artículo correcto estuviera dentro del paquete ni que coincidiera con el anuncio.

Si los eventos de entrega alimentan un flujo de trabajo de pagos, utiliza una capa de políticas independiente. Esa capa debe tener en cuenta las condiciones publicadas por el marketplace, los requisitos aplicables, las disputas abiertas y los procedimientos de revisión. Un diseño sensato permite que una excepción pause una acción automatizada en lugar de obligar al equipo de soporte a revertirla posteriormente.

5. Hacer visibles los trayectos de devolución

Un envío de devolución es un nuevo trayecto logístico. Asócialo con la transacción original, pero asígnale un registro de envío y una dirección independientes. De lo contrario, el evento de entrega de una devolución podría confundirse con la entrega al comprador.

El seguimiento de una devolución puede establecer hitos de transporte. No puede demostrar si el artículo devuelto es el original ni si su estado ha cambiado. Esas cuestiones requieren un proceso independiente de inspección o recopilación de pruebas.

Un diseño práctico de integración

Construye la integración en torno a los envíos, en lugar de utilizar un único campo de seguimiento en un pedido. Un pedido puede contener varios paquetes y una transacción puede adquirir posteriormente un envío de devolución.

  1. Crea un registro de envío. Asócialo con el pedido y el vendedor. Guarda el número de seguimiento, el transportista cuando se conozca, la dirección del trayecto y las marcas de tiempo relevantes.
  2. Comprueba los datos enviados. Detecta valores vacíos, problemas evidentes de formato y duplicados involuntarios. No trates un número plausible como prueba de que existe un envío auténtico.
  3. Registra o recupera el seguimiento. Sigue el proceso documentado por el proveedor seleccionado. Mantén diferenciados los resultados no compatibles, ambiguos y temporalmente no disponibles.
  4. Recibe las actualizaciones de forma fiable. En el caso de los webhooks, utiliza el mecanismo de autenticación o verificación compatible con el proveedor. Procesa los mensajes aceptados mediante una cola duradera cuando corresponda.
  5. Conserva los eventos de origen. Almacena el texto de estado original junto con tu estado normalizado, aplicando controles de acceso y conservación.
  6. Aplica las reglas del marketplace. Genera actualizaciones para compradores, tareas de soporte y solicitudes de revisión desde tu propia capa de políticas.
  7. Reconcilia las actualizaciones ausentes. Utiliza métodos de recuperación permitidos y alertas operativas para investigar las brechas, en lugar de asumir que todas las notificaciones llegarán correctamente.

Diseña el sistema para gestionar mensajes duplicados y eventos que lleguen fuera de secuencia. Volver a procesar el mismo evento no debería enviar otra notificación al comprador ni activar una segunda acción financiera. Mantén separada la marca de tiempo del evento de la hora en que tu sistema lo recibió; ambas responden a preguntas diferentes.

Los números de seguimiento no deben servir como credenciales públicas de autorización. Restringe los registros de envío a los usuarios autorizados, protege las credenciales de la API en el servidor y evita exponer datos innecesarios del destinatario en las notificaciones o los registros de la aplicación.

Cómo evaluar una API para un marketplace de artículos de segunda mano

Comienza con envíos representativos de tu base real de vendedores. Una lista amplia de transportistas es menos informativa que una gestión satisfactoria de los servicios, las rutas y los tipos de eventos que utiliza tu marketplace.

  • Adecuación del transportista y el servicio: Prueba los servicios reales que utilizan los vendedores, incluidos los traspasos internacionales y los trayectos de devolución pertinentes.
  • Interpretación de estados: Comprueba si tu aplicación puede distinguir entre información electrónica del envío, aceptación, tránsito, intentos de entrega, recogida, entrega y devoluciones cuando esos eventos estén disponibles.
  • Detalle de los eventos: Examina las marcas de tiempo, las descripciones de origen y la forma en que se representan las correcciones o los eventos retrasados.
  • Operaciones de webhooks: Verifica en la documentación las opciones de autenticación, el comportamiento de entrega, la gestión de reintentos y los procedimientos de recuperación.
  • Restricciones de integración: Confirma los límites de solicitudes, los requisitos de registro, las respuestas de error y las opciones de prueba.
  • Gobernanza de datos: Revisa los controles de acceso, las condiciones de conservación, las responsabilidades contractuales y la información que realmente necesita tu integración.
  • Modelo comercial: Confirma qué se factura, cómo se tratan las solicitudes repetidas y qué ocurre cuando el uso supera la cantidad acordada.

La página de Tracking API de 17TRACK y la documentación oficial de la API son puntos de partida relevantes para evaluar la oferta de API. Utiliza esos recursos para comprobar la integración con tu muestra de envíos y tus requisitos técnicos. Confirma la cobertura del servicio, las condiciones comerciales y los límites operativos antes de comprometerte; esta guía no establece esos detalles para una cuenta o implementación concreta.

En un marketplace personalizado, evalúa la propia integración de la API en lugar de asumir que una página de seguimiento para consumidores o una aplicación de tienda cumplirá los requisitos del backend. La cuestión importante es cómo entrarán los datos de envío en tu modelo de pedidos y cómo activarán acciones controladas.

Cuándo vale la pena implementar una API

Una API de seguimiento se convierte en una inversión más sólida cuando el equipo de soporte consulta repetidamente los sitios web de los transportistas, los compradores no disponen de una vista coherente de sus pedidos o los eventos de envío deben activar flujos de trabajo internos. Es especialmente relevante cuando las comprobaciones manuales de seguimiento se están convirtiendo en una dependencia operativa.

Un marketplace pequeño con una actividad de envíos limitada puede comenzar razonablemente con enlaces de seguimiento validados y un proceso manual documentado. Una API no sustituye unas expectativas claras sobre el despacho del vendedor ni una política de disputas viable. Automatizar un proceso poco claro puede simplemente hacer que las decisiones incoherentes se produzcan más rápido.

Realiza un piloto controlado antes de ampliar el uso. Incluye una entrega normal, un caso sin escaneo de aceptación, una entrega fallida, un trayecto de devolución, actualizaciones duplicadas y un caso entregado pero disputado. Comprueba si cada uno genera el mensaje previsto para el comprador y la acción de soporte correspondiente.

Mide los resultados empresariales además de la entrega técnica. Entre las métricas útiles se incluyen los contactos sobre el estado del envío por pedido enviado, el tiempo de gestión de las investigaciones, la frecuencia de notificaciones duplicadas y la proporción de envíos con datos de hitos utilizables. Define cada métrica antes del lanzamiento y compara grupos de envíos similares. Una respuesta correcta de la API por sí sola no demuestra una mejor experiencia en el marketplace.

Preguntas frecuentes

¿Puede una API de seguimiento demostrar que un vendedor envió el artículo correcto?

No. El seguimiento describe el trayecto informado del paquete, no su contenido. Un evento de aceptación o entrega puede respaldar una cronología del envío, pero la identidad y el estado del artículo requieren otras pruebas.

¿La entrega debería liberar automáticamente el pago del vendedor?

Solo si esa acción es coherente con las políticas del marketplace y los requisitos aplicables. Mantén la lógica de pagos separada de la recepción de datos de seguimiento y proporciona una forma de que las disputas o las condiciones de revisión pausen una acción que, de otro modo, sería automática.

¿Qué debería ocurrir cuando un número de seguimiento no tiene actualizaciones?

Muestra que no hay ninguna actualización del transportista disponible en lugar de inventar avances. Comprueba el número y el transportista, distingue la información electrónica de la etiqueta de la aceptación y sigue las indicaciones del servicio correspondiente antes de clasificar el envío como perdido.

¿Los webhooks son suficientes por sí solos?

Los webhooks pueden admitir actualizaciones basadas en eventos, pero la aplicación sigue necesitando gestión de duplicados, supervisión y procedimientos de recuperación. Cuando el proveedor lo permita, las solicitudes de conciliación pueden ayudar a investigar actualizaciones ausentes o incoherentes.

¿La misma integración puede hacer seguimiento de las devoluciones de los compradores?

Potencialmente, si el transportista y el servicio de devolución son compatibles. Crea un envío de devolución independiente vinculado al pedido original y distingue la entrega al vendedor de la entrega al comprador.

Fuentes

Los recursos oficiales que aparecen a continuación proporcionan los puntos de referencia del producto y de implementación para la evaluación de 17TRACK analizada anteriormente. Las recomendaciones de flujo de trabajo de esta guía son orientación editorial, no declaraciones sobre las políticas de un marketplace concreto ni garantías sobre los resultados de un producto.