Lo primero es lo primero: en un caso de solución de problemas de un pedido perdido por la API de etiquetas de envío, el transportista casi nunca perdió tu pedido. Lo que suele ocurrir es que un eslabón de la cadena no lo pasó adelante. El pedido se realizó, se creó el pedido de salida y luego no salió ninguna etiqueta. El paquete queda sobre la mesa de embalaje y el teléfono de atención al cliente empieza a sonar. He visto este fallo exacto tres veces, y la causa raíz fue diferente cada vez, pero la forma de encontrarla es siempre la misma cadena: OMS a WMS a API del transportista a impresora, un segmento a la vez. Localiza primero y luego corrige.

Lo peor de una etiqueta perdida no es la pérdida. Es no saber dónde buscar. El embalador dice que el sistema nunca imprimió una etiqueta. Atención al cliente dice que el pedido está confirmado. TI dice que la API no devolvió ningún error. Los tres tienen razón, porque el pedido está atascado en el hueco entre ellos. La cadena siguiente es cómo encuentras ese hueco.

Localiza primero: qué segmento de la API de etiquetas de envío perdió el pedido

No empieces reiniciando servicios ni volviendo a enviar pedidos. Dedica cinco minutos a localizar el fallo. El pedido está atascado en uno de cuatro segmentos, y cada paso posterior depende de cuál sea.

Comprueba el estado del pedido en el OMS: ¿está confirmado y esperando el envío, o ya se ha enviado al WMS? Si el OMS nunca lo envió, el problema está en las reglas de envío del OMS, no en la API de etiquetas. Luego comprueba si el WMS tiene una tarea de salida para él y si esa tarea está esperando el picking, ya recogida o embalada. Si no hay tarea, el pedido murió entre el OMS y el WMS. Si la tarea existe, se envió la solicitud de etiqueta y no hubo respuesta del transportista, el problema está en el segmento de la API. Si llegó la respuesta, llegó el archivo de etiqueta y la impresora guardó silencio, el problema está en el segmento de impresión.

Localizar significa hacer cuatro preguntas y anotar las respuestas antes de tocar nada: ¿lo envió el OMS? ¿Lo recibió el WMS? ¿Respondió el transportista? ¿Lo imprimió la impresora? El segmento en el que la respuesta se vuelve «no» es donde vive tu problema.

Solución de problemas de pedidos perdidos por la API de etiquetas de envío: el recorrido de cuatro segmentos del pedido al muelle

Segmento uno, del OMS al WMS. El fallo más común aquí es una regla de envío que no cubre un tipo de pedido. Durante una temporada alta, un equipo añade un nuevo tipo de pedido de regalo, la regla de envío nunca lo cubre y el pedido queda en el OMS mientras el WMS nunca se entera. Cómo comprobarlo: busca en el registro de envíos del OMS con el número del pedido perdido. ¿Hay un registro de envío y qué devolvió? Si no hay registro, es un problema de reglas. Un registro con un fallo significa un problema de red o de campo. La red de seguridad: añade reintentos y alertas a los envíos del OMS. Si un envío falla tres veces, avisa a la persona de guardia. Nunca dejes un pedido ahí tirado en silencio.

Segmento dos, dentro del WMS. La tarea existe, el picking está hecho y se atasca en el paso de imprimir la etiqueta. He visto este pozo tres veces, y la causa raíz fue la misma cada vez: antes de que el WMS envíe la solicitud de etiqueta, valida la dirección, el peso y el producto de servicio del transportista. Si alguna de las tres validaciones falla, la solicitud nunca sale y no hay ningún error, solo una pequeña línea en las notas de la tarea. Cómo comprobarlo: abre el detalle de la tarea y mira el panel de validación. La red de seguridad: una validación fallida debe mostrar un aviso visible y escribir una entrada en el registro. El fallo silencioso es el mayor cómplice de una etiqueta perdida.

Segmento tres, la API del transportista. La solicitud salió y la respuesta nunca volvió. Aquí hay dos variantes. Una es un tiempo de espera agotado de la API del transportista. La otra es una respuesta que llegó pero que el WMS no reconoció. Ante un tiempo de espera, primero comprueba a cuántos segundos está fijado el tiempo de espera y luego si es una cola de hora punta. Ante una respuesta no reconocida, el código de estado del transportista no suele coincidir con el código de estado asignado en tu sistema. Cómo comprobarlo: lleva el ID de seguimiento de la solicitud al registro de la API y mira exactamente qué devolvió el transportista. La red de seguridad: reintenta automáticamente una vez ante un tiempo de espera, pero comprueba si ya se generó un número de etiqueta antes de reintentar. Nunca crees dos números de etiqueta para un pedido.

