Baixa por Arquivo

A baixa (liquidação) de ativos já encarteirados no fundo pode ser feita de duas formas: enviando um arquivo com todas as liquidações do dia, pelo portal do gestor/consultor, ou inserindo liquidação a liquidação pela API. As duas produzem o mesmo lote de pagamento e passam pela mesma conciliação.

	Envio por arquivo	Inserção pela API
Como funciona	Um arquivo com todas as liquidações	Uma requisição por liquidação
Formatos	CNAB 444 e CSV	JSON
Disponível em	Portal do gestor e do consultor	API de Liquidação de Ativos
Indicado para	Rotina diária de baixas em volume, a partir do retorno bancário	Baixas pontuais e integrações em tempo real

Baixa por arquivo é um fluxo de tela

Hoje o envio de arquivo de baixa está disponível no portal. Pela API de integração, a baixa é feita pelo fluxo de lote de pagamento + liquidações, sem arquivo.

Formatos aceitos

Formato	Extensão	Indicado para	Modelo
CNAB 444 — duplicatas e CT-e	.rem · .txt	Quem já recebe retorno CNAB do banco cobrador. Layout em Layout CNAB 444 — Baixa	Exemplo
CNAB 444 — CCB e operações de crédito	.rem · .txt	Mesmo layout, com o ativo identificado pelo número do contrato	Exemplo
CSV	.csv	Planilha simples, com uma linha por liquidação, para qualquer tipo de ativo. Layout na seção CSV de baixa	Exemplo

Passo a passo pela tela

1. Acesse Ativos › Liquidações e clique em Novo lote por arquivo.
2. Informe uma descrição para identificar o lote.
3. Selecione a conta do fundo que receberá o crédito das liquidações.
4. Arraste o arquivo (.rem, .txt ou .csv) e confirme.

O portal cria o lote de pagamento, envia o arquivo e dispara a validação. A tela passa a mostrar o lote com o progresso — total de liquidações, processadas e falhas.

O que acontece depois do envio

Etapa do lote	O que significa
Aguardando arquivo	Lote criado, arquivo ainda não enviado
Validação em andamento	Arquivo recebido, sendo conferido linha a linha
Criando o lote	Arquivo válido, lote de pagamento sendo criado
Inserindo as liquidações	Cada linha está virando uma liquidação
Concluído	Todas as liquidações processadas
Concluído com falhas	Lote processado, mas com liquidações que falharam individualmente
Recusado	Arquivo recusado na validação — nada foi processado

Validação é tudo ou nada

Uma linha inválida recusa o arquivo inteiro. O portal informa o número da linha e a descrição do erro. Corrija e envie um lote novo, com um novo identificador.

Depois que o lote é encerrado e o pagamento confirmado, cada liquidação é conciliada individualmente na carteira do fundo — o mesmo comportamento descrito no Fluxo de liquidação. Uma liquidação pode falhar sozinha (por exemplo, ativo não encontrado na carteira) sem derrubar as demais.

CSV de baixa

Arquivo com cabeçalho na primeira linha, separado por ; ou ,. Limite de 850.000 linhas.

exemplo_baixa_liquidacoes.csv

asset_type;total_value;settlement_type;external_id;installment_number;collection_origin_type
duplicata_mercantil;1510.00;asset_settlement;CTRL000001;;borrower
duplicata_mercantil;500.00;asset_amortization;CTRL000002;;borrower
ccb;350.75;installment_settlement;CONTRATO-0001;3;borrower

Colunas

Coluna	Obrigatoriedade	Descrição
asset_type	obrigatória	Tipo do ativo. Ver valores aceitos
total_value	obrigatória	Valor da liquidação. Aceita . ou , como separador decimal
settlement_type	obrigatória	Tipo de liquidação. Ver tipos de liquidação
installment_number	obrigatória (coluna)	Número da parcela. Preencha para ativos com parcelas (CCB); deixe vazio para duplicatas e contratos
external_id ou contract_number	obrigatória	Identificador do ativo. Use external_id para duplicatas/contratos (o mesmo número de controle enviado na cessão) e contract_number para CCBs
collection_origin_type	opcional	Quem pagou: borrower (sacado), assignor (cedente) ou collection_agent (agente de cobrança)
remaining_face_value	opcional	Saldo remanescente do valor de face. Aceito somente com settlement_type: installment_amortization

A coluna de identificação define o lote inteiro

Um mesmo arquivo usa external_id ou contract_number — não os dois. Se nenhuma das duas colunas existir, o arquivo é recusado.

Tipos de liquidação

Valor	Significado
asset_settlement	Liquidação integral do ativo
asset_amortization	Pagamento parcial do ativo
installment_settlement	Liquidação integral de uma parcela
installment_amortization	Pagamento parcial de uma parcela
installment_partial_refund / asset_partial_refund	Devolução parcial
installment_refund / asset_refund	Devolução integral
fine_payment / installment_fine_payment	Pagamento de multa
gloss	Glosa
canceled	Cancelamento
rco_revenue	Receita de RCO

Tipos de ativo aceitos

ccb · cce · structured_ccb · structured_cce · structured_nce · structured_cci · duplicata_mercantil · duplicata_servicos · discounted_contract · cte

📄 Baixar CSV de exemplo

Erros mais comuns

Erro	Causa
missing_fields: [...]	Faltou uma coluna obrigatória no cabeçalho do CSV
invalid asset_type: ...	Tipo de ativo fora da lista aceita
invalid settlement_type: ...	Tipo de liquidação fora da lista aceita
invalid total_value: ...	Valor com caractere inesperado ou vazio
invalid external_id / contract_number	Identificador em branco
remaining_face_value is only allowed for settlement_type installment_amortization	Saldo remanescente informado no tipo errado
unmapped cnab layout	Arquivo CNAB com linhas fora de 444 ou 500 posições