CNAB¶

Leiautes¶

Leiaute - CNAB 444

Leiaute - CNAB 500

Estrutura do CNAB¶

Esta página tem como objetivo prover informações relacionados a Estrutura do CNAB.

O arquivo CNAB (Centro Nacional de Automação Bancária) é um formato padronizado utilizado para troca de informações entre instituições financeiras e empresas. O layout 500 e 444, especifica a estrutura de um arquivo CNAB utilizado para transações de pagamento, negociação de títilos, instruções, movimentações, entre outros.

A estrutura de um arquivo CNAB é composta por registros, que são agrupamentos lógicos de informações relacionadas a cada transação.

Basicamente,

• Registro Header: É o primeiro registro do arquivo e contém informações gerais sobre o arquivo, como identificação do originador, data de geração do arquivo, e informações de conta corrente do favorecido (opcional).

• Registro Detalhe: Esse registro contém os dados específicos de cada título. É o registro onde poderá conter uma ou mais linhas, 15/30/60/300/500+ linhas. Cada registro detalhe representa uma única linha de título onde possui informações como identificador do título, valor do título, valor da movimentação, identificador do documento/contrato, data de vencimento e emissão, número do termo de cessão, dados do sacado e cedente, entre outros dados relevantes.

• Registro Trailer: É o último registro do arquivo e tem a finalidade de totalizar as informações contidas nos registros detalhe. Esse registro contém informações como o número total de registros detalhe. É o registro mais simples, apenas para completar a estrutura lógica do CNAB.

Além desses registros principais, existem registros adicionais que podem ser utilizados para informações complementares, como registros de ocorrências, espécie de título, coobrigação, taxa de juros, endereço do sacado, entre outros.

Para melhor entendimento sobre os campos, registros e posições, consulte o layout.

Exemplos¶

Os layouts de CNAB utilizados pela FIDD são: layout CNAB500 e CNAB444.

1
2
3

08REMESSA01COBRANCA       00000010896709000170ORIGINADOR ABIENTE DE TESTES  500FIDD GROUP TEST190723        MX0000001260 0101        895547                                                                                                                                                                                                                                                                                                                                                                   000001     
1                   02000000000000000   RECEBIVEL001          000                 0000000000  000000        01NRO_DOC_0126092400000358694120000000001 18012300002000000000000    NMDOTERMO      000002295384000000000000000292687125000150SACADO TESTE                            RUA TESTE 123                                       88811223CEDENTE AMBIENTE DE TESTES                    00258547000191000000000000000000000000000000000000        00000000000000000000000000000                           000002
9                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             000003

1
2
3

01REMESSA01COBRANCA       00000036476501000196ORIGINADOR AMBIENTE DE TESTES 500FIDD GROUP TEST190723        MX0000001260 0101        895547                                                                                                                                                                                                                                                                                                           000001
1                   02000000000000000   RECEBIVEL001          000                 0000000000  000000        01NRO_DOC_0124092400000254712630000000001 18012300002000000000000 NMDOTERMO         000001853624800000000000000286942666000184SACADO TESTE                            RUA TESTE 123                                       88811223CEDENTE AMBIENTE DE TESTES                    0025854700019100000000000000000000000000000000000000000000000002
9                                                                                                                                                                                                                                                                                                                                                                                                                                                     000003

Tipos de Movimento¶

Os Tipos de Movimento no CNAB são chamados de identificação da ocorrência, também conhecida como "código de ocorrência", é um campo utilizado no layout do arquivo CNAB para indicar um código que determina o tipo de movimento que esse título terá dentro do sistema.

O código da ocorrência / código do movimento (atrelado via sistema), determina qual o tipo de processamento determinado título irá ter ao dar entrada no sistema.

• Deve ser inserido nas posições 109 a 110 do arquivo CNAB.

Exemplos:

Para outros tipos de movimento consulte o Suporte FIDD.

Espécie de Título¶

A espécie de título utilizada no CNAB é um código numérico que representa a natureza do título.

Dentro do CNAB, a espécie de título se refere a uma classificação específica para identificar o tipo do recebível que está sendo apresentado para processamento. Cada recebível pode possuir sua particularidade. Em todos tipos de movimento é essencial a informação da espécie de título.

• Deve ser inserido nas posições 148 a 149 do arquivo CNAB.

Exemplos:

Para mais espécies de título, consulte o Suporte FIDD.

Código do Originador¶

