O Omie possui APIs para clientes, produtos, pedidos e faturamento, mas nenhuma API resolve a ambiguidade do documento recebido. A etapa decisiva é transformar o PDF em cliente e produtos corretos antes de enviar o pedido.
A automação deve manter evidência do arquivo, pedir revisão quando necessário e deixar que o Omie aplique os cadastros e regras existentes.
Extração e normalização
A caixa de entrada é monitorada e cada anexo recebe hash. Cabeçalho, endereço e itens são extraídos; unidades e números passam por normalização. O recorte do documento fica disponível para comparar com o dado interpretado.
CNPJ localiza o cliente e códigos ou descrições procuram produtos. Um de/para por cliente resolve catálogos externos. Quando há mais de um candidato, a linha permanece pendente.
APIs envolvidas
O catálogo oficial do Omie lista serviços para clientes, produtos, tabela de preços, formas de pagamento e pedidos de venda, incluindo uma modalidade resumida para adicionar pedido e itens. O conector consulta os cadastros necessários e chama a operação compatível com o processo.
App key e app secret ficam em cofre e são usados somente pelo backend. O payload inclui um código de integração externo para que o pedido possa ser localizado e reprocessado sem duplicação.
Regras antes de enviar
Cliente inativo, produto sem cadastro, unidade divergente, quantidade inválida e preço fora da tolerância são bloqueios. Condição de pagamento, vendedor, origem do pedido e cenário de impostos seguem os valores configurados e aprovados.
A automação pode preparar orçamento ou pedido, conforme o fluxo comercial. Faturamento continua separado, porque emitir documento fiscal sem a etapa operacional adequada aumenta muito o risco.
Retorno e operação
Após a chamada, guardamos código Omie, número do pedido e mensagens. Falha transitória entra em retentativa; rejeição de negócio volta à fila com campo e motivo.
O painel mostra documentos novos, em revisão, enviados e rejeitados. A equipe consegue abrir o PDF, corrigir uma correspondência e reenviar apenas aquele registro.
Piloto recomendado
Selecionamos os clientes e layouts mais frequentes, um conjunto de produtos e um ambiente de teste. A primeira fase cria pedidos sem faturamento automático.
A avaliação precisa de PDFs reais, volume, cadastro de integração, regras de preço e exemplos já digitados no Omie. O resultado é medido por linhas poupadas e exceções corretas, não por acurácia abstrata de OCR.