cielo-edi 15.14.1

Parser Cielo EDI: converte CIELO03/04/09/15/16 para JSON/CSV

Cielo EDI Parser

Parser para arquivos Cielo EDI (Extrato Eletrônico). Converte CIELO03/04/09/15/16 para JSON ou CSV.

Features

• Suporta CIELO03/04/09/15/16
• Validação com Pydantic v2
• Streaming para arquivos grandes
• Exportação JSON e CSV
• CLI incluída

Instalação

pip install cielo-edi

Requisitos: Python 3.9+, Pydantic 2.5+ e pytest (para testes)

Uso

from cielo_edi import CieloEDIParser, JSONExporter, CSVExporter

parser = CieloEDIParser()
resultado = parser.processar("CIELO04_20241218.txt")

# Acessar dados
print(f"Tipo: {resultado.tipo_arquivo_descricao}")
print(f"Valor: R$ {resultado.estatisticas.valor_liquido_total:,.2f}")

for detalhe in resultado.detalhes:
    print(f"{detalhe.nsu_doc} | R$ {detalhe.valor_liquido_venda:,.2f}")

# Exportar JSON
exporter = JSONExporter(indent=2)
exporter.exportar_arquivo(resultado, "saida.json")

# Exportar CSV
CSVExporter(delimiter=";").exportar_todos(resultado, "./csv/")

# Streaming (arquivos grandes)
for registro in parser.processar_streaming("arquivo_10GB.txt"):
    processar(registro)

CLI

cielo-edi arquivo.txt -o resultado.json
cielo-edi arquivo.txt --formato csv --diretorio ./saida
cielo-edi arquivo.txt --info

Tipos de Arquivo

Código	Descrição
CIELO03	Captura/Previsão
CIELO04	Liquidação/Pagamento
CIELO09	Saldo em Aberto
CIELO15	Negociação de Recebíveis
CIELO16	Pix

Tipos de Registro

Código	Descrição
0	Header
D	UR Agenda (Unidade de Recebimento)
E	Detalhe do Lançamento
8	Transação Pix
A	Resumo de Negociação
B	Detalhe de Negociação
C	Conta de Recebimento
R	Reserva Financeira
9	Trailer

Links

• Repositório
• Issues

Licença

MIT - Esta biblioteca não é oficial e não possui vínculo com a Cielo.