Consulta de splits via interface

É possível acompanhar o andamento de seus splits pagos e recebidos por meio da interface do Asaas.

No menu principal, ao lado esquerdo, a opção Split de pagamentos estará disponível caso sua conta possua splits configurados.

Essa consulta permite visualizar valores a pagar, valores recebidos, status dos splits, datas relacionadas à cobrança e ao pagamento do split, além de permitir a aplicação de filtros e exportação dos dados em CSV.

Quando utilizar

Utilize esta página quando precisar acompanhar splits diretamente pela interface do Asaas.

Alguns cenários comuns incluem:

• consultar splits pagos pela sua conta;
• consultar splits recebidos de outras contas;
• acompanhar valores pendentes, pagos, recebidos ou cancelados;
• validar se um split foi processado corretamente;
• apoiar rotinas de conciliação financeira;
• conferir repasses relacionados a uma cobrança;
• localizar splits por conta, número de fatura ou identificador externo da cobrança;
• exportar dados para análise em planilhas ou relatórios internos.

Quando utilizar a API

Se desejar consultar estatísticas de split via API, utilize o endpoint de Recuperar valores de split.

Esse endpoint pode ser utilizado quando sua integração precisar:

• recuperar valores consolidados de split;
• alimentar dashboards internos;
• criar relatórios automatizados;
• acompanhar indicadores financeiros sem depender da exportação manual;
• integrar dados de split com sistemas externos de conciliação.

GET /v3/finance/split/statistics

Quando não utilizar a interface

A consulta pela interface pode não ser a melhor opção quando sua operação precisar de:

• atualização automática em sistemas externos;
• conciliação financeira em grande volume;
• geração recorrente de relatórios;
• integração com ERP, BI ou sistema contábil;
• consulta programática de estatísticas;
• operação sem acesso à aplicação web.

Nesses casos, utilize a API sempre que o dado necessário estiver disponível por endpoint.

Disponibilidade da funcionalidade

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

Pré-requisitos

Para consultar splits pela interface, é necessário que:

• a conta tenha splits configurados;
• o usuário tenha acesso à conta Asaas;
• o menu Split de pagamentos esteja disponível;
• existam cobranças com split vinculadas à operação;
• a cobrança relacionada ao split tenha sido criada corretamente;
• a conta esteja acessando o ambiente correto, Sandbox ou Produção.

Caso o menu não seja exibido, verifique se a conta possui splits configurados e se o usuário possui acesso adequado às informações financeiras.

Como acessar

Para consultar os splits pela interface:

Acesse sua conta Asaas
↓
No menu lateral, clique em Split de pagamentos
↓
Escolha entre Splits pagos ou Splits recebidos
↓
Utilize a busca ou os filtros disponíveis
↓
Analise os resultados na tabela
↓
Exporte os dados em CSV, se necessário

Splits pagos

A aba Splits pagos apresenta os valores que sua conta deve pagar ou já pagou para outras contas Asaas por meio de split.

Essa visualização é útil para acompanhar repasses realizados a parceiros, vendedores, prestadores de serviço, subcontas ou demais recebedores vinculados à sua operação.

Na tabela, é possível visualizar informações como:

Splits recebidos

A aba Splits recebidos apresenta os valores que sua conta tem a receber ou já recebeu por meio de splits configurados por outras contas.

Essa visualização é útil para recebedores que participam de operações com marketplace, plataformas, parceiros ou repasses automatizados.

Na tabela, é possível visualizar informações como:

Filtros disponíveis

Na tela de consulta, é possível buscar e filtrar os dados para localizar splits específicos.

Os filtros podem variar conforme a aba acessada, mas geralmente incluem:

Situações do split na interface

A interface apresenta a situação do split de forma simplificada para facilitar o acompanhamento operacional.

Algumas situações comuns incluem:

Exportação em CSV

A tela permite exportar os dados em arquivo CSV.

Utilize essa opção quando precisar:

• realizar conciliação manual;
• compartilhar dados com áreas financeiras;
• importar informações em planilhas;
• validar repasses de um período;
• comparar os dados da interface com registros internos;
• documentar valores pagos, recebidos, pendentes ou cancelados.

Exemplo de uso na interface

Um cenário comum é a conferência de splits pagos em determinado período.

Exemplo:

