BeeFoodDevelopers
Entrar ou criar acesso

Criar pedido

POST
Markdown (LLM)

Cria um pedido aberto no restaurante, sempre com canal de venda EXTERNAL.

Escopo:orders:write

Limite:300 requisições a cada 3 minutos.

Parâmetros do body

merchantIdinteger

Filial do restaurante. Aceita só merchant com cardápio publicado.

1
orderTypestring

Tipo do pedido.

Enum

  • DELIVERYPedido delivery
  • PDVPedido lançado no PDV
  • TABLEMesa / presencial
"DELIVERY"
usuarioIdinteger

Usuário PDV do restaurante. Se ausente, usa o usuário vinculado ao dono da credencial.

12
employeeIdinteger

Funcionário que lançou o pedido.

5
orderObservationsstring

Observações do pedido.

"Sem cebola"

Parâmetros da resposta

orderIdinteger

ID do pedido criado. Detalhe em GET /v1/orders/{orderId}.

1234

Alerta de aceite

Pedidos DELIVERY com delivery.deliveryStatus WAITING chegam como pedido novo aguardando aceite. O PDV toca o alerta de novo pedido, o restaurante aceita ou cancela. A impressão na cozinha é feita apenas quando o pedido é aceito.

Regras

  • Pedidos DELIVERY criados em outro status (ACCEPTED, PREPARING, READY, DISPATCHED ou DELIVERED) já são aceitos: não geram alerta e vão direto para a impressão da cozinha.
  • Pedidos PDV e TABLE nunca geram alerta de aceite.
  • A resposta 201 não confirma que o alerta tocou: o pedido é criado mesmo se o aviso ao restaurante falhar.

Item avulso

Use productId: null quando o produto não existe no catálogo. Com itemName, o PDV mostra o nome como "não vinculado" até o restaurante associá-lo a um produto.

Regras

  • A pendência é uma por restaurante e nome; pedidos seguintes com o mesmo itemName não duplicam. Sem itemName, não há pendência.
  • O item não emite nota fiscal, não baixa estoque e não entra nas rotinas de produto do PDV.
  • Nos relatórios, o item vem com productId: null.
  • Associar a pendência no PDV não corrige pedidos já criados.