Consulte a sincronização
curl --request GET \
--url https://api.dev.connect.onbeefapp.com.br/v1/merchantStatus \
--header 'Authorization: Bearer <token>'{
"status": "<string>",
"lastRead": "<string>",
"moreInfo": {}
}Merchant
Consulte a sincronização
Consulte o processamento assíncrono do catálogo: PROCESSING, SUCCESS ou FAIL, com a causa da falha em moreInfo.
GET
/
v1
/
merchantStatus
Consulte a sincronização
curl --request GET \
--url https://api.dev.connect.onbeefapp.com.br/v1/merchantStatus \
--header 'Authorization: Bearer <token>'{
"status": "<string>",
"lastRead": "<string>",
"moreInfo": {}
}Consulte este endpoint depois de chamar
PUT /v1/merchantUpdate. A resposta informa se o catálogo está em processamento, foi aplicado ou falhou.
Campos da resposta
200: Sucesso
Retorna o estado de processamento da última sincronização de catálogo.string
Estado de processamento da última leitura do catálogo. Um dos valores:
PROCESSING: a sincronização foi recebida e está sendo processada.SUCCESS: a sincronização foi processada com sucesso.FAIL: a sincronização falhou (vejamoreInfopara detalhes).
string
Timestamp ISO 8601 da última vez em que a Onbeef processou informações do seu merchant.
string | null
Detalhes adicionais quando aplicável: por exemplo, a mensagem de erro no caso de
FAIL. null quando não há informação extra.Falhas comuns
Mensagens que aparecem emmoreInfo quando status é FAIL:
| Mensagem | Causa | Como resolver |
|---|---|---|
| ”Itens não encontrados: …” | O itemId enviado não corresponde ao pdv_external_id de nenhum produto da loja. | Vincule o código de integração com PDV do produto no painel (Catálogo > Códigos & Balança) ou confira o valor enviado. Veja Sincronizar catálogo. |
| ”… ofertas recebidas sem itemId ou price.value foram descartadas” | Objetos malformados no payload. | Envie itemId e price.value em todas as ofertas. |
| ”Kits de preço aberto não recebem preço do PDV: …” | O produto está configurado como kit de preço aberto no painel. | Mude o kit para preço fechado ou remova o código de PDV dele. |
| ”O cadastro recebido do PDV está sem o id da loja…” | updatedObjects[0].id ausente no MERCHANT. | Envie o identificador da loja no primeiro objeto. |
| ”Nenhuma categoria recebida é válida…” | Todas as categorias vieram sem id ou name. | Envie id e name em todas as categorias. |
Um único item não encontrado marca a sincronização inteira como
FAIL, mesmo que os demais tenham sido atualizados. Use a lista de ids em moreInfo para encontrar o que ficou sem vínculo.401: Não autorizado
Token ausente ou inválido. Reautentique-se viaPOST /oauth/token e tente novamente. Veja Erros.
503: Serviço indisponível
Falha interna temporária que impede o roteamento da requisição. Aplique backoff exponencial e tente novamente. Veja Erros.Exemplo
Requisição
curl "https://api.dev.connect.onbeefapp.com.br/v1/merchantStatus" \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
Resposta
{
"lastRead": "2025-08-22T16:13:37.000000Z",
"status": "SUCCESS",
"moreInfo": null
}
Após
PUT /v1/merchantUpdate, faça polling neste endpoint (por exemplo, a cada 5 segundos, com um timeout razoável) até que status seja SUCCESS antes de considerar o catálogo publicado.