Pular para conteúdo

TX2 — Erros Comuns e Diagnósticos

Objetivo

Referência rápida de erros e problemas frequentes na geração de TX2/JSON para NF-e, NFS-e, NFC-e e cobrança escritural, com sintoma, causa, validação e correção.

Erros de NF-e

1. "Operação Fiscal não informada"

  • Sintoma: UserError ao tentar gerar NF-e
  • Causa: l10n_br_operacao_id vazio OU l10n_br_numero_nfe_id não configurado no documento fiscal
  • Validação: Verificar campo "Operação Fiscal" na fatura
  • Correção: Preencher operação fiscal ou configurar sequência no documento fiscal
  • Abrir chamado: Não — configuração

2. "Condição de pagamento 'ANTECIPADO' exige que a fatura esteja paga"

  • Sintoma: Bloqueio ao gerar NF-e
  • Causa: Condição de pagamento com is_advpay = True e fatura não paga
  • Validação: Verificar payment_state da fatura
  • Correção: Registrar pagamento antes de gerar NF-e
  • Abrir chamado: Não — regra de negócio

3. "Indicador de IE não informado para o parceiro"

  • Sintoma: UserError ao montar TX2
  • Causa: Parceiro brasileiro sem l10n_br_indicador_ie
  • Validação: Abrir cadastro do parceiro
  • Correção: Preencher campo "Indicador IE" (1=Contribuinte, 2=Isento, 9=Não contribuinte)
  • Abrir chamado: Não — cadastro

4. "Código IBGE do município não informado para o parceiro"

  • Sintoma: UserError ao montar TX2
  • Causa: Município do parceiro sem codigo_ibge
  • Validação: Verificar se município tem código IBGE
  • Correção: Selecionar município correto no parceiro
  • Abrir chamado: Se município não existe na base

5. "Código da unidade de medida SEFAZ não informado para o produto"

  • Sintoma: UserError ao montar TX2 do item
  • Causa: UdM sem l10n_br_codigo_sefaz nem l10n_br_codigo_sefaz_custom
  • Validação: Verificar unidade de medida do produto
  • Correção: Preencher código SEFAZ na UdM
  • Abrir chamado: Se não sabe qual código usar

6. "Modalidade de frete não configurada para a fatura"

  • Sintoma: UserError ao montar TX2
  • Causa: Incoterm sem l10n_br_modalidade_frete
  • Validação: Verificar incoterm na fatura
  • Correção: Preencher modalidade de frete no incoterm
  • Abrir chamado: Não — configuração

7. "Meio de pagamento não configurado para a fatura"

  • Sintoma: UserError ao montar TX2 de pagamento
  • Causa: Condição de pagamento e provedor sem l10n_br_meio
  • Validação: Verificar condição de pagamento
  • Correção: Preencher l10n_br_meio na condição de pagamento ou provedor
  • Abrir chamado: Não — configuração

8. NCM vazio gerando rejeição

  • Sintoma: SEFAZ rejeita NF-e com CST incompatível
  • Causa: Produto sem NCM ou NCM zerado
  • Validação: Verificar l10n_br_ncm_id no produto
  • Correção: Preencher NCM no produto
  • Abrir chamado: Se NCM correto não existe na base

9. "EspdManNFeEnviadaJaExisteException"

  • Sintoma: NF-e com situação excecao_autorizado
  • Causa: NF-e com mesmo número/série já existe no integrador
  • Validação: Log no chatter mostra a chave existente
  • Correção: Sistema tenta resolver automaticamente via action_resolver_nfe()
  • Abrir chamado: Se resolver automático falhar

10. Produtos sem Origem

  • Sintoma: RedirectWarning apontando para lista de produtos
  • Causa: Produto sem l10n_br_origem e linha sem l10n_br_origem
  • Validação: Clicar no link "IR PARA PRODUTOS"
  • Correção: Preencher origem no produto (0=Nacional, 1=Estrangeira importação direta, etc.)
  • Abrir chamado: Não — cadastro

Erros de NFS-e

11. "Nota Fiscal de Serviço não pode ter mais de 1 item"

  • Sintoma: UserError ao gerar NFS-e
  • Causa: Fatura com múltiplas linhas e município sem suporte multi-item
  • Validação: Contar linhas da fatura
  • Correção: Ativar parâmetro unificar_item_nfse ou usar l10n_br_descricao_servico unificado
  • Abrir chamado: Não — configuração

12. Código de serviço rejeitado pelo município

  • Sintoma: NFS-e rejeitada
  • Causa: l10n_br_codigo_servico do produto incorreto para o município
  • Validação: Verificar código no produto vs. lista de serviços do município
  • Correção: Corrigir no cadastro do produto
  • Abrir chamado: Se código correto não é aceito (possível variação por município)

13. ISS não retido quando deveria

  • Sintoma: NFS-e sem retenção de ISS
  • Causa: Operação fiscal sem alíquota de retenção ISS, ou valor abaixo do mínimo
  • Validação: Verificar l10n_br_iss_ret_valor na linha
  • Correção: Revisar operação fiscal e alíquotas de retenção
  • Abrir chamado: Se regra de retenção está incorreta

13a. "Para produtos com indicação de imóvel, é necessário informar o Imóvel na fatura"

  • Sintoma: UserError ao gerar NFS-e
  • Causa: Produto configurado com l10n_br_infendobraimovel = 'obra', 'imovel' ou 'ambos', mas partner_imovel_id vazio na fatura
  • Validação: Abrir fatura → verificar campo "Imóvel"
  • Correção: Selecionar um parceiro imóvel na fatura (campo partner_imovel_id)
  • Abrir chamado: Não — cadastro

13b. Seção de imóvel não aparece na tela da fatura com produto 'ambos'

  • Sintoma: Campo de imóvel não visível na fatura, mas TX2 requer dados de imóvel/obra
  • Causa: ⚠️ Bug potencial — o compute show_partner_imovel verifica apenas ['obra','imovel'] e não inclui 'ambos'
  • Validação: Verificar product.l10n_br_infendobraimovel do produto
  • Correção temporária: Alterar produto para 'obra' ou 'imovel', gerar, depois alterar para 'ambos'
  • Abrir chamado: Sim — correção necessária no compute (account.py linha 789)

13c. Campo SituacaoTributariaIbsCbs vazio no TX2 NFS-e

  • Sintoma: Campo IBS/CBS não aparece no TX2 gerado
  • Causa: l10n_br_ibscbs_cst não preenchido na linha de fatura
  • Validação: Verificar Operação Fiscal → CST IBS/CBS, e NCM → CST IBS/CBS
  • Correção: Preencher CST IBS/CBS na operação fiscal ou no NCM
  • Abrir chamado: Não — configuração para reforma tributária

Erros de Cobrança/Boleto

14. Boleto não gerado (sem erro)

  • Sintoma: Nenhum boleto transmitido
  • Causa: Condição de pagamento ou provedor sem l10n_br_cobranca_id
  • Validação: Verificar se cobrança está vinculada
  • Correção: Vincular registro de cobrança
  • Abrir chamado: Não — configuração

15. Parcela ignorada na geração

  • Sintoma: Algumas parcelas não geram boleto
  • Causa: date_maturity <= invoice_date ou l10n_br_cobranca_idintegracao já preenchido
  • Validação: Verificar vencimento vs. data da fatura
  • Correção: Ajustar vencimento ou limpar idintegracao se rejeitado
  • Abrir chamado: Não — regra de negócio

16. Token expirado

  • Sintoma: Erro 401 ou mensagem de autenticação
  • Causa: l10n_br_token do registro de cobrança expirado
  • Validação: Verificar token no registro de cobrança
  • Correção: Renovar token junto ao banco
  • Abrir chamado: Se não sabe como renovar

17. Nosso número duplicado

  • Sintoma: Banco rejeita boleto por duplicidade
  • Causa: Sequência l10n_br_nosso_numero_id dessincronizada
  • Validação: Verificar número atual da sequência vs. banco
  • Correção: Ajustar número inicial da sequência
  • Abrir chamado: Se não sabe qual próximo número

Erros de Cancelamento

18. Cancelamento fora de prazo

  • Sintoma: SEFAZ aceita com ressalva "Cancelamento homologado fora de prazo"
  • Causa: Mais de 24h desde autorização
  • Validação: Verificar data de autorização
  • Correção: Pode funcionar, mas atenção ao fisco
  • Abrir chamado: Não — avaliar com contabilidade

19. "excecao_cancelado" no status

  • Sintoma: Cancelamento failed
  • Causa: SEFAZ rejeitou cancelamento
  • Validação: Verificar mensagem no chatter
  • Correção: Resolver causa da rejeição e retentar
  • Abrir chamado: Se causa não é clara

Quando Abrir Chamado Técnico

Situação Ação
Campo TX2 fixo no código precisa mudar Abrir chamado
Novo município com regra especial na NFS-e Abrir chamado
Hook de herança necessário Abrir chamado
Formatação de caracteres especiais no TX2 Abrir chamado
Integrador retorna erro não documentado Abrir chamado + log do chatter

Referências