Recebimento de pedidos

Consulta sob demanda: o sistema parceiro busca pedidos na API mPm+ por período e grava localmente. Webhook não faz parte deste contrato documentado.

Forma típica

Operador (ou job do parceiro) informa período → GET /mpm/pedidos → seleciona / processa → grava no ERP com idempotência pelo id mPm+.

Fluxo HTTP

1. Parceiro chama GET /mpm/pedidos na base https://mobtef.conexaoapi.com.br com headers de autenticação + abertura e fechamento.
2. API retorna status e lista em data[].
3. Parceiro resolve vínculos via mpm_integracao e grava pedido, itens e pagamentos no ERP.
4. Pedidos já importados devem ser ignorados pela chave do id mPm+.

sequenceDiagram
  participant ERP as Sistema parceiro (ERP)
  participant MPM as API mPm+

  ERP->>MPM: GET /mpm/pedidos (headers abertura/fechamento)
  MPM-->>ERP: { status, data[] }
  Note over ERP: Resolve mpm_integracao<br/>cliente, produto, finalizadora, etc.
  loop cada pedido novo
    ERP->>ERP: Grava cabeçalho + itens + pagamentos
  end

Headers do GET

Header	Uso
empresa_id, token, dispositivo_*, app_*, plataforma	Autenticação
abertura	Início do período
fechamento	Fim do período

Formato de data: ver Datas.

Pré-requisito: vínculos mpm_integracao

Para importar sem erro de lookup, os ids do payload devem existir como mpm_integracao nas entidades locais:

Entidade	Campo no pedido	Obrigatório?
Cliente	cliente_id	Se informado, deve existir
Produto	produto_id (por item)	Sim
Finalizadora	finalizadora_id	Sim
Funcionário	vendedor_id / vendedor_prod	Se informados
Plano	plano_id	Se informado

WARNING

Sem mpm_integracao correspondente, o parceiro deve rejeitar o pedido (não criar cadastro automaticamente — comportamento do contrato observado).

Fora deste contrato

• Webhook de pedido
• Polling obrigatório
• Callback de status do ERP para o mPm+

Próximos: Payload · Gravação · Status