Sem departamento de TI? Integração CSV/SFTP para pequenos clientes 3PL

Deixe-me contar uma coisa. Depois de todos esses anos na estrada, o que eu mais temo não é o trânsito. É um pedido errado — especialmente quando o Excel de um pequeno cliente entra errado no WMS.

Em outubro passado, eu estava na fila de um armazém 3PL em Ontario, esperando para ser descarregado. Eu transportava pequenos eletrodomésticos, umas quatrocentas caixas, coletadas perto dos portos de Long Beach e com destino a um ponto de distribuição em Las Vegas. O remetente era um pequeno empresário, sete pessoas no total, e ele era o próprio departamento de TI — o Excel era tudo o que ele tinha. Toda tarde ele exportava os pedidos do dia para o Excel, enviava por e-mail para o armazém, e algum garoto lá digitava cada linha no WMS à mão.

Naquele dia, tudo explodiu. Um SKU na planilha era HD-2204B. O dedo do garoto escorregou e ele digitou HD-2204D. Uma letra de diferença. Quando cheguei a Las Vegas, o recebedor conferiu os números dos modelos e rejeitou a carga inteira. Levei quatrocentas caixas de volta. Mais de quinhentas milhas de ida e volta, dois dias perdidos, quase mil dólares em diesel queimado à toa. O dono gritou com o gerente do armazém pelo telefone. O gerente disse que estavam com falta de pessoal, que erros acontecem. O dono disse que só envia algumas dezenas de pedidos por dia e mesmo assim eles não conseguem digitá-los direito. A transportadora absorveu metade do frete. Engolimos o prejuízo.

A questão é a seguinte: um pequeno cliente sem TI não é preguiçoso. Ele realmente não tem ninguém. Se o seu 3PL o trata como um incômodo, ele vai atravessar a rua para outro armazém. Mas se você cuidar dele, ele lhe dará dezenas de milhares de caixas por ano, regular como um relógio.

Sem equipe de TI? Este manual de integração CSV/SFTP funciona

Cheguei a conhecer bem aquele gerente de armazém nos almoços. Ele me disse que metade de seus vinte e poucos clientes eram "clientes de Excel". Os grandes têm EDI e APIs — integra uma vez, esquece por um ano. Os pequenos? Excel hoje, uma captura de tela de chat amanhã, uma ligação telefônica no dia seguinte. Ele tentou colocá-los em integrações por API. Metade deles nem sabia o que era uma API.

Então eles elaboraram um conjunto de métodos de baixa tecnologia — um manual de integração CSV SFTP WMS em linguagem simples para clientes sem equipe de TI — e, honestamente, achei brilhante. Agora, a terminologia de TI de vocês está além de mim. Vou explicar do jeito que um motorista explicaria.

Método um: um modelo CSV travado.

Pense no CSV como o "Salvar como" do Excel. O armazém envia a cada pequeno cliente um modelo de pedido fixo: quais colunas, em que ordem, datas em que formato, quantidades devem ser números. Tudo congelado. Nenhuma vírgula pode mudar. O cliente preenche essa planilha todos os dias e a envia.

Aquele armazém tinha um truque que eu adorava: a primeira linha não são cabeçalhos, é um exemplo já preenchido. O dono apenas copia o padrão. Difícil errar. Quando o arquivo chega, o WMS o verifica automaticamente primeiro — uma letra na coluna de quantidade, uma data como "10/5" em vez de "2026-10-05", e o arquivo inteiro volta com uma nota em linguagem simples indicando a linha com problema.

Quando digitavam à mão, um garoto digitava algumas centenas de linhas por dia, e os erros aumentavam a cada hora depois do almoço. Agora uma importação CSV leva cinco minutos, e quaisquer erros são erros de digitação do cliente — a responsabilidade é cristalina.

Método dois: coleta programada por SFTP. Deixe o arquivo voar sozinho.

Alguns clientes nem se dão ao trabalho de enviar o e-mail todos os dias. Pense no SFTP como uma caixa de depósito de arquivos trancada: o armazém dá uma conta ao cliente, o cliente deixa o CSV na caixa toda noite, e o WMS o busca conforme um cronograma — digamos, às 2 AM — verifica e importa. Quando o turno começa de manhã, os pedidos já estão no sistema.

Este é perfeito para o gerente de escritório que faz upload como um relógio às 4 PM todos os dias. Ninguém vigia. O arquivo voa sozinho, e o sistema grita se um faltar. Conheço um pequeno cliente de autopeças em Rancho Cucamonga cuja gerente de escritório nunca perdeu um upload das 4 PM. Três meses seguidos, zero erros. Ela me disse que agora sai às 4:05 para buscar o filho.

Método três: análise de anexos de e-mail, o último recurso.

Sempre há um ou dois clientes que esquecem a senha do SFTP toda semana e ainda assim não conseguem preencher o modelo direito. Pare de lutar contra eles: configure uma caixa de entrada dedicada, exija "pedidos + data" no assunto, e deixe o WMS varrer essa caixa com um temporizador, pegar o anexo, analisá-lo e importá-lo. Se eles conseguem enviar um e-mail, estão integrados.

Eis a comparação honesta:

E aqui vai a opinião contrária: para pequenos clientes, pule a API. Um modelo CSV congelado dá mais tranquilidade do que uma API. APIs parecem sofisticadas, mas não há ninguém do lado do cliente para mantê-las. Funciona hoje; no mês que vem ele muda o e-mail, redefine uma senha, a conexão quebra, e você manda alguém consertar. O CSV é feio, mas não depende de ninguém do outro lado. Se o formato do arquivo está certo, entra. Se está errado, volta. A responsabilidade é limpa. Depois de tantos anos dirigindo, acredito em uma coisa: menos peças, menos quebras.

A armadilha do mapeamento de campos CSV: nomes de coluna que mudam todo dia

Baixa tecnologia não significa sem armadilhas. A maior armadilha é o mapeamento de campos — em palavras simples, os nomes das colunas da planilha do cliente não correspondem aos nomes dos campos no WMS.

O pior cliente que já vi: na segunda-feira a coluna era "Item#", na quarta "SKU", na sexta as palavras em chinês para "número do produto". A importação combinava por nome de coluna, então uma única renomeação transformou o arquivo inteiro em brancos. Dezenas de pedidos ficaram presos fora do sistema, caminhões parados no portão. Uma vez fiquei sentado lá quatro horas por causa disso.

O gerente me ensinou três soluções, e cada uma delas é sólida:

Primeiro, uma tabela de tradução. Mantenha um mapeamento no sistema: o "Item#", o "SKU" e o "número do produto" do cliente traduzem-se todos para o sku_code do sistema. Deixe o cliente chamá-lo como quiser, desde que esteja na tabela. Quando um cliente novo chega, passe meio dia registrando cada nome de coluna dos arquivos antigos dele.

Segundo, regras de validação rígidas. A coluna de quantidade deve ser um número. A coluna de data deve parecer 2026-10-05. A coluna SKU não pode estar vazia. Uma falha e o arquivo inteiro volta — nenhuma linha entra. Melhor atrasar meia hora do que deixar dados sujos entrarem no prédio. Uma vez que os dados sujos estão dentro, a remessa inteira sai errada.

Terceiro, três dias de revisão manual em qualquer modelo novo. Na primeira vez que um cliente usa um modelo novo, ou muda um nome de coluna, um humano confere cada linha por três dias. Confirme que o mapeamento está certo e depois ative a importação automática. Não pule isso. Esses três dias economizam três meses apagando incêndios.

Concilie uma vez por dia. Nunca deixe para a noite.

Um último truque, a arma secreta do gerente: quinze minutos antes de encerrar o expediente, concilie o dia.

Conte os pedidos expedidos no WMS em comparação com os pedidos no arquivo do cliente. Se os números não baterem, ninguém vai para casa até saber por quê. O arquivo não foi importado? Foi importado mas não expedido? O cliente enviou o arquivo duas vezes? Quinze minutos, todos os dias, sem exceção.

Não subestime esses quinze minutos. Já vi muitas brigas de fim de mês: o cliente diz cem pedidos, o armazém diz noventa e oito, ninguém consegue provar que os outros dois foram expedidos, e eles dividem o prejuízo. Concilie diariamente e os problemas surgem no mesmo dia em que nascem. O fim de mês vira formalidade.

Um conselho aos colegas 3PL: não tratem pequenos clientes como dor de cabeça. Grandes clientes são bons, mas seus contratos se renovam a cada três anos, e perder um quebra ossos. Pequenos clientes, um por um, parecem pouco impressionantes, mas empilhados juntos são a sua base. Acerte o modelo CSV, a coleta SFTP e a conciliação diária, e os pequenos clientes funcionarão melhor do que os grandes — uma pessoa do lado dele, quase ninguém necessário do seu.

Há um velho ditado: errar por um fio, errar por uma milha. Uma letra errada em um SKU me custou quinhentas milhas vazias. Faça a papelada direito, e o caminhão roda direito. Essa verdade vale na estrada, e vale dentro do armazém também.

Por Shifu Zhao, Veterano do transporte rodoviário (15 anos)

Traduzido do inglês. Em caso de divergência, prevalece a versão em inglês.