Sincronize seu catálogo - Onbeef Connect API

Use este fluxo para publicar ou atualizar categorias, produtos, preços e disponibilidade.

Vincule o catálogo existente

A integração localiza produtos e categorias pelo pdv_external_id, o código de integração com PDV. Produtos criados manualmente no painel não têm esse código e não são alcançados por ITEM nem ITEM_OFFER.Se a loja já tem catálogo cadastrado, o lojista deve vincular os códigos no painel antes da primeira sincronização:

Produtos: Catálogo > Códigos & Balança > preencher o “Código de integração com PDV” de cada produto com o id do item no PDV. A tela também importa o arquivo de itens do PDV, preenchendo automaticamente os produtos de nome coincidente.
Categorias: editar a categoria e preencher o código de integração com PDV.

Sem o vínculo, uma sincronização MERCHANT cria produtos e categorias novos em vez de atualizar os existentes, duplicando o catálogo.Confirme o vínculo em GET /v1/merchant: o campo pdv_external_id deve vir preenchido.

Envie o catálogo

Use PUT /v1/merchantUpdate. Escolha o entityType conforme o tamanho da atualização:

Valor	Uso
`MERCHANT`	Envia o merchant, as categorias, os itens e as ofertas.
`ITEM`	Atualiza itens.
`ITEM_OFFER`	Atualiza preço e disponibilidade das ofertas.

A resposta 204 indica que o payload foi recebido para processamento.

Ver o payload completo

Consulte todos os campos e o exemplo de sincronização.

Confirme o resultado

Consulte GET /v1/merchantStatus:

Sandbox

curl --request GET \
  --url 'https://api.dev.connect.onbeefapp.com.br/v1/merchantStatus' \
  --header 'Authorization: Bearer <access_token>'

Aguarde SUCCESS. Use moreInfo para entender uma resposta FAIL.

Quando atualizar

Envie uma atualização quando mudar:

o preço de um produto;
a disponibilidade de uma oferta;
a composição de uma categoria;
os dados ou o status da loja.

merchantStatus: "UNAVAILABLE" deixa a loja indisponível na Onbeef.

Ver o payload completo

​Quando atualizar

Quando atualizar