Acessar Split de pagamentos
↓
Selecionar Splits pagos
↓
Filtrar por data de recebimento da cobrança
↓
Filtrar por situação A pagar, Pago ou Cancelado
↓
Validar os valores exibidos
↓
Exportar CSV
↓
Comparar com o relatório financeiro interno

Esse fluxo ajuda a identificar valores pendentes de repasse, splits já pagos e eventuais cancelamentos.

Exemplo de uso da API

Para consultar estatísticas de split via API, utilize o endpoint de recuperação de valores de split.

Exemplo de chamada:

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

Regras importantes

Ao consultar splits, considere as seguintes regras:

• o split é configurado na cobrança por meio da API;
• a interface permite acompanhar splits pagos e recebidos quando a conta possui splits configurados;
• contas BaaS não possuem acesso a essa opção pela aplicação web;
• o valor do split é calculado com base no valor líquido da cobrança;
• valores de split podem ser fixos ou percentuais, conforme configuração realizada na cobrança;
• splits podem ser impactados por cancelamentos, estornos, antecipações, bloqueios ou divergências operacionais;
• a situação exibida na interface deve ser usada para acompanhamento e conciliação;
• para automações e indicadores internos, utilize a API quando aplicável.

Comportamentos importantes

Ao utilizar a consulta de splits via interface, considere que:

• filtros alteram os resultados exibidos na tabela;
• a busca por nome da conta ajuda a localizar splits relacionados a um recebedor específico;
• o número da fatura permite encontrar splits vinculados a uma cobrança específica;
• o identificador externo ajuda a conciliar dados com o sistema de origem;
• splits pendentes podem mudar de situação conforme o processamento financeiro da cobrança;
• splits cancelados não devem ser tratados como repasses concluídos;
• splits pagos ou recebidos devem ser conciliados com os registros internos da operação;
• a exportação em CSV deve ser feita após aplicar os filtros desejados;
• os dados exibidos na interface devem ser comparados com o sistema de origem em casos de divergência.

Impactos operacionais

A consulta de splits pode impactar diretamente rotinas financeiras e de conciliação.

Alguns impactos importantes:

• splits pendentes podem indicar valores ainda não repassados ou ainda não recebidos;
• splits cancelados podem exigir revisão da cobrança ou da regra de split aplicada;
• splits pagos ou recebidos devem ser refletidos nos controles internos da operação;
• divergências entre valores esperados e valores exibidos podem indicar erro de configuração, estorno, cancelamento ou bloqueio;
• a exportação em CSV pode ser usada como apoio em auditorias internas;
• relatórios financeiros internos devem considerar o status atual do split;
• operações com alto volume devem priorizar rotinas automatizadas via API ou relatórios internos.

Boas práticas

Para uma consulta mais segura e eficiente, recomenda-se:

• aplicar filtros antes de exportar os dados;
• conferir se a consulta está sendo feita no ambiente correto;
• validar o número da fatura em caso de divergência;
• utilizar o identificador externo da cobrança para conciliar com o sistema de origem;
• comparar os dados da interface com os registros internos da integração;
• não considerar splits pendentes como pagos ou recebidos;
• revisar splits cancelados antes de fechar relatórios financeiros;
• utilizar a API para automatizar consultas recorrentes;
• registrar internamente as conciliações realizadas;
• manter controle sobre regras de split configuradas nas cobranças.

Erros e dúvidas comuns

Checklist de conciliação

Antes de concluir uma análise de splits, valide:

• se a aba correta foi selecionada: Splits pagos ou Splits recebidos;
• se o período filtrado está correto;
• se a situação do split foi filtrada conforme a análise desejada;
• se o número da fatura corresponde à cobrança correta;
• se o identificador externo da cobrança foi usado quando disponível;
• se o valor exibido corresponde ao valor líquido e à regra de split configurada;
• se houve cancelamento, estorno, antecipação ou bloqueio;
• se o CSV exportado representa o período e os filtros esperados;
• se o sistema de origem foi atualizado conforme a situação atual do split.

Conteúdos relacionados

Consulte também:

• Split de pagamento;
• Split em cobranças avulsas;
• Split em parcelamentos;
• Split em assinaturas;
• Split em cobranças antecipadas;
• Usando o split sem API;
• Recuperar valores de split;
• Recuperar WalletId;
• Criar nova cobrança;
• Atualizar cobrança existente;
• Webhooks para cobranças.