Pular para conteúdo

ECD — Model e Interface

Model Principal

Atributo Valor
Model Odoo l10n_br_ciel_it_account.sped.ecd
Classe Python AccountSpedEcdFiscal
Arquivo l10n_br_ciel_it_account/models/account_sped_ecd.py
View XML l10n_br_ciel_it_account/views/account_sped_ecd.xml
Menu Faturamento → Relatórios → Relatórios Apuração Impostos → Sped Contábil (ECD)
Sequência do menu 380
Controle multiempresa Sim (_check_company_auto = True)

Campos da Interface

Aba "Principal"

Campo Tipo Obrigatório Default Editável Descrição
company_id Many2one → res.company Sim Empresa do usuário Sim Empresa para a qual será gerada a ECD
date_ini Date Sim — Sim Data inicial do período (normalmente 01/Jan)
date_fim Date Sim — Sim Data final do período (normalmente 31/Dez)
name Char Não Gerado automaticamente Não (readonly) Protocolo do arquivo (UUID + datas)
arquivo_sped_ecd Binary Não — Não (readonly) Arquivo TXT gerado para download
arquivo_sped_ecd_fname Char Não {name}.TXT Não (computed) Nome do arquivo para download

Aba "Parâmetros"

Campo Tipo Obrigatório Default Valores Efeito na Geração
cod_plan_ref Selection Sim '2' (LP) Ver tabela abaixo Grava no registro 0000 campo COD_PLAN_REF
ind_esc Selection Sim 'G' Ver tabela abaixo Grava no I010 (IND_ESC), reflete na descrição de I030 e J900
cod_ver_lc Char Sim '9.00' Livre Grava no I010 campo COD_VER_LC

Plano de Contas Referencial (cod_plan_ref)

Código Descrição
1 PJ em Geral — Lucro Real
2 PJ em Geral — Lucro Presumido
3 Financeiras — Lucro Real
4 Seguradoras — Lucro Real
5 Imunes e Isentas em Geral
6 Imunes e Isentas — Financeiras
7 Imunes e Isentas — Seguradoras
8 Entidades Fechadas de Previdência Complementar
9 Partidos Políticos
10 Financeiras — Lucro Presumido

Como escolher: O valor deve corresponder ao regime tributário e tipo da empresa perante a RFB. A maioria das empresas no Lucro Presumido usa '2', e no Lucro Real usa '1'.

Indicador de Escrituração (ind_esc)

Código Descrição Quando usar
G Livro Diário completo sem escrituração auxiliar Mais comum — escrituração completa
R Livro Diário com escrituração resumida Quando há livro auxiliar separado
A Livro Diário Auxiliar Complemento ao tipo R
B Livro Balancetes Diários e Balanços Instituições financeiras
Z Razão Auxiliar parametrizável Leiaute definido nos registros I500-I555

Impacto: O valor de ind_esc é usado em 3 registros: I010 (IND_ESC), I030 (NAT_LIVR — texto descritivo) e J900 (NAT_LIVRO — texto descritivo).

Botões da Interface

Botão "GERAR"

Atributo Valor
Visível quando arquivo_sped_ecd == False (arquivo ainda não gerado)
Método gerar_sped()
Estilo btn-primary
O que faz Executa toda a geração da ECD, serializa o arquivo TXT e grava nos campos arquivo_sped_ecd, name e situacao

Botão "Voltar para provisório"

Atributo Valor
Visível quando arquivo_sped_ecd != False (arquivo já gerado)
Método action_draft()
O que faz Limpa todos os campos de resultado (name, arquivo, situacao, arquivo_sped_ecd) para permitir regeneração

Fluxo de Uso

flowchart TD
    A["Criar novo registro SPED ECD"] --> B["Preencher empresa, período e parâmetros"]
    B --> C["Clicar GERAR"]
    C --> D{"Validações passam?"}
    D -->|"Não"| E["RedirectWarning com link para correção"]
    E --> F["Corrigir cadastro"]
    F --> C
    D -->|"Sim"| G["Geração do TXT"]
    G --> H["Arquivo disponível para download"]
    H --> I["Importar no PVA da RFB"]
    I --> J["Assinar e transmitir"]
    H --> K["Regenerar?"]
    K -->|"Sim"| L["Voltar para provisório"]
    L --> C

Passo a passo

  1. Acessar Faturamento → Relatórios → Relatórios Apuração Impostos → Sped Contábil (ECD)
  2. Clicar Criar
  3. Preencher Empresa, Data Inicial e Data Final
  4. Na aba Parâmetros, selecionar o Plano Referencial, Indicador de Escrituração e Versão do Leiaute
  5. Clicar GERAR
  6. Se houver erros de cadastro, o sistema exibe um alerta com botão de redirecionamento
  7. Após correção, clicar GERAR novamente
  8. Download do arquivo .TXT gerado
  9. Importar no PVA da Receita Federal para validação, assinatura e transmissão

Referências