O que o Amazon Connector acrescenta ao picking de Inventário: campos, botão e quando atua

O que o módulo acrescenta ao picking

O módulo amplia o picking padrão da app Inventário (Inventory) com um botão e um grupo de campos. A condição que mostra ou oculta o botão é a mesma no Odoo 17, 18, 19 e 20.

Na ficha do picking, dentro do grupo Amazon SP-API, o módulo acrescenta estes campos:

• Conta Amazon SP-API (Amazon SP-API Account): a conta SP-API associada ao picking.
• ID da Encomenda Amazon (Amazon Order ID): o identificador da encomenda na Amazon.
• Estado de sincronização Amazon (Amazon Sync State): só leitura. Os seus valores são Pendente (Pending), Sincronizado (Synced) e Erro; por defeito é Pendente. Quem o escreve é o código, não você.
• Última Sincronização Amazon (Last Amazon Sync): data e hora, só leitura.
• Seguimento enviado para a Amazon (Tracking sent to Amazon): só leitura.
• confirmShipment da Amazon enviado em (Amazon confirmShipment sent at): data e hora, só leitura. A sua ajuda explica que, uma vez marcado, o envio automático não se repete nem ao editar o seguimento nem numa nova tentativa da tarefa agendada; só um envio manual forçado o pode reenviar.
• Último erro Amazon (Last Amazon error): texto, só leitura.
• Conteúdo Amazon (Payload Amazon) e Resposta da Amazon (Amazon Response): só leitura, e só os veem os utilizadores com permissão de administração das Definições.

O grupo inteiro oculta-se se o módulo não identificar um ID de encomenda da Amazon para esse picking. Para o procurar, olha primeiro o campo ID da Encomenda Amazon do próprio picking, depois a encomenda de venda associada e, por fim, outros dados do picking. O botão Enviar tracking Amazon também se oculta se o picking não estiver no estado Concluído (Done) ou não for de uma encomenda da Amazon.

Passo a passo: quando atua o módulo e o que fazer

1. Revise as três caixas da conta. Estão na ficha de Contas (Accounts), no separador Encomendas e Expedição (Orders & Fulfillment), dentro do grupo Sincronização de Encomendas (Order Sync). Sincronização automática na validação do picking (Auto sync on picking validation) e Sincronização automática ao alterar o tracking vêm ativadas por defeito; Enviar confirmShipment de forma assíncrona (via cron) (Send confirmShipment asynchronously (via cron)) vem desativada. Cada campo da conta está explicado em os campos da conta SP-API.
2. Crie o picking. Ao criá-lo, o módulo tenta identificar a encomenda da Amazon e, se conseguir, preenche ID da Encomenda Amazon e Conta Amazon SP-API quando estiverem vazios. Para a conta usa a do picking ou a da encomenda de venda se estiver ativa; se não, procura as contas ativas da empresa e, se houver uma só, usa-a. Se houver várias, tenta deduzir qual corresponde. Se não identificar nenhuma encomenda da Amazon, não preenche nada.
3. Valide o picking ou altere o seu seguimento. Este é o caminho normal e não é preciso carregar em nada. Ao validar, o Odoo tenta confirmar o envio à Amazon se Sincronização automática na validação do picking estiver ativada. Ao guardar um picking já em Concluído com o seguimento alterado, tenta-o se Sincronização automática ao alterar o tracking estiver ativada. Com a caixa correspondente desativada, esse disparador não faz nada.
4. Se usar o modo assíncrono, espere pela nova tentativa. Com Enviar confirmShipment de forma assíncrona (via cron) ativada, a validação apenas deixa o picking em Pendente e a tarefa agendada Amazon SP-API - Reenviar envios pendentes (a cada cinco minutos, ativa ao instalar) é a única que envia. A ajuda da caixa indica que essa tarefa tem de estar ativa.
5. Veja o grupo Amazon SP-API depois de validar. Estado de sincronização Amazon diz-lhe em que ponto está o picking. Se for Pendente, espere pela próxima tentativa. Se for Erro, leia Último erro Amazon.
6. Reenvie à mão só se for preciso. O botão Enviar tracking Amazon aparece com o picking em Concluído e sendo de uma encomenda da Amazon. Salta a verificação de «já enviado» e a de «já sincronizado com o mesmo seguimento», que o caminho automático respeita. A ajuda de confirmShipment da Amazon enviado em explica que esse bloqueio evita a dupla notificação ao comprador; pense bem antes de o contornar. Se o envio falhar, o botão para com Erro ao sincronizar com a Amazon: ….
7. Confirme o resultado. Depois de um envio aceite, o módulo preenche Estado de sincronização Amazon, Última Sincronização Amazon, Seguimento enviado para a Amazon e confirmShipment da Amazon enviado em, e esvazia Último erro Amazon. Guarda também Conteúdo Amazon e Resposta da Amazon, que só vê quem tiver permissão de administração das Definições.

O que o módulo verifica antes de enviar

No caminho automático, antes de enviar nada o módulo interrompe em silêncio nestes casos:

• O picking não é de saída: o módulo só confirma à Amazon entregas de saída, não devoluções.
• O picking não está em Concluído.
• Não encontra o ID da encomenda da Amazon nem uma conta ativa correspondente.
• confirmShipment da Amazon enviado em já tem valor.
• O picking não tem número de seguimento. Se houver vários separados por espaços, vírgulas, ponto e vírgula ou quebras de linha, o módulo toma o primeiro.
• O picking já consta como Sincronizado com esse mesmo seguimento.

Há outro caso: se a Amazon já indicar a encomenda como enviada, o módulo não envia. Tenta preencher os campos de estado a partir desse estado externo, mas só se esse picking for o único de saída da encomenda. Com vários pickings de saída para a mesma encomenda não o marca por si só, porque o estado externo é ambíguo. Esta verificação da Amazon aplica-se também ao carregar no botão.

Para a transportadora, o módulo procura o mapeamento da conta. Se não houver mapeamento, o envio leva Other como código de transportadora.

Pendente, Erro e serviço suspenso

Se o envio automático falhar, o módulo passa o picking para Erro e guarda o texto em Último erro Amazon. Se o que falta forem os dados de envio (seguimento ou transportadora), o picking fica Pendente e o campo do último erro esvazia-se, para ser reenviado quando houver dados completos ou a Amazon já o der como enviado.

Se a conta funcionar através do FlexigoTech Cloud e o conector não tiver serviço, a validação do picking continua e a confirmação fica Pendente (salvo se já estiver sincronizada ou enviada). A tarefa de reenvios envia-a quando o serviço voltar, e não se marca nada como erro. Sem subscrição, ou com o serviço suspenso, para-se o que a subscrição cobre; os dados ficam no seu Odoo.

Subscrição e ajuda da FlexigoTech

O módulo é de pagamento único por versão do Odoo (17, 18, 19 e 20) e necessita da subscrição ao FlexigoTech Cloud: o plano Conector custa 49 €/mês ou 490 €/ano sem IVA. Pode vê-lo na ficha do Odoo Apps ou na página do módulo. Se está a implementar o Odoo e quer ajustar o fluxo de picking com a Amazon, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/fgt_cloud.py
• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/stock_picking.py
• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8c5900d9): views/stock_picking_views.xml
• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html