Payload e tags do pedido

JSON típico retornado em data[] do GET /mpm/pedidos. Campos abaixo são os relevantes para gravação no ERP.

Status e desconto

status (F/E/A/C) e desconto de cabeçalho podem aparecer no JSON. São informativos neste contrato; o mapeamento para status/desconto local fica a cargo do parceiro (ver Status).

Exemplo fictício

{
  "id": 606431,
  "cliente_nome": "Cliente Homologação LTDA",
  "cliente_id": 1001,
  "cliente_documento": "12345678901",
  "cliente_whatsapp": "11999998888",
  "vendedor_id": 55,
  "emissao": "2026-07-28 14:35:00",
  "total": 150.00,
  "troco": 10.00,
  "status": "F",
  "desconto": 5.00,
  "itens": [
    {
      "item_id": 1,
      "produto_id": 9001,
      "produto_nome": "Produto Demo A",
      "quantidade": 2,
      "unitario": 50.00,
      "desconto_item": 0,
      "desc_prod": 0,
      "total_item": 100.00,
      "sigla": "UN",
      "vendedor_prod": 55
    },
    {
      "item_id": 2,
      "produto_id": 9002,
      "produto_nome": "Produto Demo B",
      "quantidade": 1,
      "unitario": 50.00,
      "desconto_item": 0,
      "desc_prod": 0,
      "total_item": 50.00,
      "sigla": "UN",
      "vendedor_prod": null
    }
  ],
  "finalizadoras": [
    {
      "finalizadora_id": 3,
      "valor": 160.00,
      "plano_id": 1
    }
  ]
}

Dicionário — cabeçalho

Campo	Tipo	Uso
id	int	Obrigatório. Chave de idempotência no ERP (id mPm+).
cliente_nome	string	Obrigatório. Nome / razão para o pedido.
cliente_id	int | null	Id mPm+ → resolver via mpm_integracao do cliente.
cliente_documento	string	CPF/CNPJ (dígitos).
cliente_whatsapp	string	Telefone / WhatsApp (dígitos).
vendedor_id	int | null	Id mPm+ → resolver via mpm_integracao do funcionário.
emissao	string	Data/hora de emissão.
total	number	Total do pedido (usado na regra de troco).
troco	number	Troco informado.
status	string	Informativo: F / E / A / C se aparecer.
desconto	number	Informativo no cabeçalho, se aparecer.

Dicionário — itens[]

Campo	Tipo	Uso
item_id	int	Referência do item
produto_id	int	Id mPm+ → obrigatório resolver via mpm_integracao
produto_nome	string	Descrição do item
quantidade	number	Deve ser > 0
unitario	number	Valor unitário
desconto_item	number	Desconto do item
desc_prod	number	Desconto adicional do produto
total_item	number	Total da linha
sigla	string	Unidade (ex.: UN)
vendedor_prod	int | null	Vendedor do item (override), se informado

Dicionário — finalizadoras[]

Campo	Tipo	Uso
finalizadora_id	int	Id mPm+ → resolver via mpm_integracao
valor	number	Valor pago (deve ser > 0)
plano_id	int | null	Id mPm+ do plano, se houver

Validações recomendadas

• Pedido com id
• cliente_nome não vazio
• Pelo menos um item e uma finalizadora
• Quantidades e valores > 0 onde aplicável

Ver também: Clientes · Produtos · Pagamentos