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.
Envie o catálogo completo ou atualize itens e ofertas específicos. Escolha o formato de updatedObjects pelo campo entityType.A API responde de forma assíncrona. Depois do envio, consulte GET /v1/merchantStatus para verificar o resultado.
A configuração do webhook de pedidos é opcional para sincronizar o catálogo. Para receber notificações de pedidos, configure PUT /v1/merchantOnboarding e consulte o guia Webhook de pedidos.
Corpo da requisição
Envie um corpo application/json.
Campos comuns
string
required
Define o formato de updatedObjects. Valores aceitos:
MERCHANT: sincroniza a loja, as categorias, os itens e as ofertas em uma estrutura aninhada.
ITEM: atualiza produtos existentes em uma lista plana.
ITEM_OFFER: atualiza preço e disponibilidade de produtos existentes em uma lista plana.
string
Obrigatório quando entityType é MERCHANT. Valores aceitos: AVAILABLE e UNAVAILABLE.AVAILABLE liga a chave geral de recebimento de pedidos. UNAVAILABLE desliga essa chave e bloqueia novos pedidos no checkout.O campo não representa o horário de funcionamento. Uma loja pode estar AVAILABLE e não receber pedidos fora do horário cadastrado.Com ITEM ou ITEM_OFFER, o campo é aceito e ignorado.
boolean
default:"false"
Tem efeito apenas quando entityType é MERCHANT.
true: adiciona ou atualiza os dados enviados sem desassociar produtos nem remover registros do catálogo.
false: substitui as associações entre categorias e produtos pelo conteúdo enviado. Também permite remover do catálogo categorias e produtos vinculados ao PDV que não aparecem no payload.
Com ITEM ou ITEM_OFFER, o campo é ignorado.
O que cada entityType atualiza
Os três formatos têm alcances diferentes. Use a tabela para escolher:
ITEM_OFFER: o dia a dia de preço e disponibilidade.
Estoque não é atualizado por nenhum formato. O campo stock de GET /v1/merchant é apenas leitura.
Formato de updatedObjects
O conteúdo de updatedObjects muda conforme entityType. Não misture os formatos.
MERCHANT
ITEM
ITEM_OFFER
Use MERCHANT para enviar a estrutura aninhada da loja, com categorias, itens e ofertas.
array
required
Lista de objetos de loja. O primeiro objeto precisa conter id.
string
required
Identificador da loja no seu PDV. A Onbeef armazena esse valor como pdv_external_id.Se o primeiro objeto não tiver id, nada será processado e a sincronização terminará com FAIL.
array
Categorias do catálogo.
id (string, obrigatório): identificador estável da categoria no seu PDV.
name (string, obrigatório): nome de exibição da categoria.
index (integer): posição da categoria. Esse valor é usado apenas na criação.
status (string): AVAILABLE ou UNAVAILABLE.
itemOfferId (array of strings): IDs das ofertas associadas à categoria.
Apesar do nome no singular, itemOfferId recebe uma lista de IDs.Uma categoria sem id ou name é descartada e reportada como malformada.
array
Ofertas que relacionam itens às categorias e definem preço e disponibilidade.
id (string, obrigatório): identificador da oferta. Deve corresponder a um valor presente em category.itemOfferId.
itemId (string, obrigatório): identificador do item associado. Deve corresponder a item.id.
price.value (number, obrigatório): preço aplicado ao produto.
status (string): AVAILABLE ou UNAVAILABLE. Este campo define a disponibilidade do produto neste formato.
Uma oferta sem id não pode ser alcançada pelas categorias. Os produtos relacionados a ela são descartados e reportados como malformados.
array
Dados dos produtos referenciados pelas ofertas.
id (string, obrigatório): identificador estável do item no seu PDV. A Onbeef armazena esse valor como pdv_external_id do produto.
name (string, obrigatório): nome de exibição do produto. Usado apenas na criação: em produtos existentes, o nome cadastrado pelo lojista é preservado.
description (string): descrição do produto. Usada apenas na criação, como o name.
externalCode (string): código de balança do produto, usado pelos recursos de balança do painel. Não é usado para localizar produtos na integração.
ean (string): código de barras EAN. Apenas informativo.
unit (string): KG ou UN. Define o tipo do produto apenas na criação. Depois de definido, o tipo não pode ser alterado e novos valores são ignorados.
serving (integer): número de pessoas que a porção serve. Envie um número; texto é convertido para 0.
image (object): imagem no formato { "url": "https://..." }.
O item não carrega preço nem disponibilidade neste formato. Use itemOffer.price.value e itemOffer.status.
O encadeamento segue esta ordem: category.itemOfferId referencia itemOffer.id, e itemOffer.itemId referencia item.id. Um conjunto sem item correspondente, sem item.name ou sem itemOffer.price.value é descartado e reportado em moreInfo.
Quando onlyAddProducts é false, categorias e produtos vinculados ao PDV que não aparecem no payload podem ser removidos do catálogo. A remoção afeta apenas registros com pdv_external_id. Conteúdos criados manualmente pelo lojista no painel não são removidos.Imagens, cortes e vínculos de categoria associados aos registros removidos também são excluídos.Se qualquer objeto do payload estiver malformado, nenhuma remoção será executada nessa sincronização. O mesmo ocorre quando o payload não contém nenhuma categoria válida. Consulte moreInfo para identificar o problema.
Use ITEM para atualizar produtos já sincronizados. updatedObjects recebe uma lista plana, sem categories ou itemOffers.Este formato não cria produtos.
array
required
Lista plana de produtos existentes.
string
required
Identificador do produto no seu PDV. Deve corresponder ao pdv_external_id de um produto já sincronizado.Se o produto não existir no catálogo, o objeto será ignorado e reportado em moreInfo.
string
required
Nome de exibição do produto. Diferente do MERCHANT, aqui o nome sobrescreve o que está cadastrado no painel.
string
Descrição do produto. Quando enviada, sobrescreve a descrição cadastrada no painel.
string
Código de balança do produto, usado pelos recursos de balança do painel. Não é usado para localizar produtos na integração.
string
Código de barras EAN. Apenas informativo.
string
Disponibilidade aplicada ao produto. Valores aceitos: AVAILABLE e UNAVAILABLE.
string
Tipo do produto: KG ou UN. O valor só é aplicado quando o produto ainda não tem um tipo definido. Depois disso, alterações são ignoradas.
integer
Número de pessoas que a porção serve. Envie um número; texto é convertido para 0.
object
Informações nutricionais.
object
Imagem no formato { "url": "https://..." }.
ITEM não atualiza preços. Campos de preço enviados neste formato são ignorados. Use ITEM_OFFER para alterar o preço de um produto.
Use ITEM_OFFER para atualizar preço e disponibilidade de produtos já sincronizados. updatedObjects recebe uma lista plana de ofertas.Este formato não cria produtos.
array
required
Lista plana de ofertas.
string
required
Identificador do produto no seu PDV. Deve corresponder ao pdv_external_id de um produto já sincronizado.Se o produto não existir no catálogo, a oferta será ignorada e reportada em moreInfo.
number
required
Preço aplicado ao produto.
string
Disponibilidade aplicada ao produto. Valores aceitos: AVAILABLE e UNAVAILABLE.Se o campo for omitido ou tiver um valor diferente dos aceitos, o produto manterá a disponibilidade atual.
string
Campo aceito por compatibilidade, mas ignorado neste formato.
number
Campo aceito, mas ignorado.
string
Campo aceito, mas ignorado.
Produtos configurados pelo lojista como kits de preço aberto não recebem preço nem disponibilidade do PDV. A oferta inteira é ignorada e reportada em moreInfo.
Para ocultar temporariamente um produto sem removê-lo, defina o status da oferta como UNAVAILABLE. Em MERCHANT, use itemOffers[].status. Em ITEM_OFFER, use updatedObjects[].status.
Processamento e resultado
O processamento ocorre de forma assíncrona. Depois de receber o payload, a API enfileira a sincronização e responde com 204 No Content.
O status HTTP 204 confirma apenas que a requisição foi aceita e enfileirada. Ele não confirma que os dados foram aplicados.
A sincronização foi enfileirada ou está em processamento.
SUCCESS
Todos os objetos foram processados sem descartes.
FAIL
A sincronização falhou por completo ou terminou com objetos descartados. Consulte moreInfo.
moreInfo informa quantos objetos foram processados e descreve dados descartados ou problemas encontrados.
FAIL também pode representar sucesso parcial. Por exemplo, se 99 de 100 itens forem atualizados, o resultado será FAIL, mas as 99 alterações já terão sido aplicadas.Não reenvie o mesmo payload automaticamente em loop. Leia moreInfo, identifique o que foi aplicado ou descartado e corrija a próxima sincronização.
Campos da resposta
204: Sem conteúdo
A requisição foi recebida e enfileirada. A resposta não contém corpo.Consulte GET /v1/merchantStatus para saber se o processamento terminou com SUCCESS ou FAIL.
400: Requisição inválida
Um campo obrigatório está ausente ou com valor não aceito (por exemplo, entityType fora do enum, ou merchantStatus ausente com entityType: MERCHANT). O corpo informa o campo: { "title": "The merchant status field is required when entity type is MERCHANT.", "status": 400 }.
401: Não autorizado
Token ausente ou inválido. Reautentique-se e tente novamente. Veja Erros.
{"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/merchant/sync-catalog","slug":"/api-reference/merchant/sync-catalog","pageMetadata":{"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"},"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: \"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.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Note,ParamField,Tab,Table,Tabs,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Envie o catálogo completo ou atualize itens e ofertas específicos. Escolha o formato de `,_jsx(_components.code,{children:`updatedObjects`}),` pelo campo `,_jsx(_components.code,{children:`entityType`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A API responde de forma assíncrona. Depois do envio, consulte `,_jsx(_components.a,{href:`/api-reference/merchant/get-status`,children:_jsx(_components.code,{children:`GET /v1/merchantStatus`})}),` para verificar o resultado.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`A configuração do webhook de pedidos é opcional para sincronizar o catálogo. Para receber notificações de pedidos, configure `,_jsx(_components.a,{href:`/api-reference/merchant/update-merchant`,children:_jsx(_components.code,{children:`PUT /v1/merchantOnboarding`})}),` e consulte o guia `,_jsx(_components.a,{href:`/guides/orders-webhook`,children:`Webhook de pedidos`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsxs(_components.p,{children:[`Envie um corpo `,_jsx(_components.code,{children:`application/json`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`campos-comuns`,children:`Campos comuns`}),`\n`,_jsxs(ParamField,{body:`entityType`,type:`string`,required:true,id:`param-entity-type`,children:[_jsxs(_components.p,{children:[`Define o formato de `,_jsx(_components.code,{children:`updatedObjects`}),`. Valores aceitos:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`MERCHANT`}),`: sincroniza a loja, as categorias, os itens e as ofertas em uma estrutura aninhada.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ITEM`}),`: atualiza produtos existentes em uma lista plana.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ITEM_OFFER`}),`: atualiza preço e disponibilidade de produtos existentes em uma lista plana.`]}),`\n`]})]}),`\n`,_jsxs(ParamField,{body:`merchantStatus`,type:`string`,id:`param-merchant-status`,children:[_jsxs(_components.p,{children:[`Obrigatório quando `,_jsx(_components.code,{children:`entityType`}),` é `,_jsx(_components.code,{children:`MERCHANT`}),`. Valores aceitos: `,_jsx(_components.code,{children:`AVAILABLE`}),` e `,_jsx(_components.code,{children:`UNAVAILABLE`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`AVAILABLE`}),` liga a chave geral de recebimento de pedidos. `,_jsx(_components.code,{children:`UNAVAILABLE`}),` desliga essa chave e bloqueia novos pedidos no checkout.`]}),_jsxs(_components.p,{children:[`O campo não representa o horário de funcionamento. Uma loja pode estar `,_jsx(_components.code,{children:`AVAILABLE`}),` e não receber pedidos fora do horário cadastrado.`]}),_jsxs(_components.p,{children:[`Com `,_jsx(_components.code,{children:`ITEM`}),` ou `,_jsx(_components.code,{children:`ITEM_OFFER`}),`, o campo é aceito e ignorado.`]})]}),`\n`,_jsxs(ParamField,{body:`onlyAddProducts`,type:`boolean`,default:`false`,id:`param-only-add-products`,children:[_jsxs(_components.p,{children:[`Tem efeito apenas quando `,_jsx(_components.code,{children:`entityType`}),` é `,_jsx(_components.code,{children:`MERCHANT`}),`.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`true`}),`: adiciona ou atualiza os dados enviados sem desassociar produtos nem remover registros do catálogo.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`false`}),`: substitui as associações entre categorias e produtos pelo conteúdo enviado. Também permite remover do catálogo categorias e produtos vinculados ao PDV que não aparecem no payload.`]}),`\n`]}),_jsxs(_components.p,{children:[`Com `,_jsx(_components.code,{children:`ITEM`}),` ou `,_jsx(_components.code,{children:`ITEM_OFFER`}),`, o campo é ignorado.`]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`o-que-cada-entitytype-atualiza`,children:[`O que cada `,_jsx(_components.code,{children:`entityType`}),` atualiza`]}),`\n`,_jsx(_components.p,{children:`Os três formatos têm alcances diferentes. Use a tabela para escolher:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:_jsx(_components.code,{children:`MERCHANT`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`ITEM`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`ITEM_OFFER`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cria produtos e categorias`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Remove produtos e categorias ausentes`}),_jsxs(_components.td,{children:[`Sim, com `,_jsx(_components.code,{children:`onlyAddProducts: false`})]}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Preço`}),_jsxs(_components.td,{children:[`Sim (`,_jsx(_components.code,{children:`itemOffer.price.value`}),`)`]}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Sim`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Disponibilidade`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Sim`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Nome e descrição`}),_jsx(_components.td,{children:`Apenas na criação`}),_jsx(_components.td,{children:`Sim, sobrescreve o painel`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Imagem`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`EAN e código de balança`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Porção e informações nutricionais`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Não`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Tipo (`,_jsx(_components.code,{children:`unit`}),`)`]}),_jsx(_components.td,{children:`Apenas na criação`}),_jsx(_components.td,{children:`Apenas se ainda não definido`}),_jsx(_components.td,{children:`Não`})]})]})]}),`\n`,_jsx(_components.p,{children:`Recomendação de uso:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`MERCHANT`}),`: carga inicial e mudanças estruturais (novas categorias, novos produtos, remoções).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ITEM`}),`: dados cadastrais de produtos existentes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ITEM_OFFER`}),`: o dia a dia de preço e disponibilidade.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Estoque não é atualizado por nenhum formato. O campo `,_jsx(_components.code,{children:`stock`}),` de `,_jsx(_components.a,{href:`/api-reference/merchant/get-merchant`,children:_jsx(_components.code,{children:`GET /v1/merchant`})}),` é apenas leitura.`]})}),`\n`,_jsxs(Heading,{level:`2`,id:`formato-de-updatedobjects`,children:[`Formato de `,_jsx(_components.code,{children:`updatedObjects`})]}),`\n`,_jsxs(_components.p,{children:[`O conteúdo de `,_jsx(_components.code,{children:`updatedObjects`}),` muda conforme `,_jsx(_components.code,{children:`entityType`}),`. Não misture os formatos.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`MERCHANT`,id:`merchant`,\"data-child-heading-ids\":`[\"exemplo-de-payload\"]`,children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`MERCHANT`}),` para enviar a estrutura aninhada da loja, com categorias, itens e ofertas.`]}),_jsx(ParamField,{body:`updatedObjects`,type:`array`,required:true,id:`param-updated-objects`,children:_jsxs(_components.p,{children:[`Lista de objetos de loja. O primeiro objeto precisa conter `,_jsx(_components.code,{children:`id`}),`.`]})}),_jsxs(ParamField,{body:`updatedObjects[].id`,type:`string`,required:true,id:`param-updated-objects-id`,children:[_jsxs(_components.p,{children:[`Identificador da loja no seu PDV. A Onbeef armazena esse valor como `,_jsx(_components.code,{children:`pdv_external_id`}),`.`]}),_jsxs(_components.p,{children:[`Se o primeiro objeto não tiver `,_jsx(_components.code,{children:`id`}),`, nada será processado e a sincronização terminará com `,_jsx(_components.code,{children:`FAIL`}),`.`]})]}),_jsxs(ParamField,{body:`updatedObjects[].categories`,type:`array`,id:`param-updated-objects-categories`,children:[_jsx(_components.p,{children:`Categorias do catálogo.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`id`}),` (string, obrigatório): identificador estável da categoria no seu PDV.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`name`}),` (string, obrigatório): nome de exibição da categoria.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`index`}),` (integer): posição da categoria. Esse valor é usado apenas na criação.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`status`}),` (string): `,_jsx(_components.code,{children:`AVAILABLE`}),` ou `,_jsx(_components.code,{children:`UNAVAILABLE`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`itemOfferId`}),` (array of strings): IDs das ofertas associadas à categoria.`]}),`\n`]}),_jsxs(_components.p,{children:[`Apesar do nome no singular, `,_jsx(_components.code,{children:`itemOfferId`}),` recebe uma lista de IDs.`]}),_jsxs(_components.p,{children:[`Uma categoria sem `,_jsx(_components.code,{children:`id`}),` ou `,_jsx(_components.code,{children:`name`}),` é descartada e reportada como malformada.`]})]}),_jsxs(ParamField,{body:`updatedObjects[].itemOffers`,type:`array`,id:`param-updated-objects-item-offers`,children:[_jsx(_components.p,{children:`Ofertas que relacionam itens às categorias e definem preço e disponibilidade.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`id`}),` (string, obrigatório): identificador da oferta. Deve corresponder a um valor presente em `,_jsx(_components.code,{children:`category.itemOfferId`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`itemId`}),` (string, obrigatório): identificador do item associado. Deve corresponder a `,_jsx(_components.code,{children:`item.id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`price.value`}),` (number, obrigatório): preço aplicado ao produto.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`status`}),` (string): `,_jsx(_components.code,{children:`AVAILABLE`}),` ou `,_jsx(_components.code,{children:`UNAVAILABLE`}),`. Este campo define a disponibilidade do produto neste formato.`]}),`\n`]}),_jsxs(_components.p,{children:[`Uma oferta sem `,_jsx(_components.code,{children:`id`}),` não pode ser alcançada pelas categorias. Os produtos relacionados a ela são descartados e reportados como malformados.`]})]}),_jsxs(ParamField,{body:`updatedObjects[].items`,type:`array`,id:`param-updated-objects-items`,children:[_jsx(_components.p,{children:`Dados dos produtos referenciados pelas ofertas.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`id`}),` (string, obrigatório): identificador estável do item no seu PDV. A Onbeef armazena esse valor como `,_jsx(_components.code,{children:`pdv_external_id`}),` do produto.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`name`}),` (string, obrigatório): nome de exibição do produto. Usado apenas na criação: em produtos existentes, o nome cadastrado pelo lojista é preservado.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`description`}),` (string): descrição do produto. Usada apenas na criação, como o `,_jsx(_components.code,{children:`name`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`externalCode`}),` (string): código de balança do produto, usado pelos recursos de balança do painel. Não é usado para localizar produtos na integração.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ean`}),` (string): código de barras EAN. Apenas informativo.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`unit`}),` (string): `,_jsx(_components.code,{children:`KG`}),` ou `,_jsx(_components.code,{children:`UN`}),`. Define o tipo do produto apenas na criação. Depois de definido, o tipo não pode ser alterado e novos valores são ignorados.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`serving`}),` (integer): número de pessoas que a porção serve. Envie um número; texto é convertido para `,_jsx(_components.code,{children:`0`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`nutritionalInfo`}),` (object): informações nutricionais.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`image`}),` (object): imagem no formato `,_jsx(_components.code,{children:`{ \"url\": \"https://...\" }`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`O item não carrega preço nem disponibilidade neste formato. Use `,_jsx(_components.code,{children:`itemOffer.price.value`}),` e `,_jsx(_components.code,{children:`itemOffer.status`}),`.`]})]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`O encadeamento segue esta ordem: `,_jsx(_components.code,{children:`category.itemOfferId`}),` referencia `,_jsx(_components.code,{children:`itemOffer.id`}),`, e `,_jsx(_components.code,{children:`itemOffer.itemId`}),` referencia `,_jsx(_components.code,{children:`item.id`}),`. Um conjunto sem item correspondente, sem `,_jsx(_components.code,{children:`item.name`}),` ou sem `,_jsx(_components.code,{children:`itemOffer.price.value`}),` é descartado e reportado em `,_jsx(_components.code,{children:`moreInfo`}),`.`]})}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`Quando `,_jsx(_components.code,{children:`onlyAddProducts`}),` é `,_jsx(_components.code,{children:`false`}),`, categorias e produtos vinculados ao PDV que não aparecem no payload podem ser removidos do catálogo. A remoção afeta apenas registros com `,_jsx(_components.code,{children:`pdv_external_id`}),`. Conteúdos criados manualmente pelo lojista no painel não são removidos.`]}),_jsx(_components.p,{children:`Imagens, cortes e vínculos de categoria associados aos registros removidos também são excluídos.`}),_jsxs(_components.p,{children:[`Se qualquer objeto do payload estiver malformado, nenhuma remoção será executada nessa sincronização. O mesmo ocorre quando o payload não contém nenhuma categoria válida. Consulte `,_jsx(_components.code,{children:`moreInfo`}),` para identificar o problema.`]})]}),_jsx(Heading,{level:`3`,id:`exemplo-de-payload`,children:`Exemplo de payload`}),_jsx(CodeBlock,{filename:``,numberOfLines:`66`,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:`66`,children:[_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:` \"merchantStatus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`}),_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:` \"entityType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MERCHANT\"`}),_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:` \"onlyAddProducts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"updatedObjects\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"LOJA-01\"`}),_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:` \"categories\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"15\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Carnes bovinas\"`}),_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:` \"index\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`}),_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:` \"itemOfferId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"OF-1001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"OF-1002\"`})}),`\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`,_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:` \"itemOffers\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"OF-1001\"`}),_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:` \"itemId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1001\"`}),_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:` \"price\"`}),_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:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`89.9`})]}),`\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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"OF-1002\"`}),_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:` \"itemId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1002\"`}),_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:` \"price\"`}),_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:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24.9`})]}),`\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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1001\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Picanha bovina\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Peça resfriada vendida por peso\"`}),_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:` \"externalCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CARNE-1001\"`}),_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:` \"ean\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7891234567890\"`}),_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:` \"unit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"KG\"`}),_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:` \"serving\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"nutritionalInfo\"`}),_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:` \"image\"`}),_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:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-pos-system.example.com/images/picanha.jpg\"`})]}),`\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`,_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1002\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Linguiça artesanal\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pacote com 500 g\"`}),_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:` \"externalCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CARNE-1002\"`}),_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:` \"ean\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7891234567891\"`}),_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:` \"unit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UN\"`}),_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:` \"image\"`}),_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:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-pos-system.example.com/images/linguica.jpg\"`})]}),`\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`,_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`,_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(Tab,{title:`ITEM`,id:`item`,\"data-child-heading-ids\":`[\"exemplo-de-payload-2\"]`,children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`ITEM`}),` para atualizar produtos já sincronizados. `,_jsx(_components.code,{children:`updatedObjects`}),` recebe uma lista plana, sem `,_jsx(_components.code,{children:`categories`}),` ou `,_jsx(_components.code,{children:`itemOffers`}),`.`]}),_jsx(_components.p,{children:`Este formato não cria produtos.`}),_jsx(ParamField,{body:`updatedObjects`,type:`array`,required:true,id:`param-updated-objects-1`,children:_jsx(_components.p,{children:`Lista plana de produtos existentes.`})}),_jsxs(ParamField,{body:`updatedObjects[].id`,type:`string`,required:true,id:`param-updated-objects-id-1`,children:[_jsxs(_components.p,{children:[`Identificador do produto no seu PDV. Deve corresponder ao `,_jsx(_components.code,{children:`pdv_external_id`}),` de um produto já sincronizado.`]}),_jsxs(_components.p,{children:[`Se o produto não existir no catálogo, o objeto será ignorado e reportado em `,_jsx(_components.code,{children:`moreInfo`}),`.`]})]}),_jsx(ParamField,{body:`updatedObjects[].name`,type:`string`,required:true,id:`param-updated-objects-name`,children:_jsxs(_components.p,{children:[`Nome de exibição do produto. Diferente do `,_jsx(_components.code,{children:`MERCHANT`}),`, aqui o nome sobrescreve o que está cadastrado no painel.`]})}),_jsx(ParamField,{body:`updatedObjects[].description`,type:`string`,id:`param-updated-objects-description`,children:_jsx(_components.p,{children:`Descrição do produto. Quando enviada, sobrescreve a descrição cadastrada no painel.`})}),_jsx(ParamField,{body:`updatedObjects[].externalCode`,type:`string`,id:`param-updated-objects-external-code`,children:_jsx(_components.p,{children:`Código de balança do produto, usado pelos recursos de balança do painel. Não é usado para localizar produtos na integração.`})}),_jsx(ParamField,{body:`updatedObjects[].ean`,type:`string`,id:`param-updated-objects-ean`,children:_jsx(_components.p,{children:`Código de barras EAN. Apenas informativo.`})}),_jsx(ParamField,{body:`updatedObjects[].status`,type:`string`,id:`param-updated-objects-status`,children:_jsxs(_components.p,{children:[`Disponibilidade aplicada ao produto. Valores aceitos: `,_jsx(_components.code,{children:`AVAILABLE`}),` e `,_jsx(_components.code,{children:`UNAVAILABLE`}),`.`]})}),_jsx(ParamField,{body:`updatedObjects[].unit`,type:`string`,id:`param-updated-objects-unit`,children:_jsxs(_components.p,{children:[`Tipo do produto: `,_jsx(_components.code,{children:`KG`}),` ou `,_jsx(_components.code,{children:`UN`}),`. O valor só é aplicado quando o produto ainda não tem um tipo definido. Depois disso, alterações são ignoradas.`]})}),_jsx(ParamField,{body:`updatedObjects[].serving`,type:`integer`,id:`param-updated-objects-serving`,children:_jsxs(_components.p,{children:[`Número de pessoas que a porção serve. Envie um número; texto é convertido para `,_jsx(_components.code,{children:`0`}),`.`]})}),_jsx(ParamField,{body:`updatedObjects[].nutritionalInfo`,type:`object`,id:`param-updated-objects-nutritional-info`,children:_jsx(_components.p,{children:`Informações nutricionais.`})}),_jsx(ParamField,{body:`updatedObjects[].image`,type:`object`,id:`param-updated-objects-image`,children:_jsxs(_components.p,{children:[`Imagem no formato `,_jsx(_components.code,{children:`{ \"url\": \"https://...\" }`}),`.`]})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ITEM`}),` não atualiza preços. Campos de preço enviados neste formato são ignorados. Use `,_jsx(_components.code,{children:`ITEM_OFFER`}),` para alterar o preço de um produto.`]})}),_jsx(Heading,{level:`3`,id:`exemplo-de-payload-2`,children:`Exemplo de payload`}),_jsx(CodeBlock,{filename:``,numberOfLines:`31`,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:`31`,children:[_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:` \"entityType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ITEM\"`}),_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:` \"updatedObjects\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1001\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Picanha bovina premium\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Peça resfriada vendida por peso\"`}),_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:` \"externalCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CARNE-1001\"`}),_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:` \"ean\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7891234567890\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`}),_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:` \"unit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"KG\"`}),_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:` \"serving\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"nutritionalInfo\"`}),_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:` \"image\"`}),_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:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-pos-system.example.com/images/picanha-premium.jpg\"`})]}),`\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`,_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1002\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Linguiça artesanal\"`}),_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:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pacote com 500 g\"`}),_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:` \"externalCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CARNE-1002\"`}),_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:` \"ean\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7891234567891\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UNAVAILABLE\"`}),_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:` \"unit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UN\"`}),_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:` \"image\"`}),_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:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-pos-system.example.com/images/linguica.jpg\"`})]}),`\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`,_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(Tab,{title:`ITEM_OFFER`,id:`item_offer`,\"data-child-heading-ids\":`[\"exemplo-de-payload-3\"]`,children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`ITEM_OFFER`}),` para atualizar preço e disponibilidade de produtos já sincronizados. `,_jsx(_components.code,{children:`updatedObjects`}),` recebe uma lista plana de ofertas.`]}),_jsx(_components.p,{children:`Este formato não cria produtos.`}),_jsx(ParamField,{body:`updatedObjects`,type:`array`,required:true,id:`param-updated-objects-2`,children:_jsx(_components.p,{children:`Lista plana de ofertas.`})}),_jsxs(ParamField,{body:`updatedObjects[].itemId`,type:`string`,required:true,id:`param-updated-objects-item-id`,children:[_jsxs(_components.p,{children:[`Identificador do produto no seu PDV. Deve corresponder ao `,_jsx(_components.code,{children:`pdv_external_id`}),` de um produto já sincronizado.`]}),_jsxs(_components.p,{children:[`Se o produto não existir no catálogo, a oferta será ignorada e reportada em `,_jsx(_components.code,{children:`moreInfo`}),`.`]})]}),_jsx(ParamField,{body:`updatedObjects[].price.value`,type:`number`,required:true,id:`param-updated-objects-price-value`,children:_jsx(_components.p,{children:`Preço aplicado ao produto.`})}),_jsxs(ParamField,{body:`updatedObjects[].status`,type:`string`,id:`param-updated-objects-status-1`,children:[_jsxs(_components.p,{children:[`Disponibilidade aplicada ao produto. Valores aceitos: `,_jsx(_components.code,{children:`AVAILABLE`}),` e `,_jsx(_components.code,{children:`UNAVAILABLE`}),`.`]}),_jsx(_components.p,{children:`Se o campo for omitido ou tiver um valor diferente dos aceitos, o produto manterá a disponibilidade atual.`})]}),_jsx(ParamField,{body:`updatedObjects[].id`,type:`string`,id:`param-updated-objects-id-2`,children:_jsx(_components.p,{children:`Campo aceito por compatibilidade, mas ignorado neste formato.`})}),_jsx(ParamField,{body:`updatedObjects[].price.originalValue`,type:`number`,id:`param-updated-objects-price-original-value`,children:_jsx(_components.p,{children:`Campo aceito, mas ignorado.`})}),_jsx(ParamField,{body:`updatedObjects[].price.currency`,type:`string`,id:`param-updated-objects-price-currency`,children:_jsx(_components.p,{children:`Campo aceito, mas ignorado.`})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Produtos configurados pelo lojista como kits de preço aberto não recebem preço nem disponibilidade do PDV. A oferta inteira é ignorada e reportada em `,_jsx(_components.code,{children:`moreInfo`}),`.`]})}),_jsx(Heading,{level:`3`,id:`exemplo-de-payload-3`,children:`Exemplo de payload`}),_jsx(CodeBlock,{filename:``,numberOfLines:`19`,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:`19`,children:[_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:` \"entityType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ITEM_OFFER\"`}),_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:` \"updatedObjects\"`}),_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:` \"itemId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1001\"`}),_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:` \"price\"`}),_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:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`94.9`})]}),`\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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AVAILABLE\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"itemId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1002\"`}),_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:` \"price\"`}),_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:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`26.9`})]}),`\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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UNAVAILABLE\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Para ocultar temporariamente um produto sem removê-lo, defina o `,_jsx(_components.code,{children:`status`}),` da oferta como `,_jsx(_components.code,{children:`UNAVAILABLE`}),`. Em `,_jsx(_components.code,{children:`MERCHANT`}),`, use `,_jsx(_components.code,{children:`itemOffers[].status`}),`. Em `,_jsx(_components.code,{children:`ITEM_OFFER`}),`, use `,_jsx(_components.code,{children:`updatedObjects[].status`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`processamento-e-resultado`,children:`Processamento e resultado`}),`\n`,_jsxs(_components.p,{children:[`O processamento ocorre de forma assíncrona. Depois de receber o payload, a API enfileira a sincronização e responde com `,_jsx(_components.code,{children:`204 No Content`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`O status HTTP `,_jsx(_components.code,{children:`204`}),` confirma apenas que a requisição foi aceita e enfileirada. Ele não confirma que os dados foram aplicados.`]})}),`\n`,_jsxs(_components.p,{children:[`Consulte `,_jsx(_components.a,{href:`/api-reference/merchant/get-status`,children:_jsx(_components.code,{children:`GET /v1/merchantStatus`})}),` até `,_jsx(_components.code,{children:`status`}),` deixar de ser `,_jsx(_components.code,{children:`PROCESSING`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Significado`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PROCESSING`})}),_jsx(_components.td,{children:`A sincronização foi enfileirada ou está em processamento.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SUCCESS`})}),_jsx(_components.td,{children:`Todos os objetos foram processados sem descartes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FAIL`})}),_jsxs(_components.td,{children:[`A sincronização falhou por completo ou terminou com objetos descartados. Consulte `,_jsx(_components.code,{children:`moreInfo`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`moreInfo`}),` informa quantos objetos foram processados e descreve dados descartados ou problemas encontrados.`]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`FAIL`}),` também pode representar sucesso parcial. Por exemplo, se 99 de 100 itens forem atualizados, o resultado será `,_jsx(_components.code,{children:`FAIL`}),`, mas as 99 alterações já terão sido aplicadas.`]}),_jsxs(_components.p,{children:[`Não reenvie o mesmo payload automaticamente em loop. Leia `,_jsx(_components.code,{children:`moreInfo`}),`, identifique o que foi aplicado ou descartado e corrija a próxima sincronização.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`campos-da-resposta`,children:`Campos da resposta`}),`\n`,_jsx(Heading,{level:`3`,id:`204-sem-conteúdo`,children:`204: Sem conteúdo`}),`\n`,_jsx(_components.p,{children:`A requisição foi recebida e enfileirada. A resposta não contém corpo.`}),`\n`,_jsxs(_components.p,{children:[`Consulte `,_jsx(_components.a,{href:`/api-reference/merchant/get-status`,children:_jsx(_components.code,{children:`GET /v1/merchantStatus`})}),` para saber se o processamento terminou com `,_jsx(_components.code,{children:`SUCCESS`}),` ou `,_jsx(_components.code,{children:`FAIL`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`400-requisição-inválida`,children:`400: Requisição inválida`}),`\n`,_jsxs(_components.p,{children:[`Um campo obrigatório está ausente ou com valor não aceito (por exemplo, `,_jsx(_components.code,{children:`entityType`}),` fora do enum, ou `,_jsx(_components.code,{children:`merchantStatus`}),` ausente com `,_jsx(_components.code,{children:`entityType: MERCHANT`}),`). O corpo informa o campo: `,_jsx(_components.code,{children:`{ \"title\": \"The merchant status field is required when entity type is MERCHANT.\", \"status\": 400 }`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`401-não-autorizado`,children:`401: Não autorizado`}),`\n`,_jsxs(_components.p,{children:[`Token ausente ou inválido. Reautentique-se e tente novamente. Veja `,_jsx(_components.a,{href:`/api-reference/errors`,children:`Erros`}),`.`]})]})}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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Corpo da requisição","slug":"corpo-da-requisição","depth":2,"children":[{"title":"Campos comuns","slug":"campos-comuns","depth":3,"children":[]}]},{"title":"O que cada entityType atualiza","slug":"o-que-cada-entitytype-atualiza","depth":2,"children":[]},{"title":"Formato de updatedObjects","slug":"formato-de-updatedobjects","depth":2,"children":[{"title":"Exemplo de payload","slug":"exemplo-de-payload","depth":3,"children":[],"tabId":"merchant"},{"title":"Exemplo de payload","slug":"exemplo-de-payload-2","depth":3,"children":[],"tabId":"item"},{"title":"Exemplo de payload","slug":"exemplo-de-payload-3","depth":3,"children":[],"tabId":"item_offer"}]},{"title":"Processamento e resultado","slug":"processamento-e-resultado","depth":2,"children":[]},{"title":"Campos da resposta","slug":"campos-da-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":[]}]}],"codeExamples":{},"endpoint":{"title":"Sincronize o catálogo","path":"/v1/merchantUpdate","servers":[{"url":"https://api.dev.connect.onbeefapp.com.br"},{"url":"https://api.connect.onbeefapp.com.br"}],"method":"put","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":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"entityType":[{"type":"string","description":"Define o formato de `updatedObjects` . Valores aceitos: `MERCHANT` : sincroniza a loja, as categorias, os itens e as ofertas em uma estrutura aninhada. `ITEM` : atualiza produtos existentes em uma lista plana. `ITEM_OFFER` : atualiza preço e disponibilidade de produtos existentes em uma lista plana.","required":true}],"merchantStatus":[{"type":"string","description":"Obrigatório quando `entityType` é `MERCHANT` . Valores aceitos: `AVAILABLE` e `UNAVAILABLE` . `AVAILABLE` liga a chave geral de recebimento de pedidos. `UNAVAILABLE` desliga essa chave e bloqueia novos pedidos no checkout. O campo não representa o horário de funcionamento. Uma loja pode estar `AVAILABLE` e não receber pedidos fora do horário cadastrado. Com `ITEM` ou `ITEM_OFFER` , o campo é aceito e ignorado."}],"onlyAddProducts":[{"type":"boolean","description":"Tem efeito apenas quando `entityType` é `MERCHANT` . `true` : adiciona ou atualiza os dados enviados sem desassociar produtos nem remover registros do catálogo. `false` : substitui as associações entre categorias e produtos pelo conteúdo enviado. Também permite remover do catálogo categorias e produtos vinculados ao PDV que não aparecem no payload. Com `ITEM` ou `ITEM_OFFER` , o campo é ignorado."}]}}],"examples":{"example":{"value":{"entityType":"\u003cstring>","merchantStatus":"\u003cstring>","onlyAddProducts":true}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"onbeef","siteName":"Onbeef Connect API","title":"Sincronize o catálogo - Onbeef Connect API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-24T13:19:18.371Z","originalFileLocation":"api-reference/merchant/sync-catalog.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=\"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.\">\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=\"Sincronize o catálogo - Onbeef Connect API\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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/merchant/sync-catalog\">\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=Merchant\u0026amp;title=Sincronize+o+cat%C3%A1logo\u0026amp;description=Envie+categorias%2C+itens+e+ofertas.+Produtos+s%C3%A3o+localizados+pelo+pdv_external_id%3A+MERCHANT+cria+e+remove%2C+ITEM+atualiza+o+cadastro%2C+ITEM_OFFER+atualiza+pre%C3%A7o+e+\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=b6205c39ace6eb4d176b6b1e23f5aaefe24fc77db8c8addb303a740d311647d9\">\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=\"Sincronize o catálogo - Onbeef Connect API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onbeef.mintlify.site/_mintlify/api/og/v2?division=Merchant\u0026amp;title=Sincronize+o+cat%C3%A1logo\u0026amp;description=Envie+categorias%2C+itens+e+ofertas.+Produtos+s%C3%A3o+localizados+pelo+pdv_external_id%3A+MERCHANT+cria+e+remove%2C+ITEM+atualiza+o+cadastro%2C+ITEM_OFFER+atualiza+pre%C3%A7o+e+\u0026amp;theme=951f97d33c896d10e9698c59\u0026amp;signature=b6205c39ace6eb4d176b6b1e23f5aaefe24fc77db8c8addb303a740d311647d9\">\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/merchant/sync-catalog\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/merchant/sync-catalog.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/merchant/sync-catalog#webpage\",\"url\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog\",\"name\":\"Sincronize o 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.\",\"dateModified\":\"2026-08-24T13:19:18.371Z\",\"isPartOf\":{\"@id\":\"https://docs.onbeef.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Merchant\",\"item\":\"https://docs.onbeef.app/api-reference/merchant/get-merchant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sincronize o catálogo\",\"item\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog#apireference\",\"headline\":\"Sincronize o catálogo\",\"name\":\"Sincronize o 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.\",\"url\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onbeef.app/api-reference/merchant/sync-catalog#webpage\"},\"dateModified\":\"2026-08-24T13:19:18.371Z\",\"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/merchant/sync-catalog.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","description":"Cadastre a URL base que recebe notificações de pedidos.","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","description":"Obtenha os eventos pendentes.","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","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":"Sincronize o catálogo - 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"]}