Open Delivery 1.4.0

Integre seu sistema ao MeuPedido

Receba pedidos, confirme, acompanhe a entrega e leia o cardápio pela API Open Delivery do MeuPedido. Token em uma chamada, eventos por polling ou webhook, e documentação feita para pessoas e para agentes de IA.

Token
uma chamada, 3600 s
Eventos
polling ou webhook
Padrão
Open Delivery 1.4.0

https://api.meupedido.io/open-delivery

integracao.shpausado

$ export API=https://api.meupedido.io/open-delivery

$

Quatro passos entre o cardápio e a sua cozinha

Do acesso concedido pelo lojista até o pedido concluído, sem SDK proprietário: HTTP, JSON e um token.

  1. 01

    Credencial na loja

    O lojista abre Integrações, Open Delivery no painel e concede acesso ao seu sistema. Sai um client_id e um segredo, mostrado uma vez.

    client_id: mp_...
  2. 02

    Token

    Uma chamada com client_credentials devolve um bearer válido por 3600 s. Sem refresh token: peça outro quando vencer.

    POST /oauth/token
  3. 03

    Receber eventos

    Consulte o feed ou receba um webhook. Cada evento aponta para o pedido. Tudo que não for confirmado volta na próxima consulta.

    GET /v1/events:polling
  4. 04

    Confirmar o pedido

    Aceite, marque pronto, despache e conclua. Cada ação vira um evento, e a chave de idempotência protege contra repetição.

    POST /v1/orders/{id}/confirm

Versão guiada em Primeira integração em 10 minutos.

Escolha como receber os eventos. Ou use os dois.

O modo de entrega é definido na credencial: POLLING, WEBHOOK ou BOTH. O envelope do evento é o mesmo nos dois caminhos, então trocar de modo não muda o seu parser.

Polling

Padrão Open Delivery

Seu sistema pergunta. Serve para qualquer ambiente, inclusive sem endereço público.

  • GET /v1/events:polling, até 200 eventos por consulta
  • Entrega at-least-once: confirme com o ack ou o evento volta
  • Feed por credencial, ordenado por createdAt, sem cursor
  • Confirmados somem em 30 dias; pendentes ficam para sempre
Documentação de polling

Webhook

Extensão MeuPedido

O MeuPedido avisa. Latência mínima, com assinatura HMAC e retentativas automáticas.

  • POST na sua URL HTTPS com o mesmo envelope do polling
  • X-MeuPedido-Signature: HMAC-SHA256 de "{timestamp}.{body}"
  • Retentativas em 5, 10 e 20 s; depois o evento fica no polling
  • Entregue não é confirmado: o ack continua obrigatório
Documentação de webhook
Nos dois modos, o ack fecha o ciclo. Um evento entregue por webhook continua no feed de polling até o seu sistema chamar POST /v1/events/acknowledgment.

Cole a URL no seu assistente e deixe ele integrar

Toda a documentação sai em texto puro, indexado e sem ruído. Um agente lê o llms.txt, abre só as páginas que precisa e escreve o client a partir da especificação.

# prompt pronto
Leia https://developer.meupedido.io/llms.txt
e integre meu sistema ao MeuPedido
por polling, com ack e idempotência.
Guia para agentes de IA
  • llms.txt

    Um índice da documentação inteira, com URL e resumo de cada página, para o agente decidir o que ler. A versão completa traz todo o texto num arquivo só.

  • Markdown por página

    Acrescente .md a qualquer URL da documentação e receba a página crua, sem navegação. Cada página também tem os botões Copiar Markdown, Abrir no ChatGPT e Abrir no Claude.

  • Especificação para download

    OpenAPI 3 em YAML e JSON e a coleção do Postman, geradas da mesma fonte que a referência. Importe no seu gerador de client ou no seu assistente.

OPEN DELIVERY 1.4.0 · ORDER · MERCHANT · ABRASEL ·1.4.0COMPATÍVEL

Open Delivery 1.4.0, módulos Order e Merchant

O MeuPedido atua como aplicação de pedidos no padrão da Abrasel. Quem já integra outro marketplace pelo Open Delivery reaproveita o mesmo modelo de pedido, os mesmos eventos e o mesmo fluxo de ações. As extensões (webhooks, PREPARING, eventos de entregador) são marcadas na documentação para nunca se confundirem com o padrão.

O que está implementado, estendido e ainda não coberto

Seu primeiro pedido em dez minutos.

Peça uma loja de teste ao suporte, gere a credencial no painel e siga o guia. O terminal lá em cima é exatamente o que você vai ver.

Suporte: (11) 95502-1289