Os Originadores são a Entidade que origina as cessões dentro do Fromtis.

É um código criado pelo TI da FIDD que serve como 'passe' para entrada do CNAB no sistema.

• O código do Originador é informado nas posições 27 a 46 do arquivo CNAB, na parte do registro header.

Para solicitar o seu código de originador, entre em contato com o Suporte FIDD.

Manual WebService¶

Manual de Serviços WS do Fromtis.

Manual completo de integrações do Fromtis.

Para envio de requests ao Fromtis é necessário possuir credenciais. Solicite seu acesso ao Suporte FIDD.

Serviço de Importação Arquivo CNAB - Realiza a importação de CNAB para o Portal.

• https://fidc.fiddgroup.com/portal-servicos/servicos/soap/importacaoArquivoCnab?wsdl

Exemplo do Request:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:soap="http://soap.consulta.servicos.portal.fidc.fromtis.com.br/">
 <soapenv:Header/>
 <soapenv:Body>
 <soap:importarArquivo>
 <arquivoCnab>
 <cnpjFundo>99999999999999</cnpjFundo>
 <arquivo>cid:cnab001.zip</arquivo>
 </arquivoCnab>
 </soap:importarArquivo>
 </soapenv:Body>
</soapenv:Envelope>

Exemplo do Response:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 <S:Body>
 <ns2:importarArquivoResponse xmlns:ns2="http://soap.consulta.servicos.portal.fidc.fromtis.com.br/">
 <retornoImportacaoArquivo>
 <statusCode>000</statusCode>
 <descricaoRetorno>Importado com Sucesso, Acompanhe o arquivo pelo 
Portal.</descricaoRetorno>
 </retornoImportacaoArquivo>
 </ns2:importarArquivoResponse>
 </S:Body>
</S:Envelope>

Alternativo: Serviço de Importação Arquivo Remessa - Realiza a importação de CNAB para o sistema. https://fidc.fiddgroup.com/portal/portal-servicos/servicos/soap/importacaoArquivoRemessa?wsdl

Exemplos de outros serviços

[Serviço] Relatório de Estoque - Realiza o agendamento do relatório de estoque. https://fidc.fiddgroup.com/portal-servicos/servicos/soap/agendador/relatorioEstoque?wsdl

[Serviço] Consulta de Relatório - Realiza uma consulta de agendamento, informando seu status atual. https://fidc.fiddgroup.com/portal-servicos/servicos/soap/agendador/consultarRelatorio?wsdl

[Serviço] Download de Relatório - Realiza o download de um agendamento (ex: baixar o relatório do estoque). https://fidc.fiddgroup.com/portal-servicos/servicos/soap/agendador/realizarDownload?wsdl

[Serviço] Relatório Liquidados/Aquisição - Realiza o agendamento do relatório de liquidação/aquisição. https://fidc.fiddgroup.com/portal-servicos/servicos/soap/agendador/relatorioAquisicaoLiquidados?wsdl

Códigos de Retorno da Operação¶

Lista de códigos dos possíveis retornos das operações.

As consultas são realizadas nesse endpoint exemplo https://fidc.fiddgroup.com/portal-servicos/servicos/consulta/detalheOperacao

No final da URL, adicione: ?nomeArquivo=NomeDoArquivo.txt (Retornará detalhes da operação do arquivo consultado).

Depois do request, irá retornar algo como:

<operacao> <nomeArquivo>00000000000077_001.txt</nomeArquivo> <nomeArquivoEntrada>remessaTeste.txt</nomeArquivoEntrada> <cnpjFundo>00000000000077</cnpjFundo> <nomeCedente>CEDENTE NOME EXEMPLO</nomeCedente> <documentoCedente>00000000000000</documentoCedente> <calculoTotalPagamento>318577.52</calculoTotalPagamento> <codigoSituacaoOperacao>8</codigoSituacaoOperacao> </operacao>

Utilize o código presente na tag 'codigoSituacaoOperacao' para realizar a consulta.

Envio de Remessa - JSON¶

Manual Envio de CNAB por JSON.

Permite subir cessões para o Fromtis, simulando os campos/posições do CNAB em tags via json.

Baixe a biblioteca pronta e envie diretamente do Postman: Envio de CNAB - JSON (FIDD).

Manual FTP Lastros¶

Manual Envio de Lastros FTP.

Dúvidas? Entre em contato conosco Suporte FIDD

Ambientes¶