Segmento cuatro, impresora y archivo de etiqueta. El archivo de etiqueta llegó y la impresora no hizo nada, o imprimió y el sistema sigue mostrando el pedido como no enviado. Comprueba primero la cola de la impresora, luego si el formato del archivo de etiqueta es correcto y luego la confirmación de escritura: ¿la impresión correcta se escribió de vuelta en el WMS? Una confirmación de escritura fallida es la más desagradable de las cuatro. El paquete ya ha salido, el sistema sigue diciendo «esperando envío» y el inventario y el estado del pedido están mal los dos. Cómo comprobarlo: compara el registro de la impresora con los registros de envío del sistema. Si las cantidades no coinciden, se perdió una confirmación de escritura. La red de seguridad: no liberes el paquete hasta que la confirmación de escritura confirme el éxito de la impresión. Diez segundos extra en la mesa de embalaje valen más que un sistema que no está de acuerdo con la realidad.

Segmento Síntoma típico Comprueba primero Red de seguridad
OMS a WMS Sin tarea en el WMS Registro de envíos, reglas de tipo de pedido Reintenta tres veces y luego alerta
Dentro del WMS Tarea atascada en imprimir etiqueta Panel de validación de dirección y peso La validación fallida debe avisar y registrar
API del transportista Solicitud enviada, sin respuesta Registro de la API, asignación de códigos de estado Comprueba si hay un número de etiqueta antes de reintentar
Impresora Impreso pero sigue sin enviar Cola de impresión, registros de confirmación de escritura Confirma la escritura antes de liberar

Y aquí está la parte contraintuitiva: con una etiqueta perdida, lo que más hay que temer no es la pérdida. Es el duplicado. En el momento en que la gente ve una etiqueta que falta, pulsa reintentar, vuelve a enviar el pedido y la etiqueta por fin sale, dos veces. Dos números de etiqueta, un pedido. Un paquete se envía, el otro número de etiqueta flota en el sistema. En el mejor de los casos tu inventario está mal. En el peor, el cliente tiene la mercancía en la mano mientras el sistema sigue diciendo «sin enviar» y atención al cliente se viene abajo por segunda vez. Comprueba si ya existe un número de etiqueta antes de reintentar. Esa es la regla de hierro. Diez minutos lentos localizando valen más que tres segundos rápidos volviendo a enviar.

Un cliente mío cambió a una nueva API de transportista la noche antes de una temporada alta y perdió más de doscientas etiquetas el primer día. La causa raíz era vergonzosamente simple: la hora límite de la nueva API era una hora antes que la de la antigua. Los pedidos realizados después de la hora límite se rechazaban directamente y el sistema nunca lanzaba una alerta. Al final el equipo imprimió las etiquetas a mano, una por una, hasta las tres de la mañana. Después de esa noche me hice una regla: nunca cambies una interfaz la noche antes de una temporada alta.

Lista de verificación de la noche de puesta en marcha: repásala antes de dormir

La noche de puesta en marcha no es el momento de las declaraciones de visión. Repasa esta lista y marca cada casilla.

Uno, reglas de envío: ¿están cubiertos todos los tipos de pedido? Haz un pedido real de principio a fin, no solo un pedido de prueba. Dos, reglas de validación: dirección, peso y producto de servicio. Cuando falla la validación, ¿puede alguien ver el aviso? Tres, tiempo de espera y reintento: ¿a cuántos segundos está el tiempo de espera? ¿Cuántos reintentos? ¿Comprueba el reintento primero si ya existe un número de etiqueta? Cuatro, asignación de códigos de estado: cada código de estado que devuelve el transportista, ¿lo reconoce tu sistema? Cinco, confirmación de escritura de impresión: impresora sin conexión, sin papel, atasco de papel, ¿qué hace el sistema en cada caso? Seis, alertas: ¿cuántas etiquetas perdidas, o cuántos minutos atascado, antes de que alguien reciba una llamada? Siete, el plan alternativo: si la API se cae por completo, ¿quién imprime las etiquetas a mano y de dónde salen los números de etiqueta?

Marca las siete antes de dormir. Deja una sin marcar y la llamada de teléfono de medianoche es tuya.

La solución de problemas de pedidos perdidos por la API de etiquetas de envío no es difícil la primera vez que lo haces. Lo difícil es hacerlo igual cada vez, siguiendo la cadena en lugar de adivinar por intuición. Fija el recorrido junto a la mesa de embalaje. La próxima vez que no salga una etiqueta, recorre los cuatro segmentos y la tendrás localizada en diez minutos. Una vez que la ubicación es correcta, la corrección es rápida.

Por Lin Xiao, Consultor de Implementación de WMS Traducido del inglés. En caso de discrepancia, prevalece la versión en inglés.