Primeiro, a conclusão. Na solução de problemas de etiquetas perdidas na integração da API de etiquetas de envio, uma etiqueta perdida não é uma única falha. São quatro falhas diferentes que parecem exatamente iguais: a etiqueta nunca foi criada, foi criada mas a resposta se perdeu, a resposta chegou mas nada foi impresso, ou foi impressa mas o número de rastreamento nunca voltou. Noventa por cento das etiquetas perdidas podem ser localizadas em dez minutos com a cadeia de quatro etapas abaixo. Para os dez por cento restantes, vá ao transportador ou à plataforma com os registros de solicitação em mãos, e não com uma frase vaga como “a etiqueta desapareceu”.
Já vi essa falha três vezes, e cada vez ela usava um disfarce diferente. A primeira foi um armazém de comércio eletrônico em um dia de pico de vendas: mais de 40 pedidos sem etiquetas, os embaladores parados diante da impressora e os telefones do atendimento ao cliente tocando sem parar. A causa raiz foi uma nova tentativa por tempo esgotado. A chamada ao transportador estourou o tempo, o sistema presumiu que a criação havia falhado e a enviou novamente, mas a primeira chamada já havia criado a etiqueta. A segunda chamada foi rejeitada, o pedido ficou em um estado que ninguém gerenciava e ninguém conseguiu imprimi-lo. O segundo caso foi um 3PL que perdia etiquetas apenas nos pedidos para um país. Dois dias de investigação mostraram que faltavam códigos HS aos produtos, então o transportador recusou o envio, e o sistema engoliu a mensagem de erro e exibiu apenas “falha na criação”. O terceiro caso foi o mais irritante: todas as etiquetas haviam sido criadas com sucesso, mas uma atualização do driver da impressora quebrou a impressão, e a equipe passou meio dia culpando a API.
Por que toda etiqueta perdida parece igual
Uma etiqueta percorre quatro etapas do pedido ao pacote. Essa cadeia é toda a solução de problemas de etiquetas perdidas na integração da API de etiquetas de envio: quatro etapas, verificadas em ordem, e uma etiqueta perdida não pode se esconder. A etapa um é a criação: o sistema chama a API do transportador ou do agregador com o endereço, o peso e o código de serviço, e recebe um número de rastreamento e um arquivo de etiqueta. A etapa dois é o retorno de chamada: a API devolve sucesso ou falha, e o sistema precisa registrar esse resultado no status do pedido. A etapa três é a impressão: o arquivo de etiqueta chega à impressora e vira papel. A etapa quatro é a devolução dos dados: o número de rastreamento volta ao pedido e à plataforma de vendas para que o atendimento ao cliente e o cliente possam rastreá-lo.
Se qualquer uma dessas etapas quebra, o embalador vê sempre a mesma coisa: este pedido não tem etiqueta. Então o primeiro passo nunca é “clicar em criar novamente”. É fazer três perguntas: em que estado está este pedido do nosso lado, o transportador tem este envio, e o arquivo está na fila de impressão? Responda a essas três e a área de busca encolhe na maior parte.
Aqui está a parte contraintuitiva. O primeiro instinto da maioria das pessoas é tentar de novo, e tentar de novo é o maior amplificador de etiquetas perdidas. Um tempo esgotado não significa que a etiqueta não foi criada. O transportador pode já ter gerado um número de rastreamento enquanto o seu lado nunca recebeu a resposta. Envie de novo e você pode criar uma duplicata. Uma cópia sai no pacote, a outra fica no sistema esperando alguém colá-la um dia na caixa errada, e isso é um pacote enviado errado. Minha regra de ferro é: diante de um tempo esgotado, consulte antes de tentar de novo. Consulte o transportador pelo número de referência do pedido ou pelo número de rastreamento. Se existir, a criação deu certo e só a resposta se perdeu, então você recupera a resposta em vez de criar de novo.
Passo a passo: rastreie a etiqueta perdida pelas quatro etapas
Passo um, verifique a criação. Encontre a solicitação e a resposta deste pedido nos registros da API. A solicitação saiu? Qual foi o código de resposta? O que a mensagem de erro do transportador realmente dizia, palavra por palavra? As rejeições comuns são uma lista curta: falha na verificação de endereço, código de serviço inválido, conta não habilitada para esse serviço, peso ou dimensões acima do limite, ou um envio internacional sem código HS ou país de origem. Corrija o que a mensagem diz. Já vi isso três vezes: alguém tratou “falha na verificação de endereço” como “a API está fora do ar”, reiniciou o serviço por horas e nunca mudou um único caractere do endereço.
Passo dois, verifique o retorno de chamada. A API devolveu sucesso, mas o seu sistema o registrou no banco de dados? Olhe em dois lugares: se o retorno de chamada ou a rodada de consulta chegou alguma vez, e se a máquina de estados do pedido travou. Alguns sistemas criam etiquetas de forma assíncrona, então a etiqueta fica na fila por alguns minutos antes de o retorno de chamada voltar. Os embaladores que não conseguem esperar clicam em reimprimir, e o estado sai do eixo. Minha abordagem é dar a cada pedido um limite de tempo explícito. Passado o limite sem retorno de chamada, o sistema consulta o transportador automaticamente em vez de deixar uma pessoa tentar de novo à mão. Incorpore essa consulta ao sistema. Não confie na memória.
Passo três, verifique a impressão. O arquivo de etiqueta chegou à impressora? Há um trabalho preso na fila? O driver foi atualizado recentemente? O tamanho do papel de etiquetas corresponde ao modelo de etiqueta? A impressão é a etapa mais frequentemente confundida com um problema de API, porque o embalador só vê que não saiu papel. Em cada lista de verificação da noite de entrada em produção, insisto em uma linha: teste a impressão com um pedido real, não com uma página de teste. Uma página de teste imprimir não prova nada sobre uma etiqueta real. Com o modelo ou o tamanho de papel errado, continua não saindo nada.
Passo quatro, verifique a devolução dos dados. A etiqueta foi impressa, mas o número de rastreamento voltou ao pedido e à plataforma? Se essa etapa quebra, o atendimento ao cliente não consegue ver o envio, o cliente acha que nada foi enviado e a reclamação chega. A devolução dos dados geralmente falha por limites de taxa da plataforma ou porque alguém mudou o status do pedido à mão. A correção é uma nova tentativa automática três vezes com intervalos crescentes, e depois uma fila manual para o que continuar falhando. Nunca deixe desaparecer em silêncio.
A lista de verificação da noite de entrada em produção: impeça a próxima etiqueta perdida
Aqui está uma comparação de custos por cenário, com os valores marcados como ilustrativos. Um armazém que envia 2,000 pedidos por dia perde 1 por cento em um dia de pico, e isso são 20 pedidos. Se apenas 5 deles forem etiquetas duplicadas coladas nos pacotes errados, as devoluções, os reenvios e as reclamações custam mais do que várias impressoras novas. Com a cadeia de rastreamento em vigor, o mesmo problema é localizado em dez minutos e recuperado em meia hora, e a perda para na reimpressão de 20 etiquetas. Eu percorro essa conta com cada cliente antes da entrada em produção, e depois disso ninguém ousa pular a lista de verificação.
Na noite da entrada em produção, marque cada item com uma assinatura: as novas tentativas por tempo esgotado consultam o transportador antes de reenviar; as mensagens de erro são registradas literalmente, não resumidas como “falha na criação”; a verificação de endereço, o código de serviço, as permissões da conta, o peso e as dimensões, e os códigos HS foram testados cada um; o retorno de chamada assíncrono tem um limite de tempo e uma consulta automática; a impressão foi testada com um pedido real; as falhas de devolução de dados tentam de novo e depois caem em uma fila manual; e os contatos de suporte do transportador e da plataforma estão afixados na escala de plantão. Uma lista de verificação que ninguém assina é o mesmo que não ter lista de verificação.
Uma última coisa, e aqui não tenho nenhuma tolerância com linguagem vaga. Da próxima vez que alguém lhe disser “a etiqueta se perdeu”, responda com quatro perguntas: ela foi criada, a resposta chegou, saiu papel da impressora, e o número de rastreamento voltou? Responda a essas quatro e a falha geralmente está olhando para você. A integração de API não tem mistério nenhum. Isso é a solução de problemas de etiquetas perdidas na integração da API de etiquetas de envio na sua forma mais simples: só existe uma cadeia, e uma etiqueta perdida não pode se esconder quando você a verifica etapa por etapa.
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.







