Escriturador SPED

A biblioteca Escriturador SPED tem como objetivo fornecer uma API de acesso, criação e manipulação de arquivos de escrituração pertencentes ao projeto SPED do governo brasileiro. A biblioteca escrita em Python é destinada a programadores, ou usuários avançados, que trabalham com módulos do projeto SPED que envolvam a criação ou edição de escriturações.

Especificamente esse projeto permite que o desenvolvedor abra, busque, altere e salve a estrutura de uma escrituração. Essa biblioteca não realiza a validação individual ou total dos valores dos campos, apenas a formatação desses campos é garantida. A única maneira oficial de validar uma escrituração é usando os programas disponibilizados pelo governo.

Início Rápido

Instale a biblioteca com:

pip install escriturador-sped

Exemplo básico de uso:

from escriturador_sped import EscrituracaoEfdIcmsIpi, RegistroEfdIcmsIpi

# Abrindo o arquivo de escrituração
escrituracao = EscrituracaoEfdIcmsIpi.abrir("original.txt")

# Adicionando um novo produto na escrituração (registro 0200 do bloco 0)
escrituracao["0"].abertura.adicionar(
    RegistroEfdIcmsIpi("|0200|100|PRODUTO|||UN|00|00000000||||||")
)

# Encontrando a nota de entrada com número 123
nota_123 = escrituracao.primeiro("C100", { "IND_OPER": "0", "NUM_DOC": 123 })

# Alterando a data de entrada da nota
nota_123.DT_E_S.valor = "07091822"

# Mostrando todos os registros associados a essa nota
print(nota_123.texto())

# Totalizando os registros do bloco 9
# Necessário apenas quando há adição ou remoção de registros
escrituracao.totalizar(ordenar_9900=True)

# Salvando a escrituração alterada para outro arquivo
escrituracao.salvar("alterada.txt")

Módulos Suportados

Suporte e Manutenção

Com a implementação da reforma tributária a expectativa é que a EFD Contribuições se torne extinta a partir de 2027, enquanto o EFD ICMS IPI tem previsão de ser substituído em 2029.

Por causa disso, em conjunto com o fato de que essa biblioteca está atualmente em uso no Kepi Supermercado aonde trabalho, eu me comprometo a manter essa biblioteca estável e atualizada com os manuais mais recentes do SPED até a extinção do EFD ICMS IPI em 31/12/2028.

Problemas encontrados em algum dos módulos ou na biblioteca em geral podem ser reportados na página de issues.