> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onbeef.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulte a sincronização

> Consulte o processamento do catálogo.

Consulte este endpoint depois de chamar `PUT /v1/merchantUpdate`. A resposta informa se o catálogo está em processamento, foi aplicado ou falhou.

## Parâmetros de consulta

<ParamField query="merchantId" type="string" required>
  UUID do seu merchant. Obrigatório.
</ParamField>

## Campos da resposta

### 200: Sucesso

Retorna o estado de processamento da última sincronização de catálogo.

<ResponseField name="status" type="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 (veja `moreInfo` para detalhes).
</ResponseField>

<ResponseField name="lastRead" type="string">
  Timestamp ISO 8601 da última vez em que a Onbeef processou informações do seu merchant.
</ResponseField>

<ResponseField name="moreInfo" type="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.
</ResponseField>

### 401: Não autorizado

Token ausente ou inválido. Reautentique-se via `POST /oauth/token` e tente novamente. Veja [Erros](/api-reference/errors).

### 503: Serviço indisponível

Falha interna temporária que impede o roteamento da requisição. Aplique backoff exponencial e tente novamente. Veja [Erros](/api-reference/errors).

## Exemplo

### Requisição

```bash theme={null}
curl "https://api.dev.connect.onbeefapp.com.br/v1/merchantStatus?merchantId=9b2f4c1e-0a3d-4e8c-9d6a-2b7f1c0d5e3a" \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
```

### Resposta

```json theme={null}
{
  "lastRead": "2025-08-22T16:13:37.000000Z",
  "status": "SUCCESS",
  "moreInfo": null
}
```

<Tip>
  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.
</Tip>