Automação fiscal REINF / eSocial.

O que é

irb-reinf é um sistema de linha de comando (CLI) que automatiza todo o ciclo da obrigação acessória REINF: cadastros, lançamentos, envio, recibo e geração dos comprovantes para os médicos.

O problema que resolve

A IRB precisa, mensalmente, enviar à Receita Federal as informações de rendimentos pagos aos profissionais. Manualmente isso significa montar planilhas, gerar XMLs no formato certo, assinar com certificado digital, enviar pelo portal do governo, esperar retorno, conferir erros, e ainda emitir os comprovantes individuais para cada profissional.

Esta automação faz tudo isso sem intervenção manual.

Como funciona

1 · Geração dos XMLs

Três geradores cobrem os eventos exigidos:

• R-1000 — informações do contribuinte (a própria IRB)
• R-1050 — informações de outras entidades
• R-4010 — pagamentos / créditos a beneficiário pessoa física (o evento que importa para os médicos)

2 · Envio ao webservice

Cliente Python que conversa com o webservice da Receita Federal, assina digitalmente os XMLs com o certificado da empresa, envia, recebe o protocolo, e armazena a evidência.

3 · Geração dos PDFs

Para cada evento aceito, gera automaticamente um PDF de informe de rendimentos no padrão do governo, pronto para entregar ao profissional.

4 · Auditoria

Toda operação é registrada em um banco local de auditoria (data/audit/), com timestamp, payload enviado, retorno recebido e status.

Estrutura

```

irb-reinf/

├── cli.py # Ponto de entrada

├── irb_reinf/

│ ├── generators/

│ │ ├── xml_r1000.py

│ │ ├── xml_r1050.py

│ │ ├── xml_r4010.py

│ │ └── pdf_informe.py

│ ├── webservice/

│ │ └── reinf_client.py

│ ├── audit/

│ └── config.py

├── data/

│ ├── output/

│ │ ├── xmls/

│ │ ├── pdfs/2025/

│ │ └── relatorios/

│ └── audit/

└── tests/

```

Resultado de produção

Fechamento de dezembro de 2025 (executado em 08/05/2026):

• 36 lançamentos R-4010 aceitos pela Receita
• 36 PDFs de informe gerados
• Zero rejeições após correção do envio
• Período fechado corretamente
• Ambiente validado em produção

Relatório completo:

• irb-reinf/data/output/relatorios/relatorio-producao-2025-12-20260508-1554.md
• irb-reinf/data/output/relatorios/relatorio-entrega-irb-reinf-12-2025.pdf

Operação contínua

Para os próximos fechamentos mensais, o procedimento é:

1. Carregar os lançamentos do mês (via CLI ou import)
2. Rodar geração + envio
3. Conferir relatório
4. PDFs ficam automaticamente disponíveis no portal de comprovantes

A documentação operacional acompanha cada passo com exemplos prontos.