Comparativo de vendas por conta

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

string

required

UUID da conta unificada do seller.

Parâmetros de consulta

string (YYYY-MM-DD)

required

Fim do período atual (interpretado como current_end).

string (YYYY-MM-DD)

required

Início do período atual (interpretado como current_start).

integer

Número da página, começando em 1.

integer

Quantidade de itens por página.

Resposta

Lista paginada de linhas de comparação:

object

id — UUID da conta unificada.
display_name — rótulo legível.
type — tipo da conta.

integer

Soma de vendas da conta no período atual, em centavos de BRL.

integer

Soma de vendas da conta no período anterior equivalente, em centavos de BRL.

integer

current_period_total - previous_period_total, em centavos de BRL.

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

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/accountsalescomparison/?date_after=2025-05-14&date_before=2025-05-01" \
  -H "Authorization: Bearer $TOKEN"

import requests

response = requests.get(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{sellers_pk}/metrics/accountsalescomparison/",
    params={"date_after": "2025-05-14", "date_before": "2025-05-01"},
    headers={"Authorization": f"Bearer {token}"},
)
data = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellersPk}/metrics/accountsalescomparison/?date_after=2025-05-14&date_before=2025-05-01`,
  { headers: { Authorization: `Bearer ${token}` } },
);
const data = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Comparativo de vendas por conta

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