curl --request GET \
--url https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"month": 123,
"year": 123,
"items": [
{
"itemType": "DELIVERY_TAKEOUT",
"quantity": 123,
"totalPrice": [
{
"type": "PAYABLE",
"value": 123,
"usageTimeValue": 123,
"currency": "BRL"
}
]
}
],
"totalPrice": [
{
"type": "PAYABLE",
"value": 123,
"usageTimeValue": 123,
"currency": "BRL"
}
]
}
]{
"title": "Unauthorized",
"status": 401
}{
"status": "422",
"title": "<string>"
}Listar faturas das lojas diretas
Lista as faturas do mês das lojas. Quando partnerId é um parceiro, retorna apenas as lojas vendidas diretamente por ele (sem revenda); quando é uma revenda, retorna as lojas da revenda. Os blocos de preço RECEIVABLE só aparecem quando o parceiro tem tabela de preços própria.
curl --request GET \
--url https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.deliveryvip.com.br/partner/v2/{partnerId}/merchants/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"month": 123,
"year": 123,
"items": [
{
"itemType": "DELIVERY_TAKEOUT",
"quantity": 123,
"totalPrice": [
{
"type": "PAYABLE",
"value": 123,
"usageTimeValue": 123,
"currency": "BRL"
}
]
}
],
"totalPrice": [
{
"type": "PAYABLE",
"value": 123,
"usageTimeValue": 123,
"currency": "BRL"
}
]
}
]{
"title": "Unauthorized",
"status": 401
}{
"status": "422",
"title": "<string>"
}Autorizações
Access token OAuth 2.0 (opaco) com o escopo dv.partner, obtido em POST /authentication/v1/oauth/token.
Parâmetros de caminho
UUID do parceiro ou da revenda.
Parâmetros de consulta
Ano de referência. Padrão é o ano corrente.
2026
Mês de referência (1 a 12). Padrão é o mês corrente.
1 <= x <= 1210
Resposta
Lista de faturas.
UUID da loja.
UUID do plano faturado.
Mês de referência.
Ano de referência.
Itens da fatura, agrupados por recurso.
Show child attributes
Show child attributes
Totais da fatura. Para revendas, só vem quando a revenda tem tabela de preços própria.
Show child attributes
Show child attributes