> ## 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 taxa de entrega

> Calcule se a loja entrega numa coordenada, a distância e o valor da taxa de entrega.

Informe a coordenada do endereço do cliente e receba se ele está dentro da área de entrega da loja, a distância até a loja e a taxa cobrada. Útil para lançar pedidos por telefone ou no balcão com o mesmo valor que o cardápio digital cobraria.

## Requisição

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

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

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

**merchantId** `uuid` *required*

A loja.

**latitude** `number` *required*

Latitude do endereço do cliente, em graus decimais com ponto, como `-29.7202754`.

**longitude** `number` *required*

Longitude do endereço do cliente, em graus decimais com ponto, como `-53.7744837`.

> [!TIP]
>
> O endpoint trabalha com coordenadas, não com endereço em texto. Geocodifique o endereço do cliente antes de chamar.

## Resposta

**id** `uuid` *required*

Identificador desta cotação. Cada chamada gera um novo.

**status** `string` *required*

`AVAILABLE` quando a coordenada está dentro de uma área de entrega ativa da loja; `UNAVAILABLE` quando não está.

**distanceInMeters** `integer` *required*

Distância em linha reta entre a loja e a coordenada, em metros.

**fee** `string`

Valor da taxa de entrega, em reais, como string decimal (`"17.0"`). Só vem quando `status` é `AVAILABLE`.

**createdAt** `datetime` *required*

Quando a cotação foi calculada.

```json AVAILABLE theme={null}
{
  "id": "d765df02-6234-42dc-bfba-346c88a0de83",
  "status": "AVAILABLE",
  "distanceInMeters": 5373,
  "fee": "17.0",
  "createdAt": "2026-10-02T17:50:40-03:00"
}
```

```json UNAVAILABLE theme={null}
{
  "id": "0b3e4c1a-9f2d-4e7b-8a6c-5d1f2e3a4b5c",
  "status": "UNAVAILABLE",
  "distanceInMeters": 18240,
  "createdAt": "2026-10-02T17:51:12-03:00"
}
```

> [!NOTE]
>
> A taxa segue a configuração da loja: por **raio**, o valor da faixa de distância (arredondada para cima, em quilômetros); por **área**, o valor da área de entrega que contém a coordenada.

## Erros comuns

| Status | Causa |
| - | - |
| `401 Unauthorized` | Token ausente, inválido ou expirado. |
| `404 Not Found` | A loja não existe, o token não tem acesso a ela, ou a latitude/longitude não está no formato numérico com ponto. |


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