Formato do arquivo

O mesmo formato vale para o upload pelo portal e para o canal por bucket.

O pacote: um ZIP com CSVs

• Um arquivo ZIP por lote, contendo arquivos .csv (ou .txt com conteúdo CSV).
• Cada CSV tem linha de cabeçalho com o nome das colunas.
• O separador e a codificação são os da sua rotina de ingestão. O comum é ponto e vírgula (;) e UTF-8.
• Um ZIP pode trazer vários CSVs: por exemplo, o cadastro e as movimentações do dia. A rotina de ingestão reconhece cada um pelo nome do arquivo dentro do ZIP.
• Um arquivo pode vir só com o cabeçalho, sem linhas: num envio diário é normal não haver mudança de cadastro.
• Não são aceitos: ZIP dentro de ZIP, ZIP com senha, links simbólicos e arquivos de outros tipos. Os limites de tamanho estão em Limites.

Os layouts

A Zabit organiza os dados em quatro layouts. Cada CSV do ZIP corresponde a um deles:

Layout	O que traz	Campos obrigatórios
Cadastro	os seus clientes (titulares) e o perfil de cada um	documento (CPF ou CNPJ) e tipo de pessoa (PF ou PJ)
Movimentação	as transações de cada titular, por produto	documento do titular, valor, sentido (crédito, débito ou pagamento) e data da transação
Relacionamento	vínculos entre pessoas (sócios, beneficiários, representantes)	documento do titular, documento da pessoa relacionada e tipo de vínculo
Posição	o saldo do titular observado numa data	documento do titular, saldo e data da observação

Além dos obrigatórios, cada layout aceita campos opcionais que enriquecem o monitoramento. No cadastro: nome ou razão social, renda ou faturamento, patrimônio, classificação de risco, PEP, data de nascimento ou fundação e endereço. Na movimentação: data e hora, identificador da transação, contraparte (documento, nome, tipo de pessoa e instituição), espécie (dinheiro vivo), moeda, país, descrição, MCC e estabelecimento, entre outros. Colunas que não correspondem a nenhum campo podem ser guardadas como campos adicionais do titular.

Formatos dos valores que a Zabit converte:

Tipo	Exemplos aceitos
Documento	123.456.789-09 ou 12345678909 (a pontuação é removida)
Valor em reais	3.000,00 ou 3000.00
Data	28/10/2026 ou 2026-10-28 (ano com 4 dígitos)
Data e hora	28/10/2026 14:32:05
Tipo de pessoa	F, PF, FISICA / J, PJ, JURIDICA
Sim ou não	S/N, 1/0, true/false

Rotina de ingestão

Você não precisa renomear as suas colunas para o vocabulário da Zabit. Quem traduz o seu layout é a rotina de ingestão, configurada para o seu espaço de trabalho:

• qual arquivo do ZIP é de qual layout (pelo padrão do nome, por exemplo cadastro-cliente*.csv);
• qual coluna do seu arquivo alimenta cada campo (por exemplo, vlr_transacao → valor);
• o separador, a codificação e a conversão de cada coluna;
• os códigos do seu sistema que viram um valor da Zabit, como o sentido da transação (1 = crédito, 2 = débito);
• as colunas obrigatórias e o percentual máximo de linhas recusadas que o lote tolera.

A rotina é montada com você na habilitação, a partir de um arquivo real seu, e fica visível no app em Monitoramento › Processamentos › Rotinas de ingestão. Se você tem mais de uma rotina ativa, indique qual usar no sidecar do envio por bucket ou no formulário do portal.

Uma linha que não passa nas validações da rotina (documento inválido, data inexistente, valor zero onde não pode) é recusada sozinha e o resto do lote segue. Se a proporção de linhas recusadas passa do limite da rotina, o lote inteiro termina em erro: isso protege contra um mapeamento quebrado, que recusaria quase tudo.

Amostra para teste

Antes de ligar o envio automático, valide o layout com um lote pequeno:

1. Monte um ZIP com poucas linhas, no mesmo layout do arquivo de produção.
2. Envie pelo portal ou pelo bucket, no espaço de trabalho de teste combinado com a Zabit.
3. Confira o recibo: concluido com as contagens esperadas, ou o motivo que aponta o ajuste.

Exemplo ilustrativo de um CSV de movimentação (os nomes de coluna são os seus; a rotina os mapeia):

documento_cliente;tipo_pessoa;data_transacao;valor;tipo_lancamento;id_transacao
11144477735;F;28/10/2026;1.250,00;C;TX-000001
11144477735;F;28/10/2026;80,50;D;TX-000002
11222333000181;J;28/10/2026;15.000,00;C;TX-000003

Use dados fictícios ou de teste na amostra. Não envie dados reais de clientes para validar layout.

Preciso cifrar o CSV?

Não. No canal da Zabit o arquivo já está protegido em todo o caminho:

• em trânsito, por TLS, exigido pelo bucket e pelo portal;
• em repouso, pela criptografia do bucket com uma chave dedicada ao canal (SSE-KMS), exigida em todo envio;
• no acesso, porque só a identidade que você indicou grava na sua pasta, e ninguém de fora da Zabit lê o que foi enviado.

Uma camada extra de cifra no próprio CSV não acrescenta proteção a esse caminho e cria um segredo a mais para guardar e trocar. Envie o CSV dentro do ZIP sem cifra adicional. Os controles estão resumidos em Segurança do canal.