Vendas por produto e data

Endpoint: GET /unified/accounts/sellers/{sellers_pk}/metrics/productbydate/

Autenticação: JWT Bearer ou API Key. O usuário precisa ter acesso ao seller informado em sellers_pk.

Retorna os totais diários de clear_amount para transações succeeded, agrupados por produto e data. A agregação percorre todas as contas relacionadas ao seller (a própria conta mais sub-sellers e contas relacionadas) e depois agrupa o resultado por (product, date). A taxonomia de product é a mesma usada em expectedreceivablesbyproduct:

Código do produto	Significado
`pix`	Transações por PIX.
`boleto`	Transações por boleto bancário.
`debit`	Transações no cartão de débito.
`credit_1`	Cartão de crédito, 1x.
`credit_2_6`	Cartão de crédito, de 2 a 6 parcelas.
`credit_7_12`	Cartão de crédito, de 7 a 12 parcelas.
`credit_13_21`	Cartão de crédito, de 13 a 21 parcelas.
`credit_22_plus`	Cartão de crédito, 22 ou mais parcelas.
`unknown`	Transação sem `product` definido.

Limitado às 90 linhas mais recentes, ordenado por date decrescente e em seguida por product.

Requisição

Parâmetros de caminho

string

required

UUID da conta unificada do seller.

Parâmetros de consulta

string (YYYY-MM-DD)

Limite inferior do intervalo de datas (inclusivo).

string (YYYY-MM-DD)

Limite superior do intervalo de datas (inclusivo).

Resposta

Um array JSON de objetos:

string

Categoria de produto — ver tabela acima.

string (YYYY-MM-DD)

Dia da venda, no fuso America/Sao_Paulo.

integer

Soma de clear_amount para o grupo, em centavos de BRL. Chargebacks subtraem.

[
  { "product": "credit_1",   "date": "2025-05-14", "total": 540000 },
  { "product": "credit_2_6", "date": "2025-05-14", "total": 280000 },
  { "product": "pix",        "date": "2025-05-14", "total":  90000 }
]

Erros

Status	Quando
`401`	Cabeçalho `Authorization` ausente ou inválido.
`403`	Autenticado, porém sem acesso ao seller informado em `sellers_pk`.
`404`	O UUID do seller não existe.

Exemplos

curl https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/productbydate/ \
  -H "Authorization: Bearer $TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/productbydate/",
    headers={"Authorization": f"Bearer {token}"},
)
rows = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellersPk}/metrics/productbydate/`,
  { headers: { Authorization: `Bearer ${token}` } },
);
const rows = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Vendas por produto e data

Requisição

Parâmetros de caminho

Parâmetros de consulta

Resposta

Erros

Exemplos

​Requisição

​Parâmetros de caminho

​Parâmetros de consulta

​Resposta

​Erros

​Exemplos

Requisição

Parâmetros de caminho

Parâmetros de consulta

Resposta

Erros

Exemplos