Primero, la conclusión. En la solución de problemas de etiquetas perdidas en la integración de la API de etiquetas de envío, una etiqueta perdida no es un único fallo. Son cuatro fallos distintos que se ven exactamente igual: la etiqueta nunca se creó, se creó pero la respuesta se perdió, la respuesta llegó pero no se imprimió nada, o se imprimió pero el número de seguimiento nunca regresó. El noventa por ciento de las etiquetas perdidas se pueden localizar en diez minutos con la cadena de cuatro etapas que sigue. Para el diez por ciento restante, acude al transportista o a la plataforma con los registros de solicitudes en la mano, no con una frase vaga como “la etiqueta desapareció”.
He visto este fallo tres veces, y cada vez llevaba un disfraz distinto. El primero fue un almacén de comercio electrónico en un día de ventas punta: más de 40 pedidos sin etiquetas, los embaladores de pie junto a la impresora y los teléfonos de atención al cliente sonando sin parar. La causa raíz fue un reintento por tiempo de espera agotado. La llamada al transportista se agotó, el sistema supuso que la creación había fallado y la envió de nuevo, pero la primera llamada ya había creado la etiqueta. La segunda llamada fue rechazada, el pedido quedó en un estado que nadie gestionaba y nadie pudo imprimirlo. El segundo caso fue un 3PL que perdía etiquetas solo en los pedidos a un país. Dos días de investigación mostraron que a los productos les faltaban los códigos HS, así que el transportista rechazó el envío, y el sistema se tragó el mensaje de error y solo mostró “creación fallida”. El tercer caso fue el más molesto: todas las etiquetas se habían creado correctamente, pero una actualización del controlador de la impresora rompió la impresión, y el equipo pasó medio día culpando a la API.
Por qué todas las etiquetas perdidas se ven igual
Una etiqueta recorre cuatro etapas desde el pedido hasta el paquete. Esa cadena es toda la solución de problemas de etiquetas perdidas en la integración de la API de etiquetas de envío: cuatro etapas, comprobadas en orden, y una etiqueta perdida no puede esconderse. La etapa uno es la creación: el sistema llama a la API del transportista o del agregador con la dirección, el peso y el código de servicio, y recibe un número de seguimiento y un archivo de etiqueta. La etapa dos es la devolución de llamada: la API devuelve éxito o fracaso, y el sistema debe escribir ese resultado en el estado del pedido. La etapa tres es la impresión: el archivo de etiqueta llega a la impresora y se convierte en papel. La etapa cuatro es la devolución de datos: el número de seguimiento regresa al pedido y a la plataforma de ventas para que atención al cliente y el cliente puedan seguirlo.
Si alguna de estas etapas se rompe, el embalador ve lo mismo: este pedido no tiene etiqueta. Así que el primer paso nunca es “hacer clic en crear de nuevo”. Es hacerse tres preguntas: en qué estado está este pedido de nuestro lado, si el transportista tiene este envío y si el archivo está en la cola de impresión. Responde a esas tres y el área de búsqueda se reduce en su mayor parte.
Aquí está la parte contraintuitiva. El primer instinto de la mayoría es reintentarlo, y reintentar es el mayor amplificador de las etiquetas perdidas. Un tiempo de espera agotado no significa que la etiqueta no se haya creado. Es posible que el transportista ya haya generado un número de seguimiento mientras tu lado nunca recibió la respuesta. Envíalo de nuevo y puedes crear un duplicado. Una copia sale en el paquete, la otra queda en el sistema esperando a que alguien la pegue algún día en la caja equivocada, y eso es un paquete mal enviado. Mi regla de hierro es: ante un tiempo de espera agotado, consulta antes de reintentar. Consulta al transportista por la referencia del pedido o el número de seguimiento. Si existe, la creación tuvo éxito y solo se perdió la respuesta, así que recuperas la respuesta en lugar de crear de nuevo.
Paso a paso: sigue la etiqueta perdida por las cuatro etapas
Paso uno, comprueba la creación. Busca la solicitud y la respuesta de este pedido en los registros de la API. ¿Salió la solicitud? ¿Cuál fue el código de respuesta? ¿Qué decía realmente el mensaje de error del transportista, palabra por palabra? Los rechazos habituales son una lista corta: fallo de verificación de dirección, código de servicio no válido, cuenta no habilitada para ese servicio, peso o dimensiones por encima del límite, o un envío transfronterizo al que le falta el código HS o el país de origen. Corrige lo que dice el mensaje. Lo he visto tres veces: alguien trató “fallo de verificación de dirección” como “la API está caída”, reinició el servicio durante horas y nunca cambió ni un solo carácter de la dirección.
Paso dos, comprueba la devolución de llamada. La API devolvió éxito, pero ¿lo escribió tu sistema en la base de datos? Mira en dos lugares: si la devolución de llamada o la ronda de sondeo llegó alguna vez, y si la máquina de estados del pedido se quedó atascada. Algunos sistemas crean las etiquetas de forma asíncrona, así que la etiqueta queda en cola unos minutos antes de que vuelva la devolución de llamada. Los embaladores que no pueden esperar hacen clic en reimprimir, y el estado se tuerce. Mi enfoque es dar a cada pedido un umbral de tiempo de espera explícito. Pasado el umbral sin devolución de llamada, el sistema consulta al transportista automáticamente en lugar de dejar que una persona reintente a mano. Incorpora esa consulta al sistema. No confíes en la memoria.
Paso tres, comprueba la impresión. ¿Llegó el archivo de etiqueta a la impresora? ¿Hay un trabajo atascado en la cola? ¿Se actualizó el controlador recientemente? ¿Coincide el tamaño del papel de etiquetas con la plantilla de etiquetas? La impresión es la etapa que más a menudo se confunde con un problema de la API, porque el embalador solo ve que no salió papel. En cada lista de verificación de la noche de puesta en marcha insisto en una línea: prueba la impresión con un pedido real, no con una página de prueba. Que se imprima una página de prueba no prueba nada sobre una etiqueta real. Con la plantilla o el tamaño de papel equivocados, sigue sin salir nada.
Paso cuatro, comprueba la devolución de datos. La etiqueta se imprimió, pero ¿volvió el número de seguimiento al pedido y a la plataforma? Si esta etapa se rompe, atención al cliente no puede ver el envío, el cliente cree que no se ha enviado nada y llega la reclamación. La devolución de datos suele fallar por los límites de frecuencia de la plataforma o porque alguien cambió el estado del pedido a mano. La solución es un reintento automático tres veces con intervalos crecientes, y después una cola manual para lo que siga fallando. Nunca dejes que desaparezca en silencio.
La lista de verificación de la noche de puesta en marcha: evita la próxima etiqueta perdida
Aquí tienes una comparación de costes por escenario, con las cifras marcadas como ilustrativas. Un almacén que envía 2,000 pedidos al día pierde el 1 por ciento en un día punta, y eso son 20 pedidos. Si solo 5 de ellos son etiquetas duplicadas que acaban pegadas en los paquetes equivocados, las devoluciones, los reenvíos y las reclamaciones cuestan más que varias impresoras nuevas. Con la cadena de rastreo en marcha, el mismo problema se localiza en diez minutos y se recupera en media hora, y la pérdida se limita a reimprimir 20 etiquetas. Repaso estas cuentas con cada cliente antes de la puesta en marcha, y después nadie se atreve a saltarse la lista de verificación.
La noche de la puesta en marcha, marca cada punto con una firma: los reintentos por tiempo de espera agotado consultan al transportista antes de reenviar; los mensajes de error se registran textualmente, no resumidos como “creación fallida”; la verificación de dirección, el código de servicio, los permisos de la cuenta, el peso y las dimensiones, y los códigos HS se han probado cada uno; la devolución de llamada asíncrona tiene un umbral de tiempo de espera y una consulta automática; la impresión se ha probado con un pedido real; los fallos de devolución de datos reintentan y luego caen en una cola manual; y los contactos de soporte del transportista y de la plataforma están publicados en el cuadro de guardia. Una lista de verificación que nadie firma es lo mismo que no tener lista de verificación.
Una última cosa, y aquí no tengo ninguna tolerancia con el lenguaje vago. La próxima vez que alguien te diga “la etiqueta se ha perdido”, responde con cuatro preguntas: ¿se creó?, ¿llegó la respuesta?, ¿salió papel de la impresora? y ¿volvió el número de seguimiento? Responde a esas cuatro y el fallo suele estar mirándote a la cara. La integración de API no tiene ningún misterio. Eso es la solución de problemas de etiquetas perdidas en la integración de la API de etiquetas de envío en su forma más simple: solo hay una cadena, y una etiqueta perdida no puede esconderse cuando la compruebas etapa por etapa.
Por Lin Xiao, Consultor de Implementación de WMS
Traducido del inglés. En caso de discrepancia, prevalece la versión en inglés.







