> ## 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.

# Faturas

> Consulte o fechamento mensal de cada loja e o resumo por revenda para gerar as suas cobranças.

No **penúltimo dia de cada mês**, a DeliveryVip fecha uma fatura (invoice) para cada loja ativa ou cancelada no mês, com base no plano e nos recursos usados. Com elas você sabe quanto paga à DeliveryVip e quanto cobrar de cada loja ou revenda.

> [!NOTE]
>
> As faturas só existem depois do fechamento. Antes dele, a consulta do mês corrente volta `204 No Content`.

## Qual endpoint usar

| Endpoint | Traz | Quem pode chamar |
| - | - | - |
| [`GET /{partnerId}/invoices`](/docs/guides/partner/invoices/utilizando-a-api/listando-invoices) | Uma fatura por loja: diretas e de revendas. | Parceiro ou revenda |
| [`GET /{partnerId}/merchants/invoices`](/docs/guides/partner/invoices/utilizando-a-api/listando-merchants-invoices) | Uma fatura por loja **atendida diretamente**. | Parceiro ou revenda |
| [`GET /{partnerId}/resales/invoices`](/docs/guides/partner/invoices/utilizando-a-api/listando-resales-invoices) | Um resumo **por revenda**, com totais por plano e por item. | Só parceiro |

Todos ficam em `https://api.deliveryvip.com.br/partner/v2` e aceitam `year` e `month` na query.

> [card] [Definições](/docs/guides/partner/invoices/definicoes.md)
>
> Campos da fatura, `PAYABLE` x `RECEIVABLE`, valor cheio x proporcional.

> [card] [Utilizando a API](/docs/guides/partner/invoices/utilizando-a-api.md)
>
> Os três endpoints, com exemplos.

> [!WARNING]
>
> As rotas antigas sem `partnerId` (`GET /partner/v2/merchants/invoices` e `GET /partner/v2/resales/invoices`) estão descontinuadas. Veja [Deprecações](/docs/deprecations.md).


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