API de Pedidos do Pedidu

Sempre que um pedido é criado, aceito, atualizado ou cancelado na sua loja, o Pedidu envia automaticamente o card completo do pedido para a URL que você configurar. Esta página documenta cada campo: itens, formas de pagamento, forma de entrega, se é agendado ou não e todos os dados do cliente.

Introdução

A integração de pedidos do Pedidu funciona via webhook (push): você não precisa ficar consultando a API atrás de pedidos novos — o Pedidu te avisa. Assim que um pedido muda de estado, o Pedidu faz uma requisição POST para a URL do seu sistema com o objeto inteiro do pedido em JSON.

É o mesmo modelo usado por roteirizadores e integradores (ex.: Agilizone, Husky): o Pedidu é a origem do pedido e empurra os dados pra fora.

Como funciona

1. O cliente faz um pedido no seu cardápio digital, PDV, balcão ou marketplace (iFood/99Food).
2. O lojista aceita / o pedido muda de status (entra em produção, sai pra entrega, é cancelado…).
3. O Pedidu monta o objeto do pedido e faz POST na sua webhookApi.
4. Seu sistema recebe o JSON { type, order } e processa (cria a entrega, imprime, dá baixa, etc.).

Configuração do webhook

A URL de destino é configurada por loja. No painel do Pedidu (gestor), o campo webhookApi recebe a URL completa (com https://) do seu endpoint. Enquanto estiver vazio ou inválido, nenhum disparo é feito.

A requisição (POST)

O Pedidu sempre envia uma requisição com este formato:

Cabeçalhos e corpo:

POST /webhook/pedidu HTTP/1.1
Host: seu-sistema.com
Content-Type: application/json

{
  "type": "order.updated",
  "order": { ... objeto completo do pedido ... }
}

O corpo tem sempre dois campos no topo:

Eventos (type)

O campo type indica o que aconteceu com o pedido:

Entrega & reenvio

• O disparo é best-effort: o Pedidu envia e segue o fluxo, sem travar a operação da loja se o seu endpoint falhar.
• Trate seu handler como idempotente: o mesmo pedido (mesmo order.id / order.id_order) pode chegar mais de uma vez conforme muda de status.
• Use order.id (id interno) ou order.id_order (número público) como chave de deduplicação.

Objeto order

O order carrega o pedido inteiro. Abaixo, os campos agrupados por tema. A tabela consolidada de todos os campos está em Tabela de campos.

Identificação

Itens & valores

Datas

Itens do pedido

O campo purchase é um array JSON (codificado como string) com um objeto por item. Cada item tem produto, quantidade, adicionais e observação:

[
  {
    "product_id": 20,          // id do produto
    "product_quantity": 2,     // quantidade
    "product_optional": "Sem cebola",  // observação do cliente (ou null)
    "additional": [            // adicionais / opcionais escolhidos
      {
        "name": "Bacon extra",
        "price": 5.00,
        "qty": 1,
        "hight_price": "no"   // "yes" = preço do item vem do adicional (ex.: tamanho)
      }
    ]
  }
]

Cliente & endereço

O order referencia o cliente por id_user. O card completo (como aparece na comanda) resolve esses dados na base de clientes da loja. Os campos do cliente são:

Forma de pagamento

O campo payment_option define a forma de pagamento:

Forma de entrega

O campo delivery_option define como o cliente recebe o pedido:

Pedido agendado

Um pedido é agendado quando o cliente escolhe data/horário para receber. Identifique pela presença dos campos abaixo:

Status do pedido

O campo status indica o estado atual do pedido:

Origem / canal

O campo type do order indica de qual canal o pedido veio:

Totais & descontos

O total do pedido é composto assim:

total = product_price
      + delivery_price        (se delivery_option == 1)
      + manual_addition
      − manual_discount
      − cashback_discount
      − desconto do cupom     (se payment_coupon_id != 0)

Exemplo completo

Um pedido de delivery, pago em dinheiro com troco, não agendado:

{
  "type": "order.updated",
  "order": {
    "id": 83,
    "id_order": "1781804869",
    "num_order": 42,
    "pin_order": "506867",
    "id_user": 1,
    "type": "cardapio",
    "status": "preparation",

    "delivery_option": "1",
    "delivery_price": "7.00",
    "delivery_time": null,
    "delivery_motoboy_id": null,
    "car_board": "0",
    "table_number": 0,

    "payment_option": "money",
    "payment_moneyback": "150.00",
    "payment_card_id": 0,
    "payment_coupon_id": 0,
    "online_payment_fee": "0.00",

    "product_price": "108.00",
    "subtotal_value": "108.00",
    "manual_addition": "0.00",
    "manual_discount": "0.00",
    "cashback_discount": "0.00",

    "agendamented_date": null,
    "agendamented_hours": null,
    "order_note": "Apertar a campainha",

    "purchase": "[{\"product_id\":20,\"product_quantity\":2,\"product_optional\":\"Sem cebola\",\"additional\":[{\"name\":\"Bacon extra\",\"price\":5,\"qty\":1,\"hight_price\":\"no\"}]}]",

    "created_at": "2026-06-18 14:47:49",
    "accepted_at": "2026-06-18 14:47:51",
    "updated_at": "2026-06-18 14:50:02"
  }
}

Tabela de campos (referência)

Todos os campos do objeto order: