FAQ e Troubleshooting Geral¶
Objetivo¶
Centralizar perguntas frequentes e resolução de problemas comuns da localização brasileira CIEL IT, organizadas por área funcional. Para troubleshooting específico por tema, consulte a seção dedicada em cada arquivo da wiki.
Configuração Inicial¶
P: Qual o primeiro passo após instalar o módulo?¶
R: Executar generate_all_taxes() na empresa para criar os templates de impostos.
→ Menu: Contabilidade → Configuração → Empresas → botão "Gerar Impostos"
→ Detalhes: Configuração da Empresa
P: Preciso configurar algo para cada filial?¶
R: Sim. Cada empresa (filial) precisa de:
1. CNPJ, IE, endereço completo com código IBGE
2. Certificado digital A1 (se emitir NF-e)
3. Contas contábeis de impostos mapeadas
4. Templates de impostos gerados (generate_all_taxes())
5. Integrador fiscal configurado (v1.0 ou v2.0)
Cadastros¶
P: CNPJ do parceiro mostra como inválido, mas está correto¶
R: Verificar se não há espaços ou caracteres especiais. O sistema usa validação algorítmica (dígitos verificadores). Se o CNPJ/CPF real falha na validação, pode ser que o número esteja incorreto de fato — confirme na Receita Federal. → Detalhes: Parceiros
P: Como consultar CNPJ automaticamente?¶
R: Acesse o parceiro → botão "Consultar CNPJ". Requer integração com API CNPJA configurada na empresa. → Detalhes: Parceiros
Impostos e Operações¶
P: O sistema não encontra operação fiscal para o pedido¶
R: Verificar na seguinte ordem:
1. O l10n_br_tipo_pedido do pedido corresponde a alguma operação?
2. O produto tem NCM cadastrado?
3. A operação fiscal cobre a combinação tipo_cliente + tipo_produto + destino?
4. A empresa da operação é a mesma do pedido?
→ Detalhes: Operações Fiscais
P: ICMS com alíquota diferente do esperado¶
R: Antes da operação fiscal, o sistema consulta 4 tabelas de exceção NCM/UF que podem sobrescrever a alíquota:
1. ncm.uf → NCM + UF Origem + UF Destino
2. ncm.origem.uf → Idem + Origem Mercadoria
3. ncm.ie.uf → Idem + Indicador IE
4. ncm.cliente.uf → Idem + Cliente Específico
→ Detalhes: Cálculo de Impostos
P: PIS/COFINS com base diferente do ICMS¶
R: Provável causa é a "Tese do Século" — exclusão do ICMS da base de PIS/COFINS.
Verificar flag l10n_br_exclui_icms_piscofins na empresa.
→ Detalhes: Cálculo de Impostos
P: Retenções não estão sendo calculadas¶
R: Verificar:
1. O parceiro tem valores mínimos de retenção configurados (l10n_br_irpj_ret_valor, etc.)
2. A operação fiscal tem alíquotas de retenção preenchidas
3. O valor da fatura excede o mínimo de retenção
→ Detalhes: Cálculo de Impostos
Notas Fiscais¶
P: NF-e rejeitada pela SEFAZ¶
R: Consultar o campo l10n_br_nf_log na fatura para a mensagem de erro específica.
Erros mais comuns:
- Duplicidade de NF: Número já utilizado na série
- CNPJ inválido: IE inconsistente com CNPJ/UF
- CST incompatível: CST não permitida para regime tributário
- NCM não cadastrado: NCM inexistente ou zerado
→ Detalhes: Notas Fiscais
P: Não consigo cancelar uma NF-e¶
R: O cancelamento tem prazo de 24 horas após autorização. Após este prazo, é necessário emitir NF-e de estorno/devolução. → Detalhes: Notas Fiscais
P: CCe (Carta de Correção) não aceita¶
R: Limite de 20 CCe por NF-e. Não é permitido alterar valores, CFOP, quantidade — apenas textos descritivos. → Detalhes: Notas Fiscais
Compras e Importação¶
P: "Não encontrado Diário para o tipo de pedido de entrada informado"¶
R: Criar diário de compra com l10n_br_tipo_pedido_entrada preenchido OU configurar mapeamento em tipo.pedido.diario.
→ Detalhes: Compras
P: Estoque não movimentou após confirmar pedido de compra¶
R: A operação fiscal tem l10n_br_movimento_estoque = False. Verifique a operação vinculada à primeira linha do pedido.
→ Detalhes: Compras
Estoque¶
P: Botão "Criar NF" não aparece no picking¶
R: Verificar se invoice_state ≠ 'invoiced' e se o picking está em estado válido (não cancelado/rascunho).
→ Detalhes: Estoque e Logística
Apuração¶
P: "Nenhuma regra de apuração fiscal encontrada"¶
R: Criar regras de apuração em Faturamento → Configuração → Faturamento → Regra de Apuração Fiscal para a empresa e imposto desejado. → Detalhes: Apuração de Impostos
P: Apuração no regime caixa mostra valores parciais¶
R: Isto é o comportamento esperado. No regime caixa, o imposto é apurado proporcionalmente ao valor efetivamente recebido/pago no período. → Detalhes: Apuração de Impostos
SPED¶
P: SPED Fiscal não gera o arquivo¶
R: Verificar se todas as faturas do período estão postadas e se os dados da empresa (CNPJ, IE, endereço, perfil SPED) estão completos. → Detalhes: SPED
Pagamentos¶
P: Boleto não gerado na fatura¶
R: Verificar configuração do diário bancário para CNAB e se o tipo de pedido não está em TIPO_PEDIDO_SAIDA_NO_PAYMENT.
→ Detalhes: Pagamentos e Integrações
Glossário de Termos¶
| Termo | Significado |
|---|---|
| CFOP | Código Fiscal de Operações e Prestações |
| CST | Código de Situação Tributária |
| CSOSN | Código de Situação da Operação — Simples Nacional |
| DANFE | Documento Auxiliar da Nota Fiscal Eletrônica |
| DF-e | Documento Fiscal Eletrônico |
| DIFAL | Diferencial de Alíquota |
| DUIMP | Declaração Única de Importação |
| ECD | Escrituração Contábil Digital |
| ECF | Escrituração Contábil Fiscal |
| EFD | Escrituração Fiscal Digital |
| FCP | Fundo de Combate à Pobreza |
| IBPT | Instituto Brasileiro de Planejamento e Tributação |
| IBS | Imposto sobre Bens e Serviços (Reforma Tributária) |
| CBS | Contribuição sobre Bens e Serviços (Reforma Tributária) |
| IS | Imposto Seletivo (Reforma Tributária) |
| IE | Inscrição Estadual |
| MVA | Margem de Valor Agregado |
| NCM | Nomenclatura Comum do Mercosul |
| NF-e | Nota Fiscal Eletrônica (modelo 55) |
| NFC-e | Nota Fiscal de Consumidor Eletrônica (modelo 65) |
| NFS-e | Nota Fiscal de Serviço Eletrônica |
| SPED | Sistema Público de Escrituração Digital |
| CCe | Carta de Correção Eletrônica |
| CNAB | Centro Nacional de Automação Bancária |
| CATP | Catálogo de Produtos (Siscomex) |
| REINF | Escrituração Fiscal Digital de Retenções |
Referências Cruzadas¶
- Anterior: CSTs e Tabelas de Referência
- Índice: Sumário Geral