Pular para conteúdo

SPED — Índice da Documentação

Objetivo

Documentação de referência completa, rastreável campo a campo, de todas as obrigações acessórias SPED geradas pela localização brasileira CIEL IT no Odoo EE.

Público-alvo: Suporte, Implantação, Desenvolvimento, Comercial Técnico e Liderança Operacional.

Obrigações Mapeadas

# Obrigação Status Model Odoo Linhas Documentação
1 EFD ICMS/IPI (SPED Fiscal) ✅ Produção sped.fiscal 3.131 02-efd-icms-ipi.md
2 EFD Contribuições (PIS/COFINS) ✅ Produção sped.contribuicao 2.021 03-efd-contribuicoes.md
3 ECD (SPED Contábil) ✅ Produção sped.ecd.fiscal 1.004 04-ecd.md
4 ECF (IRPJ/CSLL) ⚠️ Stub/Parcial sped.ecf 751 05-ecf.md
5 DCTF ⚠️ Parcial dctf 934 06-dctf-dime-outras.md
6 DIME/SC ✅ Produção dime.sc 1.142 06-dctf-dime-outras.md

Total de código analisado: ~8.983 linhas de Python

Bloco Registros Principais Documentação
Bloco 0 0000, 0002, 0005, 0100, 0150, 0175, 0190, 0200, 0205, 0220, 0300, 0400, 0450, 0460, 0500, 0600 bloco-0.md
Bloco C C100, C101, C110, C113, C120, C140, C141, C170, C190, C195, C197, C500, C590 bloco-c.md
Bloco D D100, D190, D195, D197, D500, D590 bloco-d.md
Bloco E E100, E110, E111, E113, E116, E200, E210, E250, E300, E310, E316, E500, E510, E520 bloco-e.md
Bloco G/H G110, G125, G130, G140, H005, H010 bloco-h.md
Bloco K K010, K100, K200, K230, K235 bloco-k.md
Bloco 1 1010, 1105, 1900, 1910, 1920, 1921 bloco-1.md

Documentação Consolidada

Arquivo Conteúdo
01-visao-geral-sped.md Arquitetura, mecanismo _registro_em_uso(), ordem de geração, models auxiliares
07-mapeamento-tecnico-sped.md Cross-reference Campo Odoo ↔ Campo SPED ↔ Método Python
08-erros-comuns-sped.md Catálogo de erros com causa, solução e menu do sistema
09-como-diagnosticar-campos.md Guia passo a passo para investigar campos incorretos

Convenções de Ícones

Ícone Significado Alterável?
🏢 Empresa (res.company) ✅ Empresa → aba Localização BR
👤 Parceiro (res.partner) ✅ Contatos → campos BR
📦 Produto (product.product) ✅ Inventário → Produtos
📄 Fatura (account.move) ✅ Contabilidade → Faturas
📋 Linha de fatura (account.move.line) ✅ Dentro da fatura
💰 Motor Fiscal (cálculo automático) ✅ Via Operação Fiscal
🏦 Conta contábil (account.account) ✅ Contabilidade → Plano de Contas
⚙️ Configuração (parâmetro do registro SPED) ✅ Na tela do SPED
🔒 Fixo no código — hardcoded ❌ Requer desenvolvimento
🧮 Calculado/derivado de outros campos ❌ Altera-se a fonte
⚠️ Stub/TODO — não implementado ❌ Requer desenvolvimento

Mecanismo de Habilitação de Registros

Regra fundamental: Todo registro SPED é controlado por _registro_em_uso(). Somente registros listados na configuração da empresa serão gerados.

Obrigação Campo da empresa Menu
EFD ICMS/IPI l10n_br_sped_fiscal_registros Empresa → Localização BR → Registros SPED Fiscal
EFD Contribuições l10n_br_sped_contribuicao_registros Empresa → Localização BR → Registros SPED Contribuições
ECD (controle interno) —
ECF (controle interno) —
Obrigação Menu
EFD ICMS/IPI Faturamento → Relatórios → Relatórios Apuração Impostos → EFD ICMS IPI
EFD Contribuições Faturamento → Relatórios → Relatórios Apuração Impostos → EFD Contribuições
ECD Faturamento → Relatórios → Relatórios Apuração Impostos → Sped Contábil (ECD)
ECF Faturamento → Relatórios → Relatórios Apuração Impostos → SPED ECF
DCTF Faturamento → Relatórios → Relatórios Apuração Impostos → DCTF
DIME/SC Faturamento → Relatórios → Relatórios Apuração Impostos → DIME SC

Models Auxiliares (SPED Fiscal)

Model Finalidade Documentação
sped.fiscal.uf.icmsst ICMS-ST por UF (E200/E210) bloco-e.md
sped.fiscal.uf.difal.fcp DIFAL/FCP por UF (E300/E310) bloco-e.md
sped.fiscal.1921 Ajustes outra apuração bloco-1.md
sped.fiscal.e111 Ajustes apuração E110 bloco-e.md

Referências Cruzadas (Wiki principal)