Primeiro o essencial: em um caso de solução de problemas de pedido perdido pela API de etiquetas de envio, a transportadora quase nunca perdeu o seu pedido. O que geralmente aconteceu é que um elo da cadeia não o repassou adiante. O pedido foi feito, o pedido de saída foi criado e então nenhuma etiqueta saiu. O pacote fica sobre a bancada de embalagem e o telefone do atendimento ao cliente começa a tocar. Já vi essa falha exata três vezes, e a causa raiz foi diferente a cada vez, mas a forma de encontrá-la é sempre a mesma cadeia: OMS para WMS para API da transportadora para impressora, um segmento de cada vez. Localize primeiro e depois corrija.

A pior parte de uma etiqueta perdida não é a perda. É não saber onde procurar. O embalador diz que o sistema nunca imprimiu uma etiqueta. O atendimento ao cliente diz que o pedido está confirmado. A TI diz que a API não devolveu nenhum erro. Os três têm razão, porque o pedido está preso no vão entre eles. A cadeia abaixo é como você encontra esse vão.

Localize primeiro: qual segmento da API de etiquetas de envio perdeu o pedido

Não comece reiniciando serviços nem reenviando pedidos. Dedique cinco minutos a localizar a falha. O pedido está preso em um de quatro segmentos, e cada passo depois disso depende de qual seja.

Verifique o status do pedido no OMS: ele está confirmado e aguardando envio, ou já foi enviado ao WMS? Se o OMS nunca o enviou, o problema está nas regras de envio do OMS, não na API de etiquetas. Depois verifique se o WMS tem uma tarefa de saída para ele e se essa tarefa está aguardando picking, já separada ou embalada. Sem tarefa significa que o pedido morreu entre o OMS e o WMS. Tarefa existe, solicitação de etiqueta enviada, nenhuma resposta da transportadora: o problema está no segmento da API. Resposta recebida, arquivo de etiqueta chegou, impressora silenciosa: o problema está no segmento de impressão.

Localizar significa fazer quatro perguntas e anotar as respostas antes de tocar em qualquer coisa: o OMS enviou? O WMS recebeu? A transportadora respondeu? A impressora imprimiu? O segmento em que a resposta vira não é onde mora o seu problema.

Solução de problemas de pedido perdido pela API de etiquetas de envio: o percurso de quatro segmentos do pedido ao cais

Segmento um, do OMS ao WMS. A falha mais comum aqui é uma regra de envio que não cobre um tipo de pedido. Durante uma alta temporada, uma equipe adiciona um novo tipo de pedido para presente, a regra de envio nunca o cobre e o pedido fica no OMS enquanto o WMS nunca fica sabendo. Como verificar: pesquise o log de envios do OMS com o número do pedido perdido. Há um registro de envio e o que ele devolveu? Nenhum registro significa um problema de regra. Um registro com falha significa um problema de rede ou de campo. A rede de segurança: adicione novas tentativas e alertas aos envios do OMS. Se um envio falhar três vezes, chame a pessoa de plantão. Nunca deixe um pedido parado ali em silêncio.

Segmento dois, dentro do WMS. A tarefa existe, o picking está feito e ela trava no passo de imprimir a etiqueta. Já vi esse buraco três vezes, e a causa raiz foi a mesma a cada vez: antes de o WMS enviar a solicitação de etiqueta, ele valida o endereço, o peso e o produto de serviço da transportadora. Se qualquer uma das três validações falhar, a solicitação nunca sai e não há nenhum erro, apenas uma pequena linha nas notas da tarefa. Como verificar: abra o detalhe da tarefa e olhe o painel de validação. A rede de segurança: uma validação com falha deve exibir um aviso visível e escrever uma entrada no log. A falha silenciosa é a maior cúmplice de uma etiqueta perdida.

Segmento três, a API da transportadora. A solicitação saiu e a resposta nunca voltou. Há dois tipos aqui. Um é um tempo limite estourado da API da transportadora. O outro é uma resposta que voltou, mas que o WMS não reconheceu. Para um tempo limite, primeiro verifique em quantos segundos o tempo limite está definido e depois se é fila em horário de pico. Para uma resposta não reconhecida, o código de status da transportadora geralmente não corresponde ao código de status mapeado no seu sistema. Como verificar: leve o ID de rastreamento da solicitação ao log da API e veja exatamente o que a transportadora devolveu. A rede de segurança: tente novamente automaticamente uma vez em caso de tempo limite, mas verifique se um número de etiqueta já foi gerado antes de tentar de novo. Nunca crie dois números de etiqueta para um pedido.

