Estrutura do arquivo de cobranças para impressão com a gráfica

Visão geral

Este artigo detalha a estrutura técnica e o layout do arquivo de cobranças gerado pelo sistema para envio e impressão em gráficas parceiras. Ele documenta como os dados são organizados em linhas, colunas, os delimitadores utilizados e o mapeamento dos registros de cabeçalho, mensagens e recibos.

Quando usar este artigo

Utilize este guia como documentação técnica ao integrar o sistema com uma nova prestadora de serviço gráfico, ou quando houver dúvidas sobre o significado das colunas, registros e limites de caracteres estruturados no arquivo de exportação de boletos.

Sintoma ou cenário

A administradora optou por imprimir os boletos externamente e a empresa gráfica contratada necessita do manual de layout do sistema para mapear a leitura de dados (etiqueta de endereçamento, itens do recibo, código de barras e mensagens institucionais).

Benefício para o usuário ou operação

• Integração eficiente: Facilita a homologação do arquivo de cobranças com sistemas de gráficas terceirizadas.

• Integridade dos dados: Garante a impressão correta dos dados sensíveis e valores nas posições exatas do formulário de boleto.

• Autonomia: Permite auditoria própria caso a gráfica aponte algum erro estrutural na importação.

Onde acessar / contexto de uso

Este arquivo é extraído durante a geração de remessas ou na central de impressão de boletos, utilizando a opção de exportação do modelo de gráfica no menu de Receitas > Arrecadações.

Pré-requisitos (Antes de começar)

• Perfil Exato: É necessário possuir permissões de geração de relatórios e exportação no módulo de Receitas.

• Recursos Sistêmicos: Os boletos da competência precisam estar gerados e liberados.

• Insumos Técnicos: Recomenda-se conhecimento básico em estruturação e leitura de arquivos delimitados (como CSV e TXT) para a plena compreensão do layout.

Causas prováveis

Homologação inicial do layout de impressão com uma nova gráfica ou necessidade de conferência técnica pelo suporte porque a gráfica relatou erro na leitura/quebra de alguma linha do arquivo enviado.

Como fazer ou corrigir

1. Estrutura Geral do Arquivo

O arquivo é composto por dados organizados em linhas. Cada linha é separada por vírgulas (,), e os campos de texto são delimitados por aspas duplas ("). Exemplo de linha do arquivo:"José da Silva","","","Rua Teste","Apto 0101","Centro","Campinas","SP",""

Analisando as linhas do arquivo, há três colunas iniciais que indicam os seguintes dados:

• Sequencial da linha: valor numérico referente ao sequencial da linha do arquivo.  
  
• Número do tipo de registro: indica qual tipo de informação será enviada.
  Exemplo:  
  Linha 12: Na segunda coluna, indica que teremos um novo tipo de registro de número 6 e na terceira coluna, valor 0 indicando que a informação será o nome do novo tipo de registro 6;
• 
  Linha 13: Na segunda coluna, indica que ainda se trata do tipo de registro 6 e na terceira coluna,o valor 1, indicando quais campos estarão presentes no tipo de registro 6;Linha 24 e 25: Na segunda coluna, indica que ainda se trata do tipo de registro 6 e na terceira coluna, o valor 2, indicando qual será a informação dos campos do tipo de registro 6.

Observe abaixo a estrutura de um arquivo de exemplo e mais adiante veremos os detalhes de sua composição:

2- Composição da estruturaResumidamente, o  arquivo é gerado com base na seguinte estrutura: 

“Linha”,”Tipo Registro”,”Tipo Informação”,”Conteúdo da Linha”.Importante:  Caso ocorra a presença de zeros, estes indicarão um comentário sobre o tipo de registro que virá posteriormente definido pelo tipo 1.

a) Tipo do arquivo - indica o tipo de arquivo gerado pelo sistema.

b) Título - Indica apenas o Título do arquivo gerado.

c) Tipo de registro 1 - Este segmento é representado apenas um comentário sobre o tipo de registro 1, e a linha seguinte que definirá a estrutura dos dados utilizados para a montagem do cabeçalho do arquivo impresso. 

d) Tipo de registro 2 - contém as informações referente às estruturas definidas nas linhas com tipo de informação 1.

e) Fim do arquivo - A linha que constar no tipo de registro e no tipo de informação, o conteúdo “99”, identifica o fim do arquivo.

3- Tamanho dos CamposDe acordo com a estrutura apresentada anteriormente, temos limites de informação nos campos:

A.  Etiqueta Endereçamento

B.  Mensagens de Cobrança

C.  Mensagens Institucional

D.  Ítens do Recibo

Resultado esperado

A equipe técnica da gráfica conseguirá programar o sistema deles utilizando essas regras lógicas de colunas e delimitadores, permitindo a importação dos arquivos mensais e a impressão em lote dos boletos com as etiquetas e os recibos formatados adequadamente.

Quando escalar

Acione o suporte técnico caso o arquivo gerado pelo sistema perca a estrutura lógica documentada (por exemplo, ausência repentina de delimitadores, mudança de colunas base) ou caso algum dado essencial do recibo não esteja sendo exportado.

Informações que devem ser reunidas antes do escalonamento

• O arquivo gerado original em anexo. (Dica: Nunca abra o arquivo no Excel antes de enviar, pois o Excel corrompe os zeros à esquerda).

• Print apontando qual linha/coluna está divergente da documentação.

• Nome do condomínio e mês da arrecadação.

Regras importantes / Observações

• Mantenha os cadastros dos moradores limpos. O uso excessivo de caracteres especiais ou quebras de linha (Enter) no meio do endereço de unidades pode afetar a leitura das aspas duplas no momento da importação pela gráfica.

Problemas comuns e como resolver

• Problema: A gráfica reportou que os CPFs, CNPJs e nosso código de barras perderam os "zeros à esquerda" e ficaram inválidos.

• Causa provável: O administrador abriu e salvou o arquivo no Excel antes de enviar à gráfica. O Excel reconhece números com zeros iniciais como valores matemáticos e corta o zero automaticamente.

• Ação recomendada: Baixe o arquivo novamente do sistema e envie diretamente para a gráfica, ou utilize um editor de texto puro, como o "Bloco de Notas" (Notepad), para visualizações prévias.

Dúvidas relacionadas

P: Qual o formato em que este arquivo é gerado? R: É gerado um arquivo de texto com estrutura delimitada por caracteres (vírgulas e aspas), geralmente nos formatos .txt ou .csv.

P: Esse arquivo substitui a remessa bancária? R: Não. Este arquivo serve exclusivamente para a confecção visual e impressão física do papel do boleto pela gráfica. O registro do boleto no banco continua dependendo do envio do arquivo de remessa padrão (CNAB) ou do uso do PJBank.

Palavras-chave de busca

Estrutura do arquivo de cobranças para impressão com a gráfica, suporte condomínios, layout, gráfica, arquivo de cobranças