# MeuPedido Developers

- Documentação: Guias para integrar o seu sistema à API Open Delivery do MeuPedido.

  - **Introdução**
  - [Visão geral](/pt-BR/docs/getting-started): O que é a API Open Delivery do MeuPedido, para quem ela serve e por onde começar.
  - [Como funciona](/pt-BR/docs/getting-started/how-it-works): Os três lados da integração: lojista, MeuPedido e o seu sistema, com entrega por polling ou webhook.
  - [Conceitos](/pt-BR/docs/getting-started/concepts): Loja, credencial, escopo, evento, entrega, pedido e loja de teste: o vocabulário da API.
  - Primeiros passos
    - [Obter credenciais](/pt-BR/docs/getting-started/first-steps/get-credentials): Como o lojista gera o client_id e o segredo em Integrações > Open Delivery, com escopos e modo de entrega.
    - [Loja de teste](/pt-BR/docs/getting-started/first-steps/test-store): Como pedir uma loja de teste ao suporte e gerar pedidos reais marcados com test: true.
    - [Primeira integração em 10 minutos](/pt-BR/docs/getting-started/first-steps/first-integration): Do token ao pedido confirmado, passo a passo, com playground em cada operação e o cURL equivalente.
    - [Entrada em produção](/pt-BR/docs/getting-started/first-steps/go-live): Checklist do que conferir antes de ligar a integração em uma loja real.
  - [Autenticação](/pt-BR/docs/getting-started/authentication): OAuth client credentials, escopos, expiração de 3600 s, credencial pausada ou revogada e limites do endpoint de token.
  - Pedidos
    - [Ciclo de vida do pedido](/pt-BR/docs/getting-started/orders/lifecycle): A máquina de estados do pedido, as transições permitidas, o retrocesso a partir de ACCEPTED e o cancelamento.
    - [Polling](/pt-BR/docs/getting-started/orders/polling): Consulta de eventos com entrega at-least-once, dedupe por eventId, limite de 200 por consulta e confirmação obrigatória.
    - [Webhooks](/pt-BR/docs/getting-started/orders/webhooks): Entrega por webhook: envelope idêntico ao polling, cabeçalhos X-MeuPedido-*, verificação da assinatura HMAC, retentativas e desativação.
    - [Ações e idempotência](/pt-BR/docs/getting-started/orders/actions): confirm, startPreparation, readyForPickup, dispatch, pickedUp, delivered e requestCancellation, com Idempotency-Key e as respostas 202, 404, 409 e 422.
    - [Catálogo de eventos](/pt-BR/docs/getting-started/orders/events): Os seis eventos do padrão e as extensões MeuPedido, quando cada um dispara, e o que vem em metadata e delivery.
    - [Estrutura do pedido](/pt-BR/docs/getting-started/orders/order-object): Todos os campos do pedido, de id e displayId a items, payments, delivery, takeout, schedule e test, com exemplos completos de DELIVERY e TAKEOUT.
  - [Loja e cardápio](/pt-BR/docs/getting-started/merchant): GET merchant e GET menus: dados da loja, categorias, itens, grupos de opções e o grupo Tamanho.
  - [Boas práticas](/pt-BR/docs/getting-started/best-practices): Limites de requisição, tabela de erros, datas em UTC, backoff, guarda do segredo e versão do padrão.
  - [Compatibilidade](/pt-BR/docs/getting-started/compatibility): O que está implementado do Open Delivery 1.4.0, o que é extensão MeuPedido e o que ainda não existe.
  - [Para agentes de IA](/pt-BR/docs/getting-started/ai-agents): llms.txt, llms-full.txt, Markdown por página, especificação OpenAPI e um prompt pronto para começar.
  - [Suporte](/pt-BR/docs/getting-started/support): Como falar com o suporte pelo WhatsApp e o que enviar: client_id, traceId, horário e eventId.
- Referência de API: Endpoints, parâmetros, respostas e erros da API Open Delivery do MeuPedido.
  - [Referência de API](/pt-BR/docs/references): URL base, autenticação, erros, limites e downloads da especificação OpenAPI e da coleção Postman.
- Changelog: Mudanças na API Open Delivery do MeuPedido, da mais recente para a mais antiga.
  - [Changelog da API](/pt-BR/docs/changelog): Mudanças na API Open Delivery do MeuPedido, da mais recente para a mais antiga.