Consulta de splits via interface

Consulte Splits pela interface

Acompanhe Splits pagos e recebidos diretamente pela aplicação Asaas.

Use a interface para consultas operacionais, aplicação de filtros e exportação manual em CSV. Para automações, utilize os recursos disponíveis via API.

📘
Recomendação
Utilize a interface para consultas operacionais, análises pontuais e exportação manual de dados.
Para consultas automatizadas, integrações internas ou dashboards próprios, utilize os recursos disponíveis via API.

Escolha como consultar

Necessidade	Utilize
Conferir Splits pagos ou recebidos	Interface
Localizar um Split por cobrança, conta ou período	Interface
Exportar dados em CSV	Interface
Consultar estatísticas de Split programaticamente	API
Alimentar dashboards ou relatórios automatizados	API
Acompanhar liquidações em tempo real	Webhooks

Como acessar

A opção Split de pagamentos é exibida no menu lateral quando a conta possui Splits configurados.

Para consultar:

acesse sua conta Asaas;
no menu lateral, selecione Split de pagamentos;
escolha Splits pagos ou Splits recebidos;
utilize a busca ou os filtros;
exporte os dados em CSV, se necessário.

Consulte Splits pagos e recebidos

Escolha a aba de acordo com o papel da conta na operação:

Aba	O que apresenta
Splits pagos	Valores que sua conta deve repassar ou já repassou para outras contas Asaas
Splits recebidos	Valores que sua conta tem a receber ou já recebeu de outras contas Asaas

As tabelas apresentam informações como:

número da fatura;
conta de origem ou destino;
data de recebimento da cobrança;
data de pagamento do Split;
valor;
situação.

Filtre os resultados

Utilize os filtros para localizar uma operação específica ou delimitar o período da consulta.

Dependendo da aba, estão disponíveis filtros como:

nome da conta;
data de recebimento da cobrança;
data de pagamento do Split;
identificador externo da cobrança;
número da fatura;
situação do Split;
filtros avançados.

Interprete a situação do Split

A interface utiliza situações simplificadas para acompanhamento operacional:

Situação	Como interpretar
A pagar	Split previsto para pagamento pela sua conta
Pago	Split pago pela sua conta
A receber	Split previsto para recebimento pela sua conta
Recebido	Split recebido pela sua conta
Pendente	Split ainda em processamento
Cancelado	Split cancelado

📘
Status técnicos
Em integrações via API, os status técnicos de split podem ser apresentados com nomenclaturas como PENDING, AWAITING_CREDIT, DONE, CANCELLED, REFUSED e REFUNDED.
Ao conciliar dados da interface com dados de API, considere a diferença entre a situação exibida na interface e o status técnico retornado pela API.

Exporte os dados em CSV

Utilize a exportação para conciliações manuais, análise em planilhas ou compartilhamento com áreas financeiras.

🚧
Atenção
Antes de exportar o CSV, aplique os filtros desejados.
A exportação deve refletir o conjunto de dados exibido ou selecionado na consulta, conforme os filtros aplicados na tela.

Consulte estatísticas via API

Para consultas automatizadas, utilize:

GET /v3/finance/split/statistics

Esse endpoint recupera estatísticas de Split e pode ser utilizado para alimentar relatórios ou dashboards internos.

Consulte o endpoint Recuperar valores de split.

🚧
Importante
Chamadas GET devem ser realizadas com o body vazio.
Caso o body da requisição seja preenchido, a API poderá retornar erro 403 Forbidden.

Exemplo:

curl --request GET \
  --url https://api-sandbox.asaas.com/v3/finance/split/statistics \
  --header 'accept: application/json' \
  --header 'access_token: $ASAAS_API_KEY'

📘
Recomendação
Use a API quando precisar automatizar consultas ou alimentar relatórios internos.
Use a interface quando precisar validar informações visualmente, aplicar filtros manuais ou exportar dados pontuais em CSV.

Para acompanhar a liquidação de um Split em tempo real, utilize o evento PAYMENT_SPLIT_DONE em vez de realizar consultas recorrentes.

Consulte os Eventos para cobranças.

Disponibilidade da interface

📘
Contas BaaS
Essa opção não está disponível para contas BaaS, já que o cliente não tem acesso à aplicação web.
Para operações BaaS, consulte os dados necessários via API ou pelos fluxos definidos para a integração.

Se o menu Split de pagamentos não aparecer, verifique se a conta possui Splits configurados e se o usuário possui acesso às informações financeiras.

Problemas na consulta

Situação	Como agir
Split não aparece	Revise os filtros e confirme se a cobrança possui Split
Valor diferente do esperado	Confira o valor líquido, a configuração e possíveis estornos, antecipações ou cancelamentos
Split permanece pendente	Verifique o processamento da cobrança e possíveis bloqueios
CSV não apresenta os dados esperados	Revise período e filtros antes de exportar
API retorna `401`	Valide a API Key e o ambiente utilizado
API retorna `403` na consulta de estatísticas	Envie a requisição `GET` sem body

Próximos passos

Updated 6 days ago

Did this page help you?