O pedido do cliente chega em PDF, mas o Odoo precisa de parceiro, produto, unidade, preço e impostos coerentes. Criar sale.order diretamente a partir de texto sem revisão troca digitação por erro operacional.
O fluxo recomendado cria primeiro uma cotação rastreável. A confirmação usa a regra do Odoo somente depois de conferir os campos críticos.
Leitura e correspondência
O documento é extraído em cabeçalho e linhas, mantendo página e coordenada. res.partner é procurado por identificador fiscal ou código externo; product.product, por SKU, código do cliente ou atributos.
Unidade e variante precisam corresponder. Um nome semelhante não autoriza trocar tamanho, cor ou embalagem. Itens incertos ficam numa fila com opções.
Criação da cotação
Em Odoo 19 Custom, a API JSON-2 permite chamar métodos dos modelos expostos com API key. O integrador cria a sale.order e suas linhas pelo contrato disponível na documentação /doc da base ou chama um método customizado que faça tudo atomicamente.
Importação CSV também é uma alternativa para lote assistido. A documentação informa que campos ausentes recebem valores padrão, por isso o template deve declarar tudo que não pode depender do default.
Por que não confirmar de imediato
Preço, impostos, prazo e disponibilidade podem depender de listas e regras internas. A cotação permite que o vendedor revise e ajuste. A confirmação chama a ação de negócio adequada, como action_confirm, em vez de gravar status manualmente.
A referência externa e o hash do PDF impedem duplicidade. O pedido guarda anexo ou link para o documento original, facilitando auditoria.
Exceções e retorno
Cliente não localizado, SKU ausente, unidade divergente e preço fora da tolerância são estados próprios. Após correção, apenas a linha pendente é reavaliada.
A equipe recebe número da cotação e resumo das diferenças. Logs guardam usuário de integração, payload, resposta e versão do mapeamento.
Piloto
Use documentos de clientes recorrentes e variantes conhecidas. Rode em base de teste e confirme apenas cotações homologadas.
Precisamos da versão/plano Odoo, exemplos de PDFs, modelos e campos customizados, catálogo e regras comerciais. A meta é reduzir preparação mantendo o vendedor no controle da confirmação.