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

> ## Agent Instructions
> Documentação das APIs da DeliveryVip, em português. Regras que mais quebram integrações: (1) Merchant API: faça polling em GET /merchant/v3/events:polling no máximo a cada 30 s por token; confirme todo evento recebido com POST /merchant/v3/events/acknowledgment e corpo [{"id": "<eventId>"}] (o campo lido é id, não eventId), inclusive eventos repetidos ou que o sistema não trata; deduplique por eventId; o evento é só um aviso, busque o pedido na orderURL. (2) Tokens client_credentials valem 24 h e não têm refresh_token: peça outro ao receber 401. (3) Webhooks: valide a assinatura HMAC sobre o corpo bruto e responda 2xx rápido; o polling é a reconciliação. (4) Open Delivery: host od.deliveryvip.com.br, um client_secret por loja, datas em UTC. (5) Fidelidade: o operador implementa 5 rotas assinadas com HMAC e chama o config push; o estorno precisa ser idempotente. (6) Partner API: scope dv.partner. Não invente endpoints: use a referência gerada das specs OpenAPI.

# Obter status do merchant

> Consulte se a loja está aberta ou fechada e os horários de funcionamento de cada dia da semana.

Consulte se a loja está aberta neste momento e em quais horários ela atende durante a semana. Use para mostrar o status no seu sistema ou evitar lançar pedidos com a loja fechada.

## Requisição

```bash cURL theme={null}
curl 'https://api.deliveryvip.com.br/merchant/v3/{merchantId}/status' \
  --header 'Authorization: Bearer {token}'
```

```js Node.js theme={null}
const response = await fetch(`https://api.deliveryvip.com.br/merchant/v3/${merchantId}/status`, {
  headers: { Authorization: `Bearer ${token}` },
})
const { status, services } = await response.json()
```

```python Python theme={null}
response = requests.get(
    f"https://api.deliveryvip.com.br/merchant/v3/{merchant_id}/status",
    headers={"Authorization": f"Bearer {token}"},
)
merchant_status = response.json()
```

**merchantId** `uuid` *required*

A loja.

## Resposta

**status** `string` *required*

`AVAILABLE` se a loja está aberta agora, `UNAVAILABLE` se está fechada.

**services** `object[]` *required*

Lista com um único serviço, que reúne os horários da loja.

**propriedades**

**id** `uuid` *required*

Identificador da loja.

**serviceHours** `object[]` *required*

Lista com um único item.

**propriedades**

**weekHours** `object[]` *required*

Um item por período de funcionamento. Um dia com dois turnos gera dois itens; dias sem horário não aparecem.

**propriedades**

**dayOfWeek** `string[]` *required*

O dia do período, sempre com um único valor: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY` ou `SUNDAY`.

**timePeriods** `object` *required*

`startTime` e `endTime` no formato `HH:MM:SS`, no horário local da loja.

**orderingAppMerchantId** `uuid` *required*

Identificador da loja na DeliveryVip.

```json Resposta (200) theme={null}
{
  "status": "AVAILABLE",
  "services": [
    {
      "id": "f2dc029d-b999-4f26-b1e3-9a3e313051df",
      "serviceHours": [
        {
          "weekHours": [
            { "dayOfWeek": ["MONDAY"], "timePeriods": { "startTime": "11:00:00", "endTime": "14:00:00" } },
            { "dayOfWeek": ["MONDAY"], "timePeriods": { "startTime": "18:00:00", "endTime": "23:00:00" } },
            { "dayOfWeek": ["TUESDAY"], "timePeriods": { "startTime": "18:00:00", "endTime": "23:00:00" } },
            { "dayOfWeek": ["SATURDAY"], "timePeriods": { "startTime": "11:00:00", "endTime": "23:59:00" } }
          ]
        }
      ]
    }
  ],
  "orderingAppMerchantId": "f2dc029d-b999-4f26-b1e3-9a3e313051df"
}
```

> [!NOTE]
>
> `status` reflete se a loja está aberta neste momento, não é calculado a partir de `weekHours`. A loja pode estar fechada dentro do horário de funcionamento, por exemplo quando o lojista fecha a loja manualmente pelo painel.

## Erros comuns

| Status | Causa |
| - | - |
| `401 Unauthorized` | Token ausente, inválido ou expirado. |
| `404 Not Found` | A loja não existe ou o token não tem acesso a ela. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.