Segmento quatro, impressora e arquivo de etiqueta. O arquivo de etiqueta chegou e a impressora não fez nada, ou imprimiu e o sistema continua mostrando o pedido como não enviado. Verifique primeiro a fila da impressora, depois se o formato do arquivo de etiqueta está correto e depois o retorno da escrita: a impressão bem-sucedida foi escrita de volta no WMS? Um retorno de escrita com falha é o mais cruel dos quatro. O pacote já saiu, o sistema continua dizendo aguardando envio, e o estoque e o status do pedido estão errados os dois. Como verificar: compare o log da impressora com os registros de envio do sistema. Se as contagens não baterem, um retorno de escrita foi perdido. A rede de segurança: não libere o pacote até que o sucesso da impressão seja confirmado pelo retorno da escrita. Dez segundos a mais na bancada de embalagem valem mais do que um sistema que discorda da realidade.

Segmento Sintoma típico Verifique primeiro Rede de segurança
OMS para WMS Sem tarefa no WMS Log de envios, regras de tipo de pedido Tente três vezes e depois alerte
Dentro do WMS Tarefa travada em imprimir etiqueta Painel de validação de endereço e peso A validação com falha deve avisar e registrar
API da transportadora Solicitação enviada, sem resposta Log da API, mapeamento de códigos de status Verifique se há um número de etiqueta antes de tentar de novo
Impressora Impresso, mas continua não enviado Fila de impressão, registros de retorno de escrita Confirme o retorno da escrita antes de liberar

E aqui está a parte contraintuitiva: com uma etiqueta perdida, o que mais se deve temer não é a perda. É a duplicata. No momento em que as pessoas veem uma etiqueta faltando, apertam tentar de novo, reenviam o pedido e a etiqueta finalmente sai, duas vezes. Dois números de etiqueta, um pedido. Um pacote é enviado, o outro número de etiqueta flutua no sistema. Na melhor das hipóteses, o seu estoque está errado. Na pior, o cliente está com a mercadoria em mãos enquanto o sistema continua dizendo não enviado, e o atendimento ao cliente desmorona pela segunda vez. Verifique se já existe um número de etiqueta antes de tentar de novo. Essa é a regra de ferro. Dez minutos lentos localizando valem mais do que três segundos rápidos reenviando.

Um cliente meu migrou para uma nova API de transportadora na noite anterior a uma alta temporada e perdeu mais de duzentas etiquetas no primeiro dia. A causa raiz era embaraçosamente simples: o horário limite da nova API era uma hora mais cedo do que o da antiga. Os pedidos feitos após o horário limite eram rejeitados na hora, e o sistema nunca disparou um alerta. No fim, a equipe imprimiu as etiquetas à mão, uma por uma, até as três da manhã. Depois daquela noite, criei uma regra: nunca migre uma interface na noite anterior a uma alta temporada.

Lista de verificação da noite de lançamento: passe por ela antes de dormir

A noite de lançamento não é hora de declarações de visão. Passe por esta lista e marque cada item.

Um, regras de envio: todos os tipos de pedido estão cobertos? Execute um pedido real de ponta a ponta, não apenas um pedido de teste. Dois, regras de validação: endereço, peso e produto de serviço. Quando a validação falha, alguém consegue ver o aviso? Três, tempo limite e nova tentativa: em quantos segundos está o tempo limite? Quantas novas tentativas? A nova tentativa verifica primeiro se já existe um número de etiqueta? Quatro, mapeamento de códigos de status: cada código de status que a transportadora devolve, o seu sistema reconhece? Cinco, retorno de escrita da impressão: impressora offline, sem papel, atolamento de papel, o que o sistema faz em cada caso? Seis, alertas: quantas etiquetas perdidas, ou quantos minutos parado, antes de alguém receber uma ligação? Sete, o plano alternativo: se a API cair por completo, quem imprime as etiquetas à mão e de onde vêm os números de etiqueta?

Marque os sete antes de dormir. Deixe um sem marcar e a ligação telefônica da meia-noite é sua.

A solução de problemas de pedido perdido pela API de etiquetas de envio não é difícil na primeira vez que você faz isso. A parte difícil é fazer do mesmo jeito todas as vezes, seguindo a cadeia em vez de adivinhar no feeling. Fixe o passo a passo ao lado da bancada de embalagem. Da próxima vez que uma etiqueta não sair, desça pelos quatro segmentos e você a terá localizada em dez minutos. Com a localização certa, a correção é rápida.

Por Lin Xiao, Consultor de Implementação de WMS Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.