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 |
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
- Acesse Ativos › Liquidações e clique em Novo lote por arquivo.
- Informe uma descrição para identificar o lote.
- Selecione a conta do fundo que receberá o crédito das liquidações.
- Arraste o arquivo (
.rem,.txtou.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 |
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.
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 |
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
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 |