O XML-RPC ainda funciona no Odoo 19, mas está descontinuado e a documentação oficial indica que a sua remoção está prevista para o Odoo 22. Para tudo aquilo em que estiver a mexer agora, passe para a API JSON-2.
Passar o portal para JSON-2
- Crie um utilizador de integração dedicado, apenas com os direitos de que precisa.
- Nas Preferências desse utilizador, em Segurança da Conta, crie uma Nova Chave de API com uma descrição clara e um prazo curto. As chaves não podem exceder três meses, por isso planeie a rotação.
- Chame POST /json/2/sale.order/ seguido do nome do método, enviando a chave como bearer token no cabeçalho Authorization.
- Cada chamada é uma transação própria, por isso evite dividir uma encomenda por muitas chamadas.
Verifique também o seu plano: a documentação indica que o acesso à API externa só está disponível nos planos de preços Personalizado.
Evitar duplicados
- Guarde o número de encomenda do portal na encomenda de venda, por exemplo na referência do cliente ou num campo dedicado.
- Antes de criar, pesquise essa referência e, se existir, atualize em vez de criar.
Pagamentos
Verifique primeiro se o seu gateway consta da lista em Configuração, Fornecedores de Pagamento. Um fornecedor integrado é melhor do que um webhook personalizado. Se não constar, crie uma regra de automação com o acionador Em webhook, ative Registar Chamadas, mantenha o URL em segredo e teste tudo numa base de dados duplicada antes de entrar em produção.