Consulte este endpoint para receber eventos de pedidos. Depois de processá-los, use Confirmar eventos.
Como o polling funciona
GET /v1/events:polling retorna um snapshot do estado atual dos pedidos. Ele não funciona como uma fila nem mantém um histórico completo de eventos.Cada pedido aparece no máximo uma vez na resposta, sempre com seu evento mais recente. O evento continua aparecendo nos pollings seguintes enquanto não for confirmado e continuar sendo o evento atual do pedido.Quando o pedido muda de status, o novo evento substitui o anterior, mesmo que o anterior ainda não tenha sido confirmado.
Exemplo: o polling retorna CREATED, mas o pedido muda para CONFIRMED antes do acknowledgment. A próxima consulta retorna apenas CONFIRMED. O evento CREATED não será retornado novamente.
Trate cada evento como um snapshot do pedido. Faça polling em um intervalo curto o suficiente para sua operação e confirme o processamento rapidamente. A resposta retorna no máximo 1000 eventos por consulta, dos pedidos mais antigos para os mais novos: confirme os eventos para drenar a fila.
Este endpoint não fornece um histórico completo de transições. Estados intermediários podem não aparecer. Se sua integração precisa de um histórico para auditoria, não use as respostas do polling como registro de todas as mudanças.
Parâmetros de consulta
string[]
Filtra eventos por tipo. Repita o parâmetro para informar vários tipos (?eventType=CREATED&eventType=CONFIRMED). Eventos cujo tipo atual não está no filtro não aparecem nesta resposta. O filtro não confirma esses eventos. Se um pedido mudar de status, o novo evento substituirá o anterior e será avaliado pelos filtros da próxima consulta. Omita este parâmetro para receber todos os tipos de eventos pendentes.Valores aceitos:
CREATED: O pedido foi criado.
CONFIRMED: O pedido foi confirmado pelo merchant.
READY_FOR_PICKUP: O pedido está pronto para retirada pelo entregador ou cliente.
DISPATCHED: O pedido saiu da loja para entrega.
PICKUP_AREA_ASSIGNED: Uma área de retirada foi designada para o pedido.
DELIVERED: O pedido foi entregue ao cliente.
CONCLUDED: O ciclo de vida do pedido está concluído.
CANCELLATION_REQUESTED: O próprio PDV solicitou o cancelamento com POST /v1/orders/{orderId}/requestCancellation. Este evento não exige resposta.
CANCELLATION_REQUEST_DENIED: O Ordering Application negou a solicitação de cancelamento.
CANCELLED: O pedido foi efetivamente cancelado.
ORDER_CANCELLATION_REQUEST: O cliente solicitou o cancelamento pela plataforma. Responda com acceptCancellation ou denyCancellation.
CANCELLED_DENIED: O Software Service negou a solicitação de cancelamento do Ordering Application.
string (date)
Filtro de data/hora inicial pela data de criação do pedido (não do evento). Limite inclusivo. Um pedido criado antes da janela não aparece, mesmo que o evento atual dele seja recente.Formatos aceitos:
Y-m-d: usa o início do dia, às 00:00:00, no horário local da loja.
Y-m-d H:i: o horário é interpretado como UTC (horário universal) e convertido para o horário de Brasília, o que recua a janela em 3 horas. Por exemplo, 2026-07-01 00:00 filtra a partir de 2026-06-30 21:00:00.
string (date)
Filtro de data/hora final pela data de criação do pedido (não do evento). Limite inclusivo.Formatos aceitos:
Y-m-d: usa o fim do dia, às 23:59:59, no horário local da loja.
Y-m-d H:i: o horário é interpretado como UTC (horário universal) e convertido para o horário de Brasília, o que recua a janela em 3 horas. O corte ocorre no segundo 00 do minuto informado, porque o parâmetro não aceita segundos.
Os dois formatos não são equivalentes. Se você quer o dia 3 inteiro, use start_at=2026-08-03&end_at=2026-08-03. Informar 2026-08-03 00:00 e 2026-08-03 23:59 filtra de 2026-08-02 21:00:00 até 2026-08-03 20:59:00: inclui a noite do dia anterior e corta as últimas 3 horas do dia pedido.Para consultar dias completos no horário da loja, use sempre Y-m-d. Use Y-m-d H:i apenas se a sua integração trabalha em UTC e você quer esse recorte.
Os filtros de data são aplicados depois do filtro de eventos não confirmados. Um pedido já confirmado não volta a aparecer por causa do período informado. Para usar esses filtros na consulta de pedidos antigos, veja Histórico de pedidos.
Resposta
200: Sucesso
Retorna um array com o evento atual ainda não confirmado de cada pedido. Cada pedido aparece no máximo uma vez na resposta. Cada objeto inclui o identificador do tipo de evento, o tipo, o ID do pedido associado e um link para os detalhes do pedido.
string (uuid)
Identificador do tipo de evento. Todos os pedidos com o mesmo eventType compartilham esse valor.Um evento de pedido é identificado pelo par orderId e eventId. Use sempre os dois valores ao confirmar ou deduplicar eventos. Nunca deduplique apenas por eventId.
string
Tipo do evento (por exemplo, CREATED, CONFIRMED, CANCELLED).
string (uuid)
Identificador único do pedido associado a este evento, gerado pela Onbeef.
string (url)
URL apontando para o recurso completo com os detalhes do pedido.
string (date-time)
Timestamp ISO 8601 de criação do pedido (por exemplo, 2019-08-24T14:15:22.000000Z). O valor não muda quando o evento muda.
string (uuid)
Identificador da aplicação que originou este evento.
string
Marca virtual associada ao pedido, se aplicável.
401: Não autorizado
Retornado quando a requisição não inclui credenciais de autenticação válidas.
429: Limite de requisições
A rota aceita até 200 requisições por minuto, num limite compartilhado com as outras rotas de leitura. Acima disso, a API responde { "title": "Too Many Requests", "status": 429 }. Veja Limite de requisições.
Confirme cada evento assim que terminar de processá-lo. Um evento não confirmado pode reaparecer enquanto continuar sendo o evento atual do pedido. Se o status mudar antes do acknowledgment, o novo evento substituirá o anterior, que não será retornado novamente.
Recomendamos fazer polling neste endpoint a cada 30 segundos durante o horário de operação. Use o filtro eventType para limitar a resposta apenas aos tipos que sua integração precisa tratar.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Onbeef Connect API","description":"API REST da Onbeef para integrar sistemas PDV de açougues e casas de carne: sincronização de catálogo, processamento de pedidos e operação de entregas, no padrão OpenDelivery.","colors":{"primary":"#C8102E","light":"#FF3B5C","dark":"#FF3B5C"},"logo":{"light":"https://www.onbeef.app.br/logo.png","dark":"https://www.onbeef.app.br/logo.png"},"favicon":"https://mintcdn.com/onbeef/oZWOfY3NZyzFPDI2/favicon.png?fit=max\u0026auto=format\u0026n=oZWOfY3NZyzFPDI2\u0026q=85\u0026s=115ee42f327cf7166ce8e4073cf2e3b0","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl"],"autogenerate":true},"mdx":{"auth":{"method":"bearer"},"server":["https://api.dev.connect.onbeefapp.com.br","https://api.connect.onbeefapp.com.br"]}},"appearance":{"default":"dark"},"navbar":{"primary":{"type":"button","label":"Conheça a Onbeef","href":"https://www.onbeef.app.br"}},"footer":{"socials":{"website":"https://onbeefapp.com.br"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onbeef","hasAudioNarration":false,"actualSubdomain":"onbeef","customDomains":["docs.onbeef.app"],"gitSource":{"type":"github","owner":"onbeefapp","repo":"api-connect-mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8c44c3af46649bd4108aad","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"Referência","count":21},{"language":"default","tag":"Pedidos","count":20},{"language":"default","tag":"Logística","count":6},{"language":"default","tag":"Comece aqui","count":5},{"language":"default","tag":"Merchant","count":4},{"language":"default","tag":"Catálogo","count":4},{"language":"default","tag":"Primeiros passos","count":3},{"language":"default","tag":"Visão geral","count":2},{"language":"default","tag":"Ambientes","count":2},{"language":"default","tag":"Autenticação","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/orders/get-events","slug":"/api-reference/orders/get-events","pageMetadata":{"title":"Consulte eventos","sidebarTitle":"Consultar eventos","description":"Obtenha os eventos pendentes.","api":"GET /v1/events:polling","href":"/api-reference/orders/get-events"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Obtenha os eventos pendentes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,ParamField,ResponseField,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Consulte este endpoint para receber eventos de pedidos. Depois de processá-los, use `,_jsx(_components.a,{href:`/api-reference/orders/confirm-events`,children:`Confirmar eventos`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`como-o-polling-funciona`,children:`Como o polling funciona`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /v1/events:polling`}),` retorna um snapshot do estado atual dos pedidos. Ele não funciona como uma fila nem mantém um histórico completo de eventos.`]}),`\n`,_jsx(_components.p,{children:`Cada pedido aparece no máximo uma vez na resposta, sempre com seu evento mais recente. O evento continua aparecendo nos pollings seguintes enquanto não for confirmado e continuar sendo o evento atual do pedido.`}),`\n`,_jsx(_components.p,{children:`Quando o pedido muda de status, o novo evento substitui o anterior, mesmo que o anterior ainda não tenha sido confirmado.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Exemplo: o polling retorna `,_jsx(_components.code,{children:`CREATED`}),`, mas o pedido muda para `,_jsx(_components.code,{children:`CONFIRMED`}),` antes do acknowledgment. A próxima consulta retorna apenas `,_jsx(_components.code,{children:`CONFIRMED`}),`. O evento `,_jsx(_components.code,{children:`CREATED`}),` não será retornado novamente.`]})}),`\n`,_jsx(_components.p,{children:`Trate cada evento como um snapshot do pedido. Faça polling em um intervalo curto o suficiente para sua operação e confirme o processamento rapidamente. A resposta retorna no máximo 1000 eventos por consulta, dos pedidos mais antigos para os mais novos: confirme os eventos para drenar a fila.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Este endpoint não fornece um histórico completo de transições. Estados intermediários podem não aparecer. Se sua integração precisa de um histórico para auditoria, não use as respostas do polling como registro de todas as mudanças.`})}),`\n`,_jsx(Heading,{level:`2`,id:`parâmetros-de-consulta`,children:`Parâmetros de consulta`}),`\n`,_jsxs(ParamField,{query:`eventType`,type:`string[]`,id:`param-event-type`,children:[_jsxs(_components.p,{children:[`Filtra eventos por tipo. Repita o parâmetro para informar vários tipos (`,_jsx(_components.code,{children:`?eventType=CREATED\u0026eventType=CONFIRMED`}),`). Eventos cujo tipo atual não está no filtro não aparecem nesta resposta. O filtro não confirma esses eventos. Se um pedido mudar de status, o novo evento substituirá o anterior e será avaliado pelos filtros da próxima consulta. Omita este parâmetro para receber todos os tipos de eventos pendentes.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Valores aceitos:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CREATED`}),`: O pedido foi criado.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CONFIRMED`}),`: O pedido foi confirmado pelo merchant.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`READY_FOR_PICKUP`}),`: O pedido está pronto para retirada pelo entregador ou cliente.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`DISPATCHED`}),`: O pedido saiu da loja para entrega.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`PICKUP_AREA_ASSIGNED`}),`: Uma área de retirada foi designada para o pedido.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`DELIVERED`}),`: O pedido foi entregue ao cliente.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CONCLUDED`}),`: O ciclo de vida do pedido está concluído.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CANCELLATION_REQUESTED`}),`: O próprio PDV solicitou o cancelamento com `,_jsx(_components.code,{children:`POST /v1/orders/{orderId}/requestCancellation`}),`. Este evento não exige resposta.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CANCELLATION_REQUEST_DENIED`}),`: O Ordering Application negou a solicitação de cancelamento.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CANCELLED`}),`: O pedido foi efetivamente cancelado.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ORDER_CANCELLATION_REQUEST`}),`: O cliente solicitou o cancelamento pela plataforma. Responda com `,_jsx(_components.code,{children:`acceptCancellation`}),` ou `,_jsx(_components.code,{children:`denyCancellation`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CANCELLED_DENIED`}),`: O Software Service negou a solicitação de cancelamento do Ordering Application.`]}),`\n`]})]}),`\n`,_jsxs(ParamField,{query:`start_at`,type:`string (date)`,id:`param-start-at`,children:[_jsxs(_components.p,{children:[`Filtro de data/hora inicial pela data de criação do `,_jsx(_components.strong,{children:`pedido`}),` (não do evento). Limite inclusivo. Um pedido criado antes da janela não aparece, mesmo que o evento atual dele seja recente.`]}),_jsx(_components.p,{children:`Formatos aceitos:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Y-m-d`}),`: usa o início do dia, às `,_jsx(_components.code,{children:`00:00:00`}),`, no horário local da loja.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Y-m-d H:i`}),`: o horário é interpretado como `,_jsx(_components.strong,{children:`UTC (horário universal)`}),` e convertido para o horário de Brasília, o que recua a janela em 3 horas. Por exemplo, `,_jsx(_components.code,{children:`2026-07-01 00:00`}),` filtra a partir de `,_jsx(_components.code,{children:`2026-06-30 21:00:00`}),`.`]}),`\n`]})]}),`\n`,_jsxs(ParamField,{query:`end_at`,type:`string (date)`,id:`param-end-at`,children:[_jsxs(_components.p,{children:[`Filtro de data/hora final pela data de criação do `,_jsx(_components.strong,{children:`pedido`}),` (não do evento). Limite inclusivo.`]}),_jsx(_components.p,{children:`Formatos aceitos:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Y-m-d`}),`: usa o fim do dia, às `,_jsx(_components.code,{children:`23:59:59`}),`, no horário local da loja.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Y-m-d H:i`}),`: o horário é interpretado como `,_jsx(_components.strong,{children:`UTC (horário universal)`}),` e convertido para o horário de Brasília, o que recua a janela em 3 horas. O corte ocorre no segundo `,_jsx(_components.code,{children:`00`}),` do minuto informado, porque o parâmetro não aceita segundos.`]}),`\n`]})]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`Os dois formatos não são equivalentes. Se você quer o dia 3 inteiro, use `,_jsx(_components.code,{children:`start_at=2026-08-03\u0026end_at=2026-08-03`}),`. Informar `,_jsx(_components.code,{children:`2026-08-03 00:00`}),` e `,_jsx(_components.code,{children:`2026-08-03 23:59`}),` filtra de `,_jsx(_components.code,{children:`2026-08-02 21:00:00`}),` até `,_jsx(_components.code,{children:`2026-08-03 20:59:00`}),`: inclui a noite do dia anterior e corta as últimas 3 horas do dia pedido.`]}),_jsxs(_components.p,{children:[`Para consultar dias completos no horário da loja, use sempre `,_jsx(_components.code,{children:`Y-m-d`}),`. Use `,_jsx(_components.code,{children:`Y-m-d H:i`}),` apenas se a sua integração trabalha em UTC e você quer esse recorte.`]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Os filtros de data são aplicados depois do filtro de eventos não confirmados. Um pedido já confirmado não volta a aparecer por causa do período informado. Para usar esses filtros na consulta de pedidos antigos, veja `,_jsx(_components.a,{href:`/concepts/orders-history`,children:`Histórico de pedidos`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(Heading,{level:`3`,id:`200-sucesso`,children:`200: Sucesso`}),`\n`,_jsx(_components.p,{children:`Retorna um array com o evento atual ainda não confirmado de cada pedido. Cada pedido aparece no máximo uma vez na resposta. Cada objeto inclui o identificador do tipo de evento, o tipo, o ID do pedido associado e um link para os detalhes do pedido.`}),`\n`,_jsxs(ResponseField,{name:`eventId`,type:`string (uuid)`,id:`param-event-id`,children:[_jsxs(_components.p,{children:[`Identificador do tipo de evento. Todos os pedidos com o mesmo `,_jsx(_components.code,{children:`eventType`}),` compartilham esse valor.`]}),_jsxs(_components.p,{children:[`Um evento de pedido é identificado pelo par `,_jsx(_components.code,{children:`orderId`}),` e `,_jsx(_components.code,{children:`eventId`}),`. Use sempre os dois valores ao confirmar ou deduplicar eventos. Nunca deduplique apenas por `,_jsx(_components.code,{children:`eventId`}),`.`]})]}),`\n`,_jsx(ResponseField,{name:`eventType`,type:`string`,id:`param-event-type-1`,children:_jsxs(_components.p,{children:[`Tipo do evento (por exemplo, `,_jsx(_components.code,{children:`CREATED`}),`, `,_jsx(_components.code,{children:`CONFIRMED`}),`, `,_jsx(_components.code,{children:`CANCELLED`}),`).`]})}),`\n`,_jsx(ResponseField,{name:`orderId`,type:`string (uuid)`,id:`param-order-id`,children:_jsx(_components.p,{children:`Identificador único do pedido associado a este evento, gerado pela Onbeef.`})}),`\n`,_jsx(ResponseField,{name:`orderURL`,type:`string (url)`,id:`param-order-url`,children:_jsx(_components.p,{children:`URL apontando para o recurso completo com os detalhes do pedido.`})}),`\n`,_jsx(ResponseField,{name:`createdAt`,type:`string (date-time)`,id:`param-created-at`,children:_jsxs(_components.p,{children:[`Timestamp ISO 8601 de criação do `,_jsx(_components.strong,{children:`pedido`}),` (por exemplo, `,_jsx(_components.code,{children:`2019-08-24T14:15:22.000000Z`}),`). O valor não muda quando o evento muda.`]})}),`\n`,_jsx(ResponseField,{name:`sourceAppId`,type:`string (uuid)`,id:`param-source-app-id`,children:_jsx(_components.p,{children:`Identificador da aplicação que originou este evento.`})}),`\n`,_jsx(ResponseField,{name:`virtualBrand`,type:`string`,id:`param-virtual-brand`,children:_jsx(_components.p,{children:`Marca virtual associada ao pedido, se aplicável.`})}),`\n`,_jsx(Heading,{level:`3`,id:`401-não-autorizado`,children:`401: Não autorizado`}),`\n`,_jsx(_components.p,{children:`Retornado quando a requisição não inclui credenciais de autenticação válidas.`}),`\n`,_jsx(Heading,{level:`3`,id:`429-limite-de-requisições`,children:`429: Limite de requisições`}),`\n`,_jsxs(_components.p,{children:[`A rota aceita até 200 requisições por minuto, num limite compartilhado com as outras rotas de leitura. Acima disso, a API responde `,_jsx(_components.code,{children:`{ \"title\": \"Too Many Requests\", \"status\": 429 }`}),`. Veja `,_jsx(_components.a,{href:`/api-reference/errors#limite-de-requisi%C3%A7%C3%B5es`,children:`Limite de requisições`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-requisição`,children:`Exemplo de requisição`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Sandbox`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.dev.connect.onbeefapp.com.br/v1/events:polling?eventType=CREATED\u0026eventType=CONFIRMED\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003ctoken>\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Produção`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.connect.onbeefapp.com.br/v1/events:polling?eventType=CREATED\u0026eventType=CONFIRMED\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003ctoken>\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-resposta`,children:`Exemplo de resposta`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"eventId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"d6703cc8-9e79-415d-ac03-a4dc7f6ab43c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"eventType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CREATED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"orderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f47ac10b-58cc-4372-a567-0e02b2c3d479\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"orderURL\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2019-08-24T14:15:22.000000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sourceAppId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fb08c6b7-a844-43c6-b104-98e70c00fc20\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"virtualBrand\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Confirme cada evento assim que terminar de processá-lo. Um evento não confirmado pode reaparecer enquanto continuar sendo o evento atual do pedido. Se o status mudar antes do acknowledgment, o novo evento substituirá o anterior, que não será retornado novamente.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Recomendamos fazer polling neste endpoint a cada 30 segundos durante o horário de operação. Use o filtro `,_jsx(_components.code,{children:`eventType`}),` para limitar a resposta apenas aos tipos que sua integração precisa tratar.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Consulte eventos","sidebarTitle":"Consultar eventos","description":"Obtenha os eventos pendentes.","api":"GET /v1/events:polling","href":"/api-reference/orders/get-events"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Como o polling funciona","slug":"como-o-polling-funciona","depth":2,"children":[]},{"title":"Parâmetros de consulta","slug":"parâmetros-de-consulta","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[{"title":"200: Sucesso","slug":"200-sucesso","depth":3,"children":[]},{"title":"401: Não autorizado","slug":"401-não-autorizado","depth":3,"children":[]},{"title":"429: Limite de requisições","slug":"429-limite-de-requisições","depth":3,"children":[]}]},{"title":"Exemplo de requisição","slug":"exemplo-de-requisição","depth":2,"children":[]},{"title":"Exemplo de resposta","slug":"exemplo-de-resposta","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Consulte eventos","path":"/v1/events:polling","servers":[{"url":"https://api.dev.connect.onbeefapp.com.br"},{"url":"https://api.connect.onbeefapp.com.br"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{"eventType":{"schema":[{"type":"array","items":[{"type":"string"}],"description":"Filtra eventos por tipo. Repita o parâmetro para informar vários tipos ( `?eventType=CREATED\u0026eventType=CONFIRMED` ). Eventos cujo tipo atual não está no filtro não aparecem nesta resposta. O filtro não confirma esses eventos. Se um pedido mudar de status, o novo evento substituirá o anterior e será avaliado pelos filtros da próxima consulta. Omita este parâmetro para receber todos os tipos de eventos pendentes. Valores aceitos: `CREATED` : O pedido foi criado. `CONFIRMED` : O pedido foi confirmado pelo merchant. `READY_FOR_PICKUP` : O pedido está pronto para retirada pelo entregador ou cliente. `DISPATCHED` : O pedido saiu da loja para entrega. `PICKUP_AREA_ASSIGNED` : Uma área de retirada foi designada para o pedido. `DELIVERED` : O pedido foi entregue ao cliente. `CONCLUDED` : O ciclo de vida do pedido está concluído. `CANCELLATION_REQUESTED` : O próprio PDV solicitou o cancelamento com `POST /v1/orders/{orderId}/requestCancellation` . Este evento não exige resposta. `CANCELLATION_REQUEST_DENIED` : O Ordering Application negou a solicitação de cancelamento. `CANCELLED` : O pedido foi efetivamente cancelado. `ORDER_CANCELLATION_REQUEST` : O cliente solicitou o cancelamento pela plataforma. Responda com `acceptCancellation` ou `denyCancellation` . `CANCELLED_DENIED` : O Software Service negou a solicitação de cancelamento do Ordering Application."}]},"start_at":{"schema":[{"type":"object","properties":{},"description":"Filtro de data/hora inicial pela data de criação do pedido (não do evento). Limite inclusivo. Um pedido criado antes da janela não aparece, mesmo que o evento atual dele seja recente. Formatos aceitos: `Y-m-d` : usa o início do dia, às `00:00:00` , no horário local da loja. `Y-m-d H:i` : o horário é interpretado como UTC (horário universal) e convertido para o horário de Brasília, o que recua a janela em 3 horas. Por exemplo, `2026-07-01 00:00` filtra a partir de `2026-06-30 21:00:00` ."}]},"end_at":{"schema":[{"type":"object","properties":{},"description":"Filtro de data/hora final pela data de criação do pedido (não do evento). Limite inclusivo. Formatos aceitos: `Y-m-d` : usa o fim do dia, às `23:59:59` , no horário local da loja. `Y-m-d H:i` : o horário é interpretado como UTC (horário universal) e convertido para o horário de Brasília, o que recua a janela em 3 horas. O corte ocorre no segundo `00` do minuto informado, porque o parâmetro não aceita segundos."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"eventId":[{"type":"object","properties":{},"description":"Identificador do tipo de evento. Todos os pedidos com o mesmo `eventType` compartilham esse valor. Um evento de pedido é identificado pelo par `orderId` e `eventId` . Use sempre os dois valores ao confirmar ou deduplicar eventos. Nunca deduplique apenas por `eventId` ."}],"eventType":[{"type":"string","description":"Tipo do evento (por exemplo, `CREATED` , `CONFIRMED` , `CANCELLED` )."}],"orderId":[{"type":"object","properties":{},"description":"Identificador único do pedido associado a este evento, gerado pela Onbeef."}],"orderURL":[{"type":"object","properties":{},"description":"URL apontando para o recurso completo com os detalhes do pedido."}],"createdAt":[{"type":"object","properties":{},"description":"Timestamp ISO 8601 de criação do pedido (por exemplo, `2019-08-24T14:15:22.000000Z` ). O valor não muda quando o evento muda."}],"sourceAppId":[{"type":"object","properties":{},"description":"Identificador da aplicação que originou este evento."}],"virtualBrand":[{"type":"string","description":"Marca virtual associada ao pedido, se aplicável."}]}}],"examples":{"example":{"value":{"eventId":{},"eventType":"\u003cstring>","orderId":{},"orderURL":{},"createdAt":{},"sourceAppId":{},"virtualBrand":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"onbeef","siteName":"Onbeef Connect API","title":"Consulte eventos - Onbeef Connect API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-10T17:48:37.832Z","originalFileLocation":"api-reference/orders/get-events.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Obtenha os eventos pendentes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Onbeef Connect API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Consulte eventos - Onbeef Connect API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Obtenha os eventos pendentes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Onbeef Connect API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.onbeef.app/api-reference/orders/get-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onbeef.mintlify.site/_mintlify/api/og/v2?division=Pedidos\u0026amp;title=Consulte+eventos\u0026amp;description=Obtenha+os+eventos+pendentes.\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=ca4c7f72f03a9d10b8cd2063548b7d3eda945ca8b5fc56cf51f7963580c7be72\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Consulte eventos - Onbeef Connect API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Obtenha os eventos pendentes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onbeef.mintlify.site/_mintlify/api/og/v2?division=Pedidos\u0026amp;title=Consulte+eventos\u0026amp;description=Obtenha+os+eventos+pendentes.\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=ca4c7f72f03a9d10b8cd2063548b7d3eda945ca8b5fc56cf51f7963580c7be72\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onbeef/WscjZRN3uA8giNWJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Onbeef Connect API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8102E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.onbeef.app/api-reference/orders/get-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/orders/get-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.onbeef.app/#organization\",\"name\":\"Onbeef Connect API\",\"url\":\"https://docs.onbeef.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.onbeef.app.br/logo.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.onbeef.app#website\",\"name\":\"Onbeef Connect API\",\"url\":\"https://docs.onbeef.app\",\"publisher\":{\"@id\":\"https://docs.onbeef.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.onbeef.app/api-reference/orders/get-events#webpage\",\"url\":\"https://docs.onbeef.app/api-reference/orders/get-events\",\"name\":\"Consulte eventos\",\"description\":\"Obtenha os eventos pendentes.\",\"dateModified\":\"2026-08-10T17:48:37.832Z\",\"isPartOf\":{\"@id\":\"https://docs.onbeef.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onbeef.app/api-reference/orders/get-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onbeef.app/api-reference/orders/get-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Onbeef Connect API\",\"item\":\"https://docs.onbeef.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Consulte eventos\",\"item\":\"https://docs.onbeef.app/api-reference/orders/get-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.onbeef.app/api-reference/orders/get-events#apireference\",\"headline\":\"Consulte eventos\",\"name\":\"Consulte eventos\",\"description\":\"Obtenha os eventos pendentes.\",\"url\":\"https://docs.onbeef.app/api-reference/orders/get-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onbeef.app/api-reference/orders/get-events#webpage\"},\"dateModified\":\"2026-08-10T17:48:37.832Z\",\"publisher\":{\"@id\":\"https://docs.onbeef.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.onbeef.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Onbeef Connect API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Onbeef Connect API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/orders/get-events.md","siteName":"Onbeef Connect API","nav":{"global":null,"tabs":[{"tab":"Comece aqui","pages":[{"title":"Comece aqui","href":""}]},{"tab":"Catálogo","pages":[{"title":"Catálogo","href":"/concepts/merchant"}]},{"tab":"Pedidos","pages":[{"title":"Pedidos","href":"/concepts/orders"}]},{"tab":"Logística","pages":[{"title":"Logística","href":"/concepts/logistics"}]},{"tab":"Referência","groups":[{"group":"Visão geral","pages":[{"title":"Referência da API","sidebarTitle":"Visão geral","href":"/api-reference/overview"},{"title":"Trate erros da API","sidebarTitle":"Erros","href":"/api-reference/errors"}]},{"group":"Autenticação","pages":[{"title":"Obtenha um token de acesso","sidebarTitle":"Obter token de acesso","api":"POST /oauth/token","href":"/api-reference/auth/token"}]},{"group":"Merchant","pages":[{"title":"Consulte o merchant","sidebarTitle":"Obter merchant","api":"GET /v1/merchant","href":"/api-reference/merchant/get-merchant"},{"title":"Consulte a sincronização","sidebarTitle":"Status da sincronização","api":"GET /v1/merchantStatus","href":"/api-reference/merchant/get-status"},{"title":"Configure o webhook de pedidos","sidebarTitle":"Configurar webhook","api":"PUT /v1/merchantOnboarding","href":"/api-reference/merchant/update-merchant"},{"title":"Sincronize o catálogo","sidebarTitle":"Sincronizar catálogo","description":"Envie categorias, itens e ofertas. Produtos são localizados pelo pdv_external_id: MERCHANT cria e remove, ITEM atualiza o cadastro, ITEM_OFFER atualiza preço e disponibilidade.","api":"PUT /v1/merchantUpdate","href":"/api-reference/merchant/sync-catalog"}]},{"group":"Pedidos","pages":[{"title":"Consulte eventos","sidebarTitle":"Consultar eventos","api":"GET /v1/events:polling","href":"/api-reference/orders/get-events"},{"title":"Confirme eventos","sidebarTitle":"Confirmar eventos","description":"Confirme os eventos que você processou.","api":"POST /v1/events/acknowledgment","href":"/api-reference/orders/confirm-events"},{"title":"Consulte um pedido","sidebarTitle":"Consultar pedido","api":"GET /v1/orders/{orderId}","href":"/api-reference/orders/get-order"},{"title":"Confirme um pedido","sidebarTitle":"Confirmar pedido","api":"POST /v1/orders/{orderId}/confirm","href":"/api-reference/orders/confirm"},{"title":"Marque o pedido como pronto","sidebarTitle":"Pronto para retirada","api":"POST /v1/orders/{orderId}/readyForPickup","href":"/api-reference/orders/ready-for-pickup"},{"title":"Despache um pedido","sidebarTitle":"Despachar pedido","api":"POST /v1/orders/{orderId}/dispatch","href":"/api-reference/orders/dispatch"},{"title":"Conclua um pedido","sidebarTitle":"Marcar como entregue","api":"POST /v1/orders/{orderId}/delivered","href":"/api-reference/orders/delivered"},{"title":"Valide o código de entrega","sidebarTitle":"Validar código de entrega","api":"POST /v1/orders/{orderId}/validateCode","href":"/api-reference/orders/validate-delivery-code"},{"title":"Cancele um pedido","sidebarTitle":"Cancelar pedido","api":"POST /v1/orders/{orderId}/requestCancellation","href":"/api-reference/orders/request-cancellation"},{"title":"Aceite um cancelamento","sidebarTitle":"Aceitar cancelamento","api":"POST /v1/orders/{orderId}/acceptCancellation","href":"/api-reference/orders/accept-cancellation"},{"title":"Negue um cancelamento","sidebarTitle":"Negar cancelamento","api":"POST /v1/orders/{orderId}/denyCancellation","href":"/api-reference/orders/deny-cancellation"},{"title":"Atualize o rastreamento","sidebarTitle":"Atualizar rastreamento","api":"POST /v1/orders/{orderId}/tracking","href":"/api-reference/orders/delivery-updates"}]},{"group":"Logística","pages":[{"title":"Envie um evento de entrega","sidebarTitle":"Enviar evento","api":"POST /v1/logistics/deliveryUpdate","href":"/api-reference/logistics/order-event-notification"},{"title":"Confirme o código de entrega","sidebarTitle":"Confirmar código","api":"POST /v1/logistics/confirmationCode","href":"/api-reference/logistics/delivery-confirmation-code"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Consulte eventos - Onbeef Connect API","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-dD8DedlW.js","utils-BgJ6PauS.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-m4sNRkou.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dg97LVEU.js","snippetPresets-C6CxWGOo.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CKiRf67B.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CDY0tBIx.js","shallow-BHHaYlmm.js","getApiPlaygroundDisplay-D6K3-cVX.js","CodeSnippet-BrS3fDep.js","CodeSnippets-Dkf1llUu.js","Page-DOwQSAHT.js","getPastedJson-3JcMsaes.js","icon-CWSTKRsN.js","MethodPill-t_TXGK5I.js","DuplicateIcon-DcjhdAbh.js","createIcon-2JHmGxKn.js","DynamicMarkdown-DMUWO-az.js","SectionHeading-DxvGHAss.js","axios-vUo_bRtp.js"]}