Tínhamos um cliente, um vendedor de artigos para o lar sediado no leste da China, cujos pedidos da Alemanha e da França tinham acabado de começar a crescer no outono passado. Eles correram para ligar a API de uma transportadora europeia ao seu sistema de armazém. O representante de vendas jurou que a interface era padrão e estaria no ar em duas semanas. Na primeira semana após o lançamento, 11 de 47 pedidos voltaram na etapa de validação de endereço. A caixa de entrada do suporte explodiu, e a equipe do armazém passou os dias ligando para os clientes um por um para conferir endereços a partir de etiquetas impressas. Aquela semana me ensinou algo que tenho visto repetidamente desde então: integrar raramente é difícil por causa do código. É difícil porque os detalhes que todos presumiam resolvidos nunca foram de fato discutidos.
Os clientes cometem o mesmo erro repetidamente. Tratam "recebemos a documentação da API" como se fosse "a integração está pronta". Documentação é documentação. Estar no ar é outra coisa completamente diferente, e três lacunas ficam no meio: endereços, documentação de taxas e etiquetas de devolução. Cada armadilha abaixo foi paga com tickets reais de reclamação.
Acerte os endereços antes de tocar na API de uma transportadora europeia
Os formatos de endereço europeus não funcionam como a maioria dos vendedores espera. Cada transportadora europeia publica suas próprias peculiaridades de validação, e a única medida segura é testá-las antes do lançamento. Onde vai o número da casa, como andares e escadas são escritos e como os códigos postais são estruturados variam por país. Alguns colocam o número depois do nome da rua, outros antes, e outros querem a escada e o andar como campos separados. Se a sua página de checkout oferece uma única caixa grande de texto livre para o endereço, os clientes digitarão o que parecer natural, e no momento em que a interface dividir essa string, o número da casa pode simplesmente desaparecer.
Nosso cliente de artigos para o lar aprendeu isso da maneira mais cara. Um lote com destino a Munique tinha nomes de ruas e números comprimidos em um único campo. A interface dividiu pelos espaços, o número sumiu, e as encomendas chegaram endereçadas a uma rua inteira. Os motoristas não encontravam a porta, então as encomendas voltaram. A reentrega custou tempo, e um cliente deixou uma avaliação dizendo que nem sequer acertávamos um endereço. Depois disso mudamos três coisas, e as falhas de endereço praticamente desapareceram. Primeiro, a página de checkout separa rua, número, andar e código postal em campos distintos, para que os clientes não possam improvisar. Segundo, o sistema de armazém guarda tanto o endereço original do cliente quanto a versão padronizada, de modo que, quando algo dá errado, dá para ver de relance em qual etapa os dados se perderam. Terceiro, antes do lançamento passamos três meses de endereços históricos reais pela validação e corrigimos as regras a partir das falhas, em vez de usar pedidos em produção como dados de teste.
A negociação também importa aqui. Peça duas coisas e consiga que fiquem por escrito no anexo do contrato: a lista completa de códigos de erro da interface de validação de endereço e as regras de formato de endereço por país. Um representante que diz "nós suportamos tudo" numa ligação não ajuda em nada quando o único erro que você recebe é uma falha genérica e seus desenvolvedores não têm por onde começar a depurar.
Documentação de taxas de transportadoras europeias: um campo errado e sua remessa trava
A documentação de taxas se resume a três perguntas que precisam ser resolvidas primeiro: quem é responsável pela declaração, em que base o valor declarado é calculado e quais detalhes de identificação os documentos devem conter. Quanto a alíquotas e limites específicos, as políticas mudam de tempos em tempos, então siga sempre a orientação oficial mais recente publicada nos sites da transportadora e das autoridades. Nunca fixe no seu sistema como valor fixo um número que um vendedor mencionou de passagem. Já vimos um cliente congelar uma alíquota antiga no código e, quando a política mudou, todas as declarações do lote estavam erradas. Corrigir isso levou mais tempo do que a integração original.
Nesta primavera, um vendedor de pequenos eletrodomésticos de Xangai bateu na mesma parede. Seus produtos eram enviados diretamente de um armazém nacional para consumidores europeus, e o sistema deixou de fora um item de identificação. Todo o lote ficou parado no desembaraço aduaneiro por quase uma semana. Nada foi perdido, mas os clientes ficaram impacientes, os cancelamentos subiram, e o suporte passou dias pedindo desculpas. A análise posterior foi desconfortável: o problema não era a transportadora europeia, era a nossa própria lista de verificação de saída, que nunca incluía aquele item. Desde então acrescentamos uma verificação de três pontos antes de qualquer pedido europeu imprimir uma etiqueta: o valor declarado está preenchido, as informações de identificação estão presentes e o tipo de destinatário confere? Os três em verde, ou o pedido para. Melhor atrasar o despacho em meio dia do que deixar a mercadoria travada na alfândega.
A folha de cotação precisa da mesma clareza. Deixe por escrito se as taxas são pré-pagas ou pagas na entrega, quem acompanha uma exceção de desembaraço, com que rapidez esse acompanhamento acontece e quem paga o frete de devolução. Se essas linhas faltarem, a primeira exceção vira um jogo de culpa, e o cliente só lembrará do representante dizendo "nós cobrimos tudo isso".
Etiquetas de devolução: obtenha-as da sua transportadora europeia com antecedência
A maioria das integrações só fala do envio de saída. As devoluções só são lembradas depois do lançamento, e isso é tarde demais. Os consumidores europeus devolvem produtos rotineiramente. Se o número da etiqueta de devolução não puder ser gerado com antecedência e devolvido junto com o pedido de saída, seu armazém receberá encomendas devolvidas que não conseguirá identificar. Nosso cliente de artigos para o lar descobriu isso durante a temporada de devoluções do ano passado. Chegaram encomendas com nada além de um código de devolução na etiqueta, sem pedido original correspondente no sistema, e o armazém as empilhou num canto para conferência manual. Levou duas semanas para limpar a pilha.
A abordagem certa é simples: quando a interface de saída devolve sua resposta, ela também deve devolver o número da etiqueta de devolução e uma forma de baixar a etiqueta, registrados contra o pedido. Quando o cliente clica em devolver, o sistema envia a etiqueta na hora, sem necessidade de nova solicitação. Na negociação com uma transportadora europeia, fixe três pontos: por quanto tempo uma etiqueta de devolução permanece válida, quem paga pela etiqueta e se etiquetas não utilizadas são reembolsadas. Parecem pequenos, mas em volume somam dinheiro de verdade.
Aqui vai mais uma verdade direta do lado de vendas: não negocie apenas pelo preço da etiqueta. Um preço de etiqueta barato não significa nada se a validação de endereço é descuidada, as exceções de desembaraço ficam sem resposta e as etiquetas de devolução trazem cobranças extras. O que você economizou na tarifa volta em horas de suporte e de armazém. A comparação real é quem assume a responsabilidade quando algo dá errado e com que rapidez corrige. Quando você fala assim, o outro lado sabe que não está diante de um novato olhando uma tabela de preços.
Então aqui está o modelo de decisão que entrego aos clientes, três níveis de profundidade de integração. Escolha pelo seu volume de pedidos e pela capacidade da sua equipe, e não pegue o nível completo no primeiro dia só porque parece impressionante:
| Profundidade | O que cobre | Esforço para lançar | Ideal para | | Básica | Enviar conhecimentos, obter etiquetas, receber rastreamento | Alguns dias | Equipes que estão começando e precisam que a cadeia funcione | | Avançada | Acrescenta validação de endereço e campos de declaração de taxas | De uma a duas semanas | Equipes com volume europeu estável e alguém para assumir | | Completa | Acrescenta geração antecipada de etiquetas de devolução e alertas automáticos de exceção | De duas a três semanas | Equipes com muitas devoluções e pressão real de suporte |
E aqui está o julgamento contraintuitivo ao qual a maioria resiste: uma API no ar não é uma integração funcionando, e a parte mais cara nunca é a taxa de desenvolvimento. São as duas semanas de apagar incêndios manualmente após o lançamento. Endereços devolvidos, desembaraços travados, devoluções não identificadas — cada um desses casos custa à equipe de suporte e de armazém meia hora ou mais para resolver. O nível básico parece barato até o volume crescer, e aí as horas de apagar incêndios já custaram mais do que o tempo de desenvolvimento economizado. Meu conselho: comece no básico enquanto o volume é pequeno e faça a cadeia funcionar, mas migre para o nível avançado assim que o volume europeu estabilizar. Não fique oscilando entre níveis.
Da próxima vez que você se sentar para negociar um contrato, faça estas três perguntas. Primeira, os códigos de erro de validação de endereço e as regras de formato por país podem ir para o anexo? Segunda, a lista de campos da declaração de taxas e o prazo de tratamento de exceções podem ser detalhados por escrito? Terceira, o número da etiqueta de devolução pode voltar com o pedido de saída, e como são tratadas as taxas e a validade das etiquetas? Faça as três, e o outro lado saberá que está lidando com alguém de dentro — e o enchimento da cotação geralmente começa a encolher sozinho.
Por Susan, Diretora de Vendas 3PL
Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.







