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

# Listar faturas das revendas (descontinuado)

> Formato antigo das faturas das lojas de revenda, mantido por compatibilidade. Migre para o resumo por revenda.

> [!WARNING]
>
> `GET /partner/v2/resales/invoices` está **descontinuado**. A data de desligamento anunciada foi 01/07/2025: hoje a rota ainda responde, com os headers `Deprecation: true` e `Sunset: Tue, 01 Jul 2025 00:00:00 GMT`, e pode ser removida a qualquer momento. Use [`GET /partner/v2/{partnerId}/resales/invoices`](/docs/guides/partner/invoices/utilizando-a-api/listando-resales-invoices).

Apesar do nome, o endpoint não agrega por revenda: ele devolve **uma entrada por fatura de loja de revenda** do mês, identificada só pelo `resaleId` (não traz `merchantId`). Lojas atendidas diretamente pelo parceiro ficam de fora.

| Status | Quando |
| - | - |
| `200 OK` | Lista de faturas. |
| `204 No Content` | Nenhuma fatura de loja de revenda no período. |
| `403 Forbidden` | `x-partners` fora do alcance do token. |

## Requisição

```bash cURL theme={null}
curl 'https://api.deliveryvip.com.br/partner/v2/resales/invoices?year=2024&month=1' \
  --header 'Authorization: Bearer {token}'
```

```js Node.js theme={null}
const response = await fetch(
  'https://api.deliveryvip.com.br/partner/v2/resales/invoices?year=2024&month=1',
  { headers: { Authorization: `Bearer ${token}` } },
)
```

```python Python theme={null}
response = requests.get(
    "https://api.deliveryvip.com.br/partner/v2/resales/invoices",
    params={"year": 2024, "month": 1},
    headers={"Authorization": f"Bearer {token}"},
)
```

**year** `integer`

Ano. Sem ele, vale o ano corrente.

**month** `integer`

Mês, de 1 a 12. Sem ele, vale o mês corrente.

**x-partners** `string[]`

Restringe a parceiros ou revendas específicos, como em [Filtrar por Partners](/docs/guides/partner/merchant/utilizando-a-api/listar-merchants.md#filtrar-por-partners).

## Resposta

```json Resposta (200) theme={null}
[
  {
    "resaleId": "2a710c93-ece1-4d57-9038-6fc714c0e81b",
    "month": "1",
    "year": "2024",
    "items": [
      {
        "itemType": "DELIVERY_TAKEOUT",
        "quantity": 1,
        "usageTime": 0.5,
        "totalPrice": 150.0,
        "totalUsageTimePrice": 75.0,
        "metadata": {
          "agreementCode": "123456",
          "sales": {
            "all": { "quantity": 1059, "totalPrice": 96125.11 },
            "success": { "quantity": 1059, "totalPrice": 96125.11 },
            "cancelled": { "quantity": 0, "totalPrice": 0.0 }
          }
        }
      },
      { "itemType": "DELIVERYBOT_NOTIFICATION", "quantity": 1, "usageTime": 0.5, "totalPrice": 30.0, "totalUsageTimePrice": 15.0 }
    ],
    "partnerId": "ba1fcc5c-8570-4a8d-b7dc-9d4077f85be8"
  }
]
```

Os itens têm exatamente os campos de [Listar faturas das lojas](/docs/guides/partner/merchant/utilizando-a-api/listar-faturas-dos-merchants.md#resposta), inclusive a regra de visibilidade: `totalPrice`, `totalUsageTimePrice` e `metadata.tieredPricingRanges` só aparecem para o token do parceiro dono da fatura. `month` e `year` repetem o valor da query (texto) ou, sem ela, vêm como número.


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