Endpoint: GET /unified/accounts/sellers/{sellers_pk}/metrics/accountsalescomparison/
Autenticação: JWT Bearer ou API Key. O usuário precisa ter acesso ao seller informado em sellers_pk.
Compara os totais de vendas do período atual de todas as contas relacionadas ao seller contra o período anterior de mesma duração, imediatamente antes do atual. Retorna uma linha por conta, ordenada por total do período atual de forma decrescente. O período anterior é calculado automaticamente:
  • current_start = date_before e current_end = date_after (a view lê os parâmetros nessa ordem — ver Parâmetros de consulta).
  • period_length = current_end - current_start.
  • previous_start = current_start - (period_length + 1) dias.
  • previous_end = current_start - 1 dia.
Atenção: os nomes date_after e date_before aparecem invertidos em relação a outros endpoints de métricas. Aqui date_after é o fim do período atual e date_before é o início do período atual. Tanto date_after quanto date_before são obrigatórios; se algum estiver ausente, o endpoint retorna uma lista vazia (sem erro).
O endpoint usa paginação por número de página.

​
Requisição

​
Parâmetros de caminho

​
sellers_pk
string
required
UUID da conta unificada do seller.

​
Parâmetros de consulta

​
date_after
string (YYYY-MM-DD)
required
Fim do período atual (interpretado como current_end).
​
date_before
string (YYYY-MM-DD)
required
Início do período atual (interpretado como current_start).
​
page
integer
Número da página, começando em 1.
​
page_size
integer
Quantidade de itens por página.

​
Resposta

Lista paginada de linhas de comparação:
​
account
object
  • id — UUID da conta unificada.
  • display_name — rótulo legível.
  • type — tipo da conta.
​
current_period_total
integer
Soma de vendas da conta no período atual, em centavos de BRL.
​
previous_period_total
integer
Soma de vendas da conta no período anterior equivalente, em centavos de BRL.
​
change_amount
integer
current_period_total - previous_period_total, em centavos de BRL.
​
change_percentage
number
Variação percentual arredondada para duas casas decimais. Se o período anterior foi zero e o atual é positivo, o valor é 100.0. Se ambos forem zero, o valor é 0.0.
{
  "count": 12,
  "next": null,
  "previous": null,
  "results": [
    {
      "account": {
        "id": "8c2d7f6e9b4a4f10aabbccddeeff0011",
        "display_name": "Acme Sub-Seller 01",
        "type": "business"
      },
      "current_period_total": 1284500,
      "previous_period_total": 980012,
      "change_amount": 304488,
      "change_percentage": 31.07
    }
  ]
}

​
Erros

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

​
Exemplos

curl "https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/accountsalescomparison/?date_after=2025-05-14&date_before=2025-05-01" \
  -H "Authorization: Bearer $TOKEN"