Erros Comuns na Geração SPED
Índice
- Erros de Pré-requisito (Todas as obrigações)
- EFD ICMS/IPI
- EFD Contribuições
- ECD
- ECF
- DCTF
- DIME/SC
- Checklist Pré-Geração
Erros de Pré-requisito
Estes erros são comuns a múltiplas obrigações:
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (0100), EFD Contribuições (0100), ECD (J930), DCTF (R03), DIME (Reg 20) |
| Causa |
company.l10n_br_contador_partner_id não preenchido |
| Solução |
Empresa → aba Localização BR → Contador |
| Botão |
"IR PARA EMPRESA" |
Erro: "Unidades de Medida sem código SEFAZ"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (0190), EFD Contribuições (0190) |
| Causa |
UoMs sem l10n_br_codigo_sefaz |
| Solução |
Inventário → Configurações → Unidades de Medida → preencher código SEFAZ |
| Botão |
"IR PARA UNIDADES DE MEDIDA" |
Erro: "Categorias de produtos sem tipo de produto"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (0200), EFD Contribuições (0200) |
| Causa |
Categorias sem l10n_br_tipo_produto |
| Solução |
Inventário → Categorias de Produtos → preencher Tipo Produto |
| Botão |
"IR PARA CATEGORIAS DE PRODUTOS" |
Erro: "Produtos sem código interno"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (0200), EFD Contribuições (0200) |
| Causa |
Produtos sem default_code |
| Solução |
Inventário → Produtos → preencher Referência Interna |
| Botão |
"IR PARA PRODUTOS" |
Erro: "Notas Fiscais sem Chave de Acesso"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (C100), EFD Contribuições (C100) |
| Causa |
NFs (exceto canceladas) sem l10n_br_chave_nf ou chave ≠ 44 dígitos |
| Solução |
Fatura → aba Localização BR → Chave NF (44 dígitos) |
| Validação |
re.match(r'^\d{44}$', chave) |
Erro: "Notas Fiscais sem Data"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Afeta |
EFD ICMS/IPI (C100), EFD Contribuições (C100) |
| Causa |
Faturas sem invoice_date ou date |
| Solução |
Abrir a fatura e preencher a data |
EFD ICMS/IPI
Arquivo gerado mas C100 vazio
| Causa |
Como verificar |
| Período errado |
Conferir date_ini / date_fim |
| Faturas em rascunho |
Faturas devem estar posted ou cancel |
l10n_br_numero_nota_fiscal = 0 |
NF não foi numerada |
| Tipo de documento incorreto |
l10n_br_tipo_documento deve ser 01/1B/04/55 |
| Registros não habilitados |
Verificar C100 na lista de registros da empresa |
| Causa |
Como verificar |
| E100 não habilitado |
E100 na lista de registros da empresa |
| C190 não gerado |
Verificar se C100 gera corretamente |
| Documentos sem ICMS |
Todas as linhas com CST isento/zero |
e110_vl_tot_debitos/creditos zerados |
⚠️ Estes são escritos pelo C190 — se C190 não gerou, ficam zerados |
ICMS-ST por UF vazio (E200/E210)
| Causa |
Como verificar |
| Sem operações com ST |
Nenhuma linha com l10n_br_icmsst_valor > 0 |
| UF não adicionada |
line_icmsst_ids vazio no registro SPED → adicionar UFs manualmente na aba ST |
DIFAL/FCP por UF vazio (E300/E310)
| Causa |
Como verificar |
| Sem operações interestaduais |
Nenhuma linha com l10n_br_icms_dest_valor > 0 |
| UF não adicionada |
line_difalfcp_ids vazio → adicionar UFs na aba DIFAL/FCP |
CIAP/Inventário (G/H) vazio
| Causa |
Como verificar |
| G110 comentado |
O método enviar_registro_G110() está comentado com # TODO CIAP |
| H005 sem data/valor |
Campos h005_dt_inv e h005_vl_inv não preenchidos |
| Sem valorização de estoque |
Necessita stock.valuation.layer com dados |
EFD Contribuições
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Método |
enviar_registro_0150() |
| Causa |
Parceiro com l10n_br_ie com mais de 14 caracteres |
| Solução |
Contatos → abrir parceiro → corrigir IE |
| Botão |
"IR PARA CLIENTES" |
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Método |
enviar_registro_0150() |
| Causa |
Parceiro brasileiro sem l10n_br_municipio_id.codigo_ibge |
| Solução |
Contatos → abrir parceiro → preencher Município |
| Botão |
"IR PARA CLIENTES" |
Bloco A vazio
| Causa |
Como verificar |
| Tipo documento errado |
Deve ser NFS, NFSE ou NDS |
| A001/A010 não habilitados |
Verificar registros da empresa |
| Entradas sem crédito PIS |
Linhas não têm pis_cst in PIS_CST_CREDITO |
Bloco F vazio
| Causa |
Como verificar |
| Tipo documento errado |
Deve ser ND, NDS ou FAT |
| F001/F010 não habilitados |
Verificar registros |
F600 vazio (Retenção)
| Causa |
Como verificar |
| Sem retenções PIS/COFINS |
sum(pis_ret + cofins_ret) == 0 nas faturas |
f600_usar_cr = True mas sem pagamentos |
Nenhum account.payment conciliado no período |
| Fator proporcionalidade ≤ 0 |
total_liq ≤ 0 → divisão impossível |
| Lucro presumido + entrada |
Entradas de serviço não geram F600 em lucro presumido |
M200/M600 todo zerado
| Causa |
Situação |
| Comportamento normal |
A apuração detalhada (M100/M210/M500/M610) está comentada no código |
| O que funciona |
Somente VL_RET_NC e VL_RET_CUM (vindos do F600) são preenchidos |
| Solução |
Após exportação, processar no PVA para apuração completa |
Entradas não aparecem (Lucro Presumido)
| Regra |
Condição |
| Lucro presumido + não-devolução |
IND_OPER == 0 e move_type != 'out_refund' e incidencia_cumulativa == '2' |
| Correto: LP só gera entradas de devolução |
Isto é regra fiscal, não bug |
ECD
Erro: "Contas sem Grupo Sintético"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Método |
enviar_registro_I050() |
| Causa |
Contas com saldo no período sem group_id |
| Solução |
Contabilidade → Plano de Contas → atribuir Grupo |
Erro: "Contas sem conta referencial"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Método |
enviar_registro_I050() |
| Causa |
Contas com l10n_br_cod_nat ≠ 05/09 sem l10n_br_conta_referencial |
| Solução |
Contabilidade → Plano de Contas → preencher Conta Referencial |
| Causa |
Como verificar |
| Lançamentos em rascunho |
Todos os assentamentos devem estar postados |
| Período parcial |
A ECD cobre o ano completo |
| Encerramento não realizado |
Contas de resultado devem ser zeradas antes da ECD |
ECF
⚠️ A ECF está em status Stub. Erros de validação são esperados — ~95% dos campos estão com #TODO ou valores placeholder.
DCTF
Erro: "Não tem um contador selecionado"
| Atributo |
Detalhe |
| Tipo |
UserError |
| Método |
enviar_registro_R03() |
| Solução |
Empresa → aba Localização BR → Contador |
Valores zerados nos débitos (R10)
| Causa |
Como verificar |
| Faturas sem impostos federais |
l10n_br_irpj_valor, l10n_br_pis_valor zerados |
| Período sem faturas |
Sem faturas posted no período selecionado |
| Causa |
Situação |
| Dados hardcoded |
⚠️ Os registros R14-R31 usam CNPJ e valores fixos de teste |
| Status |
Estes registros não devem ser usados em produção |
DIME/SC
Erro: "Não foi encontrado o SPED Fiscal"
| Atributo |
Detalhe |
| Tipo |
UserError |
| Método |
gerar_dime_sc() |
| Causa |
Não existe sped.fiscal para (company_id, date_ini, date_fim) |
| Solução |
Gerar o SPED Fiscal antes da DIME |
Erro: "Base do ICMS maior que total da NF-e"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Causa |
l10n_br_icms_base > l10n_br_total_nfe em fatura (exceto importação) |
| Solução |
Corrigir base ICMS ou total NF na fatura indicada |
| Nota |
Importações (l10n_br_tipo_pedido_entrada == 'importacao') são excluídas desta validação |
Erro: "Notas Fiscais sem CFOP"
| Atributo |
Detalhe |
| Tipo |
RedirectWarning |
| Causa |
Linhas de fatura sem l10n_br_cfop_id |
| Solução |
Preencher o CFOP em todas as linhas |
Erro na Validação SEFAZ/SC
| Atributo |
Detalhe |
| Tipo |
UserError |
| Método |
validar_dime_sc() |
| Causa |
Retorno de erro do webservice SOAP |
| Info |
O sistema parseia DtoErro com Linha e Mensagem |
| Solução |
Ler as mensagens detalhadas e corrigir os dados |
Checklist Pré-Geração
Cadastro da Empresa
Cadastro de Parceiros
Cadastro de Produtos
Contas Contábeis (ECD)
Faturas do Período
Dependências entre Obrigações
Referências