Recebíveis previstos por conta

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

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

Mesmos dados de expectedreceivablesbydate, porém adicionalmente agrupados pela conta da transação — isto é, a conta que processou a transação que gerou o recebível. Especialmente útil quando o seller atua como destino de redirecionamento (redirect_sales_to) e precisa atribuir o caixa futuro a cada um dos seus sub-sellers. O resultado é ordenado por date decrescente e limitado às 90 linhas mais recentes.

Requisição

Parâmetros de caminho

string

required

UUID da conta unificada do seller destinatário.

Parâmetros de consulta

string (YYYY-MM-DD)

Limite inferior do intervalo de datas previstas (inclusivo).

string (YYYY-MM-DD)

Limite superior do intervalo de datas previstas (inclusivo).

Resposta

Um array JSON de objetos:

object

Conta de origem da transação. Formato:

id — UUID da conta unificada.
display_name — rótulo legível (nome da empresa ou pessoa).
type — tipo da conta, por exemplo business ou individual.

string (YYYY-MM-DD)

Data prevista de liquidação.

integer

Soma dos valores previstos atribuíveis à conta naquela data, em centavos de BRL.

[
  {
    "transaction_account": {
      "id": "8c2d7f6e9b4a4f10aabbccddeeff0011",
      "display_name": "Acme Sub-Seller 01",
      "type": "business"
    },
    "date": "2025-06-15",
    "total": 540000
  }
]

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/expectedreceivablesbyaccount/ \
  -H "Authorization: Bearer $TOKEN"

import requests

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

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellersPk}/metrics/expectedreceivablesbyaccount/`,
  { 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

Recebíveis previstos 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