Pular para conteúdo

Pedido de Compra Omie

Integração entre o Sistema de Orçamento BPEX (bepex.flowtech.net.br) e o Omie ERP, via n8n (n8n.bepex.com.br). Quando um orçamento aprovado vira Pedido de Compra (PC) no BPEX, um webhook dispara o n8n, que cria o PC correspondente no Omie da empresa certa (Onix / Atares / LGR / Dale / BPX).

Status atual

EM PRODUÇÃO. Dois workflows separados por categoria de compra, ambos ativos:

  • MO — Mão de Obra (WwDzIseoYVxbzJZK): industrialização e serviços terceirizados; precisa de projeto no Omie (= pedido_venda.id).
  • MP — Matéria-Prima (66DDyQXmXQqyV3Ah): chapas, bobinas; não usa projeto — proposital, pois MP é comprada em batch misturando vários orçamentos. Faz dedupe de descrições + auto-criar produto.

Fixes mais recentes: match de produto só por descrição no Distribuir MO (2026-07-13) e exceção de alumínio no conflito de descrição MP (2026-07-07). Cronologia completa em bugs-fix-log.md.

Como operar

  1. Disparo (Andrei / Daiane): marcar o PC como emitido no sistema de orçamento BPEX — dispara o webhook GET automaticamente.
  2. Ao voltar a tocar nos workflows: ler primeiro as skills n8n-bepex, n8n-bepex-teste-pipeline-e2e, omie-bepex-produto.
  3. Backup obrigatório antes de qualquer PATCH em produção (regra global do Rafael).
  4. Promover atomicamente seguindo a skill n8n-bepex-teste-pipeline-e2e. Nunca dar OK final sem rodar e2e com body real de uma execução de produção — "status success nunca é prova".
  5. Avisar Andrei E Daiane (não pular nenhum — ver memória feedback_avisos_multidestinatario).

Pegadinhas críticas (as que mais quebraram)

  1. Webhook httpMethod: o BPEX manda GET; o default do n8n é GET. NUNCA setar POST em PATCHes — quebra prod silencioso com 404 (já errado 2×).
  2. errorWorkflow ao clonar: clone via REST herda o settings.errorWorkflow do original; ao desativar o original, callbacks de erro silenciam. Atualizar pro ID do clone.
  3. pairedItem manual em Code expand aponta pro INPUT do Code, não pro nó upstream — em downstream usar $json.X (com spread no Code), nunca $('NóLonge').item.json.X.
  4. codigo_produto_integracao obrigatório na ATARES no IncluirProduto — passar o mesmo valor de codigo BPX.
  5. Dedupe é obrigatório antes de qualquer nó que chama o Omie por descrição quando há itens duplicados — senão o Omie bloqueia por "consumo redundante".

Detalhamento em arquitetura.md (§ Pegadinhas críticas) e bugs-fix-log.md.

Pendência conhecida

  • Dale Omie: a app_key da Dale (${OMIE_APP_KEY_DALE}) não tem a permissão "Cadastro de Projetos / Inclusão" liberada no painel Omie. Enquanto não for liberada, a Dale segue quebrando quando o projeto não existe (sem regressão). Ver referencia-tecnica.md e a memória project_dale_omie_pendencia.

Pontos de contato (Whats Bepex — Chatwoot account 3, inbox 26)

Pessoa Conversa Função
Andrei conv #30 Compras / emite PC
Daiane conv #94 Administrativo / emite PC
Enrico conv #56 Gestor — entra quando precisa atualizar status

Tom dos avisos conforme skill whatsapp-bepex: profissional-direto, sem emojis; confirmar destinatário-por-destinatário.

Índice da subpasta

Documento Conteúdo
README.md (este) Visão executiva, status, como operar, pegadinhas, pendência, contatos
arquitetura.md Cadeia de nós de MO e MP, ramo de projeto, fluxo de erro, pegadinhas consolidadas
referencia-tecnica.md App keys/secrets (placeholders), mapping BPEX→Omie, endpoints, erros Omie, body do webhook
bugs-fix-log.md Cronologia datada de bugs e fixes (abr–jul 2026) + casos NÃO-bug
ARQUIVOS.md Manifesto de binários/backups que vivem no Drive (não no repo)

Consolidação (S7): os docs legados soltos da pasta-fonte — OMIE_WORKFLOWS_PEDIDO_COMPRA.md (linha-base nó-por-nó de 2026-04-30), OMIE_WORKFLOWS_PLANO_REVISAO_PROJETO.md (plano de revisão executado em 04-05/05/2026) e BACKLOG.md (pendência Dale) — foram incorporados aos docs canônicos acima. Os originais permanecem na pasta-fonte (ver ARQUIVOS.md).