«As encomendas da Amazon entram sozinhas no Odoo.» Entram, sim. A pergunta útil é outra: entram com tudo o que é preciso para preparar, faturar e acertar contas? Porque o que falha não é a ligação (essa vê-se logo), mas o mapeamento. Uma encomenda mal importada não dá erro: dá uma guia de remessa duplicada em outubro e um IVA que não bate certo em janeiro.
O que traz uma encomenda da Amazon e o que ainda não traz
O cabeçalho traz o identificador da encomenda, a data de compra, o estado, o canal (FBA ou FBM), o mercado em que se vendeu e a data limite de envio. As linhas vêm à parte, com o ASIN, o seu SKU de vendedor, a quantidade, o preço, o imposto e o valor do envio em separado, além dos descontos promocionais. E há um momento em que uma encomenda existe mas ainda não tem nada de útil: enquanto o pagamento não está autorizado, a encomenda aparece pendente, com linhas sem preços nem impostos e sem uma morada aproveitável. Se a sua importação a criar nesse instante, cria uma encomenda incompleta que depois ninguém sabe reparar.
O identificador manda: sem ele, há duplicados
Cada encomenda chega com o seu identificador da Amazon. Esse número tem de ficar guardado na encomenda do Odoo e ser a primeira coisa a consultar antes de criar seja o que for. Se a importação cria primeiro e verifica depois, qualquer nova tentativa (uma falha de rede a meio do ciclo, um cron que se sobrepõe ao anterior, uma sincronização lançada à mão enquanto corria a automática) deixa-o com duas encomendas idênticas e duas guias de remessa. Guarde também o identificador de cada linha: é o que permite reconhecer uma linha modificada sem apagar e recriar a encomenda inteira.
Um pormenor que parece menor e não é: a verificação tem de assentar num índice único na base de dados, e não apenas numa pesquisa prévia em Python. Dois processos que correm em simultâneo podem passar ambos na pesquisa e criar ambos. É uma das falhas que mais vemos ao auditar conectores feitos por outros.
Moradas: chegam restritas e têm de ser apagadas
Os dados do comprador não vêm na leitura normal da encomenda. A morada de envio e o contacto pedem-se à parte, com uma autorização específica para dados restritos, e o e-mail que lhe dão é um alias da Amazon que deixa de funcionar. Além disso, há a obrigação de não os conservar: passado o prazo que a política de proteção de dados da Amazon estabelece, os dados pessoais são apagados, e só se guarda o que a legislação fiscal obriga a conservar. No Odoo, isto tem duas consequências práticas: criar um contacto permanente por cada comprador nem sempre é boa ideia, e é preciso um mecanismo de eliminação que alguém tenha desenhado de propósito, e não um esquecimento.
Impostos: em muitos casos não é você a cobrá-los
Em bastantes mercados é a Amazon que retém e entrega o imposto da venda, e as linhas da encomenda podem indicar quem é o responsável por o fazer. Se a sua importação aplica sempre o mesmo imposto sem olhar para esse dado, a contabilidade sai mal nos dois sentidos possíveis: declarando a mais ou a menos. O que há a montar antes da primeira encomenda é uma posição fiscal por país de destino, uma lista de preços por moeda e uma regra clara para o caso em que o responsável é a Amazon. O pormenor por país está em vender em várias Amazon com um só Odoo.
Cancelamentos: ler só encomendas novas não chega
Uma encomenda pode ser cancelada enquanto estava pendente e, nesse caso, nunca chegou a ser uma encomenda a sério. E pode ser cancelada depois de ter entrado no Odoo e antes de sair do armazém: se a sincronização só sabe criar, o cancelamento não chega e acaba por enviar mercadoria que ninguém vai pagar. A importação tem de reler as encomendas já conhecidas dentro de uma janela de tempo, ordenando por data da última modificação, e não pedir apenas as novas. E se a guia de remessa já está validada, isso já não é cancelar: é devolver, e contabiliza-se como devolução.
O que faz o nosso conector
O conector da Amazon para o Odoo resolve a entrada de encomendas no Odoo 17, 18, 19 e 20: não cria a encomenda de venda enquanto a Amazon a tem pendente, guarda o identificador da Amazon com uma restrição única por conta e reutiliza a encomenda de venda que já exista em vez de a duplicar, conserva o identificador de cada linha, pede a morada de envio numa chamada à parte e relê as encomendas por data da última modificação, de modo que as alterações de estado, incluindo cancelamentos, se refletem na encomenda de venda. Com os impostos não decide por si: por defeito a encomenda entra sem impostos e, se ativar a faturação a partir do Odoo, aplica os do produto através da posição fiscal que configurar. Se o que tem é um conector que já falha, o diagnóstico está em erros frequentes da SP-API com o Odoo, e por vezes a resposta certa é arranjar o que há, e não comprar outro.
Perguntas frequentes
Com que frequência convém importar as encomendas?
Várias vezes por hora é razoável, mas pedindo por data da última modificação, e não o histórico inteiro de cada vez. A API da Amazon tem limites de taxa e um ciclo que pede a mais fica sem quota precisamente quando há um pico de vendas.
Posso importar encomendas antigas?
Sim, com uma carga inicial limitada por datas. Se já tem encomendas criadas à mão, escreva nelas o identificador da Amazon antes de ligar a sincronização: caso contrário, o primeiro ciclo volta a criá-las.
E as encomendas da Amazon Business?
Vêm marcadas como tal e implicam uma fatura com os dados fiscais do comprador. Convém separá-las desde o primeiro dia, porque tratá-las como uma encomenda de particular obriga a refazer faturas mais tarde.
Ligações úteis dentro da FlexigoTech
O que fazemos sobre isto
As encomendas entram, mas não batem certo?
Diga-nos em que mercados vende, se é FBA, FBM ou ambos, e o que não lhe bate certo: duplicados, impostos ou cancelamentos. Vemos o mapeamento antes de propor o que quer que seja. Escreva para comercial@flexigobe.com ou marque uma chamada.

