Confirmar o envio da Amazon a partir do Odoo: o prazo que lhe exigem e o seguimento que conta

Uma encomenda da Amazon não fica fechada quando o pacote sai do armazém: fica fechada quando a Amazon recebe a confirmação de envio com a sua transportadora e o seu número de seguimento. Até lá, a encomenda continua pendente para a Amazon, ainda que a mercadoria já esteja em distribuição. Esse aviso é uma chamada à API, e é feita pelo seu ERP ou por uma pessoa a copiar números à mão.

O prazo é definido pela Amazon, e é um por encomenda

Cada encomenda chega com a sua data limite de envio. Não é uma recomendação nem um objetivo interno: é o compromisso que a Amazon assumiu com o comprador em seu nome. Essa data tem de viajar da encomenda para a guia de remessa do Odoo e ser visível para quem prepara, porque a ordem que importa no armazém é a das datas limite, não a da chegada. Quem prepara por ordem de entrada chega tarde às encomendas urgentes e cedo às que não tinham pressa.

O que acontece quando confirma tarde

A Amazon mede duas coisas distintas e penaliza-as em separado: os envios confirmados depois da data limite e os seguimentos que não consegue rastrear. Os limiares exatos são publicados pela Amazon no painel Estado da conta da Seller Central e revistos de vez em quando, por isso consulte-os aí e não num artigo. O que é estável é a consequência: a métrica degrada-se, o comprador pode cancelar sem custos e, se a situação se mantiver, a capacidade de vender é restringida.

Em FBA lê-se o estado; em FBM escreve-o você

É a confusão mais habitual. Com FBA não confirma nada: a Amazon prepara e envia, e o número de seguimento nasce no sistema dela, não no seu. O que precisa aí é do caminho inverso: trazer esse estado para o Odoo para que a guia de remessa se feche. Com FBM é ao contrário: o envio é feito por si e o aviso é dado por si, dentro do prazo. Uma operação mista faz as duas coisas sobre o mesmo catálogo, e cada encomenda tem de saber, desde o primeiro momento, de que tipo é.

O código da transportadora decide se o seguimento conta

A Amazon não aceita qualquer texto no campo da transportadora: tem a sua própria lista de códigos e rastreia o envio com base naquele que declarar. Se enviar o número correto com a transportadora errada, ou com uma genérica do tipo «outros», o seguimento existe mas a Amazon não o consegue acompanhar: para efeitos de métrica, é como se não o tivesse enviado. Por isso, a equivalência entre a sua transportadora do Odoo e o código da Amazon tem de ser uma tabela explícita e editável, não um texto escrito à mão dentro do código.

Onde se encontram o conector de transporte e o de marketplace

O ponto de encontro é a guia de remessa. A sequência saudável é esta: a encomenda entra com a sua referência da Amazon e a sua data limite, é preparada, valida-se a guia de remessa, o conector da transportadora pede a etiqueta e devolve o número de seguimento, e só então o conector da Amazon envia a confirmação com esse número e o código correto. Se inverter a ordem, confirma envios que ainda não têm etiqueta. Se não houver ligação entre os dois, alguém copia números à mão e esse alguém engana-se numa terça-feira à tarde.

A falha que mais encontramos ao rever integrações de terceiros está precisamente aí: a confirmação é lançada em segundo plano, falha (erro da API, token caducado, a transportadora demorou a dar o número) e ninguém se apercebe, porque a guia de remessa do Odoo já está validada e a verde. A confirmação tem de deixar rasto na encomenda: enviada, falhada, repetida. Uma tarefa que falha em silêncio é pior do que não ter integração, porque ainda por cima lhe dá confiança.

Uma encomenda, dois pacotes

Os envios parciais são o caso para o qual quase ninguém se prepara. Se uma encomenda sai em duas expedições, a Amazon espera duas confirmações com as suas linhas e quantidades, não uma só com o seguimento do primeiro volume. No Odoo, isso são duas guias de remessa sobre a mesma encomenda de venda, pelo que o mapeamento tem de ser por linha e não por encomenda. Montá-lo bem desde o princípio custa pouco; corrigi-lo depois de ter confirmado mal duzentas encomendas, não.

Quando é preciso automatizar isto e quando não

Se envia dez encomendas por dia e confirma à mão na Seller Central em cinco minutos, não precisa de uma integração para isto: precisa de uma rotina e de um aviso. Automatizar compensa quando copiar números já dá trabalho, quando há várias transportadoras em jogo ou quando o mesmo catálogo é vendido em vários sítios e ninguém sabe o que já saiu. Dizer-lhe o contrário seria vender-lhe algo de que não precisa.

O conector da Amazon para Odoo cobre este percurso: tabela de equivalências de transportadoras, confirmação por linha com número de seguimento, estado do aviso e último erro da Amazon na própria guia de remessa, repetições automáticas e, em FBA, leitura do estado em vez de escrita. Funciona no Odoo 17, 18, 19 e 20. Os conectores de transportadora estão em o catálogo de módulos, e como se montam sem surpresas, em etiquetas e seguimento no Odoo.

Perguntas frequentes

Ligações úteis dentro da FlexigoTech

O que fazemos sobre isto