Envie uma atualização quando o estado da entrega mudar. A Onbeef usa esses eventos para manter o rastreamento sincronizado.
Autenticação
Os endpoints de logística não usam o Bearer token OAuth. Eles são autenticados por três headers HTTP, validados a cada requisição:
string (uuid)
required
Identificador da sua aplicação de logística (UUID v4).
string
required
UUID do merchant na plataforma Onbeef (entre 36 e 100 caracteres).
string
required
Assinatura HMAC-SHA256 (hex, 64 caracteres) do corpo cru da requisição. A chave é o client_secret fornecido no provisionamento da sua integração de logística. Não use o client_secret OAuth do merchant: são credenciais diferentes.
A assinatura é calculada sobre o corpo exato enviado. Gere o JSON, calcule o HMAC-SHA256 desse mesmo texto e só então envie a requisição. Qualquer diferença de formatação invalida a assinatura.
Corpo da requisição
O corpo da requisição deve ser enviado como application/json.
string (uuid)
required
Identificador único da entrega, gerado pelo seu serviço de logística.
string (uuid)
required
Identificador do pedido, gerado pela Onbeef. Associa o evento de entrega ao pedido correto na plataforma.
string
required
Identificador legível do pedido exibido na interface da Onbeef.
object
required
Informações sobre o merchant associado ao pedido. Contém id (uuid) e name (string).
datetime (string, date-time): Timestamp ISO 8601 de quando o evento ocorreu.
rejectionInfo (object, opcional): Presente quando type é REJECTED, com um campo reason.
string
required
Nome do cliente que receberá a entrega.
object
Informações do veículo: type, container, containerSize, instruction.
object
Informações de preço da entrega: price (value, currency), pricingList, additionalPricePercentual.
object
Dados de tempo estimado de chegada: pickupEtaInMinutes, pickupEtaDatetime, deliveryEtaInMinutes, deliveryEtaDatetime, maxDeliveryTime, entre outros.
object
Informações do entregador: id (uuid), name, pictureURL, phone.
object
Localização em tempo real do entregador: latitude, longitude, lastAddress.
string (uri)
URL externa do seu serviço de logística para acompanhamento em tempo real.
array of strings (uuid)
IDs adicionais de pedidos do mesmo merchant na mesma rota (mesmo deliveryId).
Este endpoint não valida os campos do corpo com um schema estrito. Envie o payload completo conforme descrito acima; campos ausentes usados pelo processamento podem causar erro no servidor.
Resposta
204: Sem conteúdo
O evento foi recebido e processado com sucesso. Nenhum corpo de resposta é retornado.
400: Requisição inválida
Um dos headers X-App-Id, X-App-MerchantId ou X-App-Signature está ausente ou malformado.
401: Não autorizado
O X-App-Id ou o X-App-MerchantId não foi reconhecido, a integração não está ativa, ou a assinatura X-App-Signature não confere.
404: Não encontrado
Nenhum pedido foi encontrado com o orderId informado para este merchant. Corpo: { "title": "Order not found", "status": 404 }.
429: Limite de requisições
A rota aceita até 120 requisições por minuto por endereço IP, num limite compartilhado com POST /v1/logistics/confirmationCode. Acima disso, a API responde { "title": "Too Many Requests", "status": 429 }. Aguarde e reenvie. Veja Limite de requisições.
Tipos de evento
O campo event.type sinaliza o estágio atual da entrega. Dois valores transicionam o status do pedido na Onbeef:
Tipo
Efeito no pedido
DELIVERY_ONGOING
Marca o pedido como despachado (a caminho do cliente).
DELIVERY_FINISHED
Marca o pedido como entregue.
Os demais valores (por exemplo, PENDING, REJECTED, CANCELLED, e outros estados de retirada/atribuição) são registrados para rastreamento, mas não alteram o status do pedido. Para REJECTED, inclua event.rejectionInfo.reason.
Este endpoint é chamado pela sua integração de logística atuando como remetente de webhook. Não é um endpoint de polling: seu sistema envia atualizações à Onbeef a cada mudança de status da entrega.
{"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/logistics/order-event-notification","slug":"/api-reference/logistics/order-event-notification","pageMetadata":{"title":"Envie um evento de entrega","sidebarTitle":"Enviar evento","description":"Atualize o estado de uma entrega.","api":"POST /v1/logistics/deliveryUpdate","authMethod":"none","href":"/api-reference/logistics/order-event-notification"},"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: \"Atualize o estado de uma entrega.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Envie uma atualização quando o estado da entrega mudar. A Onbeef usa esses eventos para manter o rastreamento sincronizado.`}),`\n`,_jsx(Heading,{level:`2`,id:`autenticação`,children:`Autenticação`}),`\n`,_jsxs(_components.p,{children:[`Os endpoints de logística `,_jsx(_components.strong,{children:`não`}),` usam o Bearer token OAuth. Eles são autenticados por três headers HTTP, validados a cada requisição:`]}),`\n`,_jsx(ParamField,{header:`X-App-Id`,type:`string (uuid)`,required:true,id:`param-x-app-id`,children:_jsx(_components.p,{children:`Identificador da sua aplicação de logística (UUID v4).`})}),`\n`,_jsx(ParamField,{header:`X-App-MerchantId`,type:`string`,required:true,id:`param-x-app-merchant-id`,children:_jsx(_components.p,{children:`UUID do merchant na plataforma Onbeef (entre 36 e 100 caracteres).`})}),`\n`,_jsx(ParamField,{header:`X-App-Signature`,type:`string`,required:true,id:`param-x-app-signature`,children:_jsxs(_components.p,{children:[`Assinatura HMAC-SHA256 (hex, 64 caracteres) do `,_jsx(_components.strong,{children:`corpo cru`}),` da requisição. A chave é o `,_jsx(_components.code,{children:`client_secret`}),` fornecido no provisionamento da sua integração de logística. Não use o `,_jsx(_components.code,{children:`client_secret`}),` OAuth do merchant: são credenciais diferentes.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-App-Signature = hex( hmac_sha256( corpo_cru_da_requisicao, client_secret ) )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A assinatura é calculada sobre o corpo exato enviado. Gere o JSON, calcule o HMAC-SHA256 desse mesmo texto e só então envie a requisição. Qualquer diferença de formatação invalida a assinatura.`})}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsxs(_components.p,{children:[`O corpo da requisição deve ser enviado como `,_jsx(_components.code,{children:`application/json`}),`.`]}),`\n`,_jsx(ParamField,{body:`deliveryId`,type:`string (uuid)`,required:true,id:`param-delivery-id`,children:_jsx(_components.p,{children:`Identificador único da entrega, gerado pelo seu serviço de logística.`})}),`\n`,_jsx(ParamField,{body:`orderId`,type:`string (uuid)`,required:true,id:`param-order-id`,children:_jsx(_components.p,{children:`Identificador do pedido, gerado pela Onbeef. Associa o evento de entrega ao pedido correto na plataforma.`})}),`\n`,_jsx(ParamField,{body:`orderDisplayId`,type:`string`,required:true,id:`param-order-display-id`,children:_jsx(_components.p,{children:`Identificador legível do pedido exibido na interface da Onbeef.`})}),`\n`,_jsx(ParamField,{body:`merchant`,type:`object`,required:true,id:`param-merchant`,children:_jsxs(_components.p,{children:[`Informações sobre o merchant associado ao pedido. Contém `,_jsx(_components.code,{children:`id`}),` (uuid) e `,_jsx(_components.code,{children:`name`}),` (string).`]})}),`\n`,_jsxs(ParamField,{body:`event`,type:`object`,required:true,id:`param-event`,children:[_jsx(_components.p,{children:`Detalhes do evento atual da entrega. Contém:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`type`}),` (string): Tipo do evento. Veja `,_jsx(_components.a,{href:`#tipos-de-evento`,children:`Tipos de evento`}),` abaixo.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`message`}),` (string): Descrição legível do evento.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`datetime`}),` (string, date-time): Timestamp ISO 8601 de quando o evento ocorreu.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rejectionInfo`}),` (object, opcional): Presente quando `,_jsx(_components.code,{children:`type`}),` é `,_jsx(_components.code,{children:`REJECTED`}),`, com um campo `,_jsx(_components.code,{children:`reason`}),`.`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`customerName`,type:`string`,required:true,id:`param-customer-name`,children:_jsx(_components.p,{children:`Nome do cliente que receberá a entrega.`})}),`\n`,_jsx(ParamField,{body:`vehicle`,type:`object`,id:`param-vehicle`,children:_jsxs(_components.p,{children:[`Informações do veículo: `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`container`}),`, `,_jsx(_components.code,{children:`containerSize`}),`, `,_jsx(_components.code,{children:`instruction`}),`.`]})}),`\n`,_jsx(ParamField,{body:`deliveryPrice`,type:`object`,id:`param-delivery-price`,children:_jsxs(_components.p,{children:[`Informações de preço da entrega: `,_jsx(_components.code,{children:`price`}),` (`,_jsx(_components.code,{children:`value`}),`, `,_jsx(_components.code,{children:`currency`}),`), `,_jsx(_components.code,{children:`pricingList`}),`, `,_jsx(_components.code,{children:`additionalPricePercentual`}),`.`]})}),`\n`,_jsx(ParamField,{body:`eta`,type:`object`,id:`param-eta`,children:_jsxs(_components.p,{children:[`Dados de tempo estimado de chegada: `,_jsx(_components.code,{children:`pickupEtaInMinutes`}),`, `,_jsx(_components.code,{children:`pickupEtaDatetime`}),`, `,_jsx(_components.code,{children:`deliveryEtaInMinutes`}),`, `,_jsx(_components.code,{children:`deliveryEtaDatetime`}),`, `,_jsx(_components.code,{children:`maxDeliveryTime`}),`, entre outros.`]})}),`\n`,_jsx(ParamField,{body:`deliveryPerson`,type:`object`,id:`param-delivery-person`,children:_jsxs(_components.p,{children:[`Informações do entregador: `,_jsx(_components.code,{children:`id`}),` (uuid), `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`pictureURL`}),`, `,_jsx(_components.code,{children:`phone`}),`.`]})}),`\n`,_jsx(ParamField,{body:`geoLocalization`,type:`object`,id:`param-geo-localization`,children:_jsxs(_components.p,{children:[`Localização em tempo real do entregador: `,_jsx(_components.code,{children:`latitude`}),`, `,_jsx(_components.code,{children:`longitude`}),`, `,_jsx(_components.code,{children:`lastAddress`}),`.`]})}),`\n`,_jsx(ParamField,{body:`externalTrackingURL`,type:`string (uri)`,id:`param-external-tracking-url`,children:_jsx(_components.p,{children:`URL externa do seu serviço de logística para acompanhamento em tempo real.`})}),`\n`,_jsx(ParamField,{body:`combinedOrdersIds`,type:`array of strings (uuid)`,id:`param-combined-orders-ids`,children:_jsxs(_components.p,{children:[`IDs adicionais de pedidos do mesmo merchant na mesma rota (mesmo `,_jsx(_components.code,{children:`deliveryId`}),`).`]})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Este endpoint não valida os campos do corpo com um schema estrito. Envie o payload completo conforme descrito acima; campos ausentes usados pelo processamento podem causar erro no servidor.`})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(Heading,{level:`3`,id:`204-sem-conteúdo`,children:`204: Sem conteúdo`}),`\n`,_jsx(_components.p,{children:`O evento foi recebido e processado com sucesso. Nenhum corpo de resposta é retornado.`}),`\n`,_jsx(Heading,{level:`3`,id:`400-requisição-inválida`,children:`400: Requisição inválida`}),`\n`,_jsxs(_components.p,{children:[`Um dos headers `,_jsx(_components.code,{children:`X-App-Id`}),`, `,_jsx(_components.code,{children:`X-App-MerchantId`}),` ou `,_jsx(_components.code,{children:`X-App-Signature`}),` está ausente ou malformado.`]}),`\n`,_jsx(Heading,{level:`3`,id:`401-não-autorizado`,children:`401: Não autorizado`}),`\n`,_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`X-App-Id`}),` ou o `,_jsx(_components.code,{children:`X-App-MerchantId`}),` não foi reconhecido, a integração não está ativa, ou a assinatura `,_jsx(_components.code,{children:`X-App-Signature`}),` não confere.`]}),`\n`,_jsx(Heading,{level:`3`,id:`404-não-encontrado`,children:`404: Não encontrado`}),`\n`,_jsxs(_components.p,{children:[`Nenhum pedido foi encontrado com o `,_jsx(_components.code,{children:`orderId`}),` informado para este merchant. Corpo: `,_jsx(_components.code,{children:`{ \"title\": \"Order not found\", \"status\": 404 }`}),`.`]}),`\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é 120 requisições por minuto por endereço IP, num limite compartilhado com `,_jsx(_components.code,{children:`POST /v1/logistics/confirmationCode`}),`. Acima disso, a API responde `,_jsx(_components.code,{children:`{ \"title\": \"Too Many Requests\", \"status\": 429 }`}),`. Aguarde e reenvie. 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:`tipos-de-evento`,children:`Tipos de evento`}),`\n`,_jsxs(_components.p,{children:[`O campo `,_jsx(_components.code,{children:`event.type`}),` sinaliza o estágio atual da entrega. Dois valores transicionam o status do pedido na Onbeef:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Efeito no pedido`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DELIVERY_ONGOING`})}),_jsx(_components.td,{children:`Marca o pedido como despachado (a caminho do cliente).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DELIVERY_FINISHED`})}),_jsx(_components.td,{children:`Marca o pedido como entregue.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Os demais valores (por exemplo, `,_jsx(_components.code,{children:`PENDING`}),`, `,_jsx(_components.code,{children:`REJECTED`}),`, `,_jsx(_components.code,{children:`CANCELLED`}),`, e outros estados de retirada/atribuição) são registrados para rastreamento, mas não alteram o status do pedido. Para `,_jsx(_components.code,{children:`REJECTED`}),`, inclua `,_jsx(_components.code,{children:`event.rejectionInfo.reason`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-requisição`,children:`Exemplo de requisição`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,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:`21`,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:` POST`}),_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/logistics/deliveryUpdate\"`}),_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:` \"Content-Type: application/json\"`}),_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:` \"X-App-Id: \u003capp_uuid>\"`}),_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:` \"X-App-MerchantId: \u003cmerchant_id>\"`}),_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:` \"X-App-Signature: \u003chmac_sha256_do_corpo>\"`}),_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:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"deliveryId\": \"73dc828d-801d-4d29-b7e4-e046662a5901\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"orderId\": \"b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"orderDisplayId\": \"ORD-0042\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"merchant\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"id\": \"497f6eca-6276-4993-bfeb-53cbbbba6f08\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Açougue do João\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"event\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"DELIVERY_ONGOING\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"message\": \"Pedido a caminho do cliente.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"datetime\": \"2024-08-24T14:15:22Z\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customerName\": \"Maria Silva\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Este endpoint é chamado pela sua integração de logística atuando como remetente de webhook. Não é um endpoint de polling: seu sistema envia atualizações à Onbeef a cada mudança de status da entrega.`})})]})}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":"Envie um evento de entrega","sidebarTitle":"Enviar evento","description":"Atualize o estado de uma entrega.","api":"POST /v1/logistics/deliveryUpdate","authMethod":"none","href":"/api-reference/logistics/order-event-notification"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Autenticação","slug":"autenticação","depth":2,"children":[]},{"title":"Corpo da requisição","slug":"corpo-da-requisição","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[{"title":"204: Sem conteúdo","slug":"204-sem-conteúdo","depth":3,"children":[]},{"title":"400: Requisição inválida","slug":"400-requisição-inválida","depth":3,"children":[]},{"title":"401: Não autorizado","slug":"401-não-autorizado","depth":3,"children":[]},{"title":"404: Não encontrado","slug":"404-não-encontrado","depth":3,"children":[]},{"title":"429: Limite de requisições","slug":"429-limite-de-requisições","depth":3,"children":[]}]},{"title":"Tipos de evento","slug":"tipos-de-evento","depth":2,"children":[]},{"title":"Exemplo de requisição","slug":"exemplo-de-requisição","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Envie um evento de entrega","path":"/v1/logistics/deliveryUpdate","servers":[{"url":"https://api.dev.connect.onbeefapp.com.br"},{"url":"https://api.connect.onbeefapp.com.br"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"X-App-Id":{"schema":[{"type":"object","properties":{},"description":"Identificador da sua aplicação de logística (UUID v4).","required":true}]},"X-App-MerchantId":{"schema":[{"type":"string","description":"UUID do merchant na plataforma Onbeef (entre 36 e 100 caracteres).","required":true}]},"X-App-Signature":{"schema":[{"type":"string","description":"Assinatura HMAC-SHA256 (hex, 64 caracteres) do corpo cru da requisição. A chave é o `client_secret` fornecido no provisionamento da sua integração de logística. Não use o `client_secret` OAuth do merchant: são credenciais diferentes.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"deliveryId":[{"type":"object","properties":{},"description":"Identificador único da entrega, gerado pelo seu serviço de logística.","required":true}],"orderId":[{"type":"object","properties":{},"description":"Identificador do pedido, gerado pela Onbeef. Associa o evento de entrega ao pedido correto na plataforma.","required":true}],"orderDisplayId":[{"type":"string","description":"Identificador legível do pedido exibido na interface da Onbeef.","required":true}],"merchant":[{"type":"object","properties":{},"description":"Informações sobre o merchant associado ao pedido. Contém `id` (uuid) e `name` (string).","required":true}],"event":[{"type":"object","properties":{},"description":"Detalhes do evento atual da entrega. Contém: `type` (string): Tipo do evento. Veja Tipos de evento abaixo. `message` (string): Descrição legível do evento. `datetime` (string, date-time): Timestamp ISO 8601 de quando o evento ocorreu. `rejectionInfo` (object, opcional): Presente quando `type` é `REJECTED` , com um campo `reason` .","required":true}],"customerName":[{"type":"string","description":"Nome do cliente que receberá a entrega.","required":true}],"vehicle":[{"type":"object","properties":{},"description":"Informações do veículo: `type` , `container` , `containerSize` , `instruction` ."}],"deliveryPrice":[{"type":"object","properties":{},"description":"Informações de preço da entrega: `price` ( `value` , `currency` ), `pricingList` , `additionalPricePercentual` ."}],"eta":[{"type":"object","properties":{},"description":"Dados de tempo estimado de chegada: `pickupEtaInMinutes` , `pickupEtaDatetime` , `deliveryEtaInMinutes` , `deliveryEtaDatetime` , `maxDeliveryTime` , entre outros."}],"deliveryPerson":[{"type":"object","properties":{},"description":"Informações do entregador: `id` (uuid), `name` , `pictureURL` , `phone` ."}],"geoLocalization":[{"type":"object","properties":{},"description":"Localização em tempo real do entregador: `latitude` , `longitude` , `lastAddress` ."}],"externalTrackingURL":[{"type":"object","properties":{},"description":"URL externa do seu serviço de logística para acompanhamento em tempo real."}],"combinedOrdersIds":[{"type":"object","properties":{},"description":"IDs adicionais de pedidos do mesmo merchant na mesma rota (mesmo `deliveryId` )."}]}}],"examples":{"example":{"value":{"deliveryId":{},"orderId":{},"orderDisplayId":"\u003cstring>","merchant":{},"event":{},"customerName":"\u003cstring>","vehicle":{},"deliveryPrice":{},"eta":{},"deliveryPerson":{},"geoLocalization":{},"externalTrackingURL":{},"combinedOrdersIds":{}}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"onbeef","siteName":"Onbeef Connect API","title":"Envie um evento de entrega - Onbeef Connect API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-10T17:48:37.834Z","originalFileLocation":"api-reference/logistics/order-event-notification.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=\"Atualize o estado de uma entrega.\">\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=\"Envie um evento de entrega - Onbeef Connect API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Atualize o estado de uma entrega.\">\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/logistics/order-event-notification\">\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=Log%C3%ADstica\u0026amp;title=Envie+um+evento+de+entrega\u0026amp;description=Atualize+o+estado+de+uma+entrega.\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=dab6b192d6fe0b7d4b9c73a72a9458426ded0f791a339537b94a4bd7a27c231f\">\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=\"Envie um evento de entrega - Onbeef Connect API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Atualize o estado de uma entrega.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onbeef.mintlify.site/_mintlify/api/og/v2?division=Log%C3%ADstica\u0026amp;title=Envie+um+evento+de+entrega\u0026amp;description=Atualize+o+estado+de+uma+entrega.\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=dab6b192d6fe0b7d4b9c73a72a9458426ded0f791a339537b94a4bd7a27c231f\">\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/logistics/order-event-notification\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/logistics/order-event-notification.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/logistics/order-event-notification#webpage\",\"url\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification\",\"name\":\"Envie um evento de entrega\",\"description\":\"Atualize o estado de uma entrega.\",\"dateModified\":\"2026-08-10T17:48:37.834Z\",\"isPartOf\":{\"@id\":\"https://docs.onbeef.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Onbeef Connect API\",\"item\":\"https://docs.onbeef.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Envie um evento de entrega\",\"item\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification#apireference\",\"headline\":\"Envie um evento de entrega\",\"name\":\"Envie um evento de entrega\",\"description\":\"Atualize o estado de uma entrega.\",\"url\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onbeef.app/api-reference/logistics/order-event-notification#webpage\"},\"dateModified\":\"2026-08-10T17:48:37.834Z\",\"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/logistics/order-event-notification.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","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","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","description":"Envie o estado de uma entrega.","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","description":"Valide o código de uma entrega.","api":"POST /v1/logistics/confirmationCode","href":"/api-reference/logistics/delivery-confirmation-code"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Envie um evento de entrega - 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"]}