NFS-e | Como resolver a Exception: o campo finNFSe é obrigatório e não deve ser maior que 1 caractere – Central de Atendimento

Resposta rápida: informe a finalidade da NFS-e no JSON ou TX2, utilizando um único caractere e a versão de esquema adequada à Reforma Tributária, e faça uma nova tentativa de emissão.

Mensagem apresentada

Erro ao montar notas - Exception: Para essa cidade o campo referente à tag finNFSe é obrigatório e não deve ser maior que 1 caractere.

Por que ocorre?

A Exception indica que o padrão utilizado pelo município exige a finalidade da NFS-e, mas essa informação não foi enviada ou foi preenchida em um formato inválido.

A finalidade identifica o propósito fiscal da NFS-e dentro das regras da Reforma Tributária. Ela permite que o ambiente emissor interprete corretamente a natureza da operação e aplique as validações correspondentes.

finNFSe é o nome da tag gerada no XML. O cliente não deve montar essa tag diretamente: informe o campo correspondente no JSON do PlugNotas ou no TX2 do Manager SaaS/Componente, e o produto TecnoSpeed será responsável por gerar o XML.

Como resolver

Confirme qual é a finalidade fiscal da operação.
Informe a versão do esquema utilizada para os campos da Reforma Tributária.
Preencha a finalidade da NFS-e com um único caractere, conforme o produto utilizado.
Faça uma nova tentativa de emissão.

PlugNotas - JSON

No PlugNotas, informe finalidadeNFSe dentro do grupo ibscbs do serviço:

{
  "versaoEsquema": "RTC",
  "servico": [
    {
      "ibscbs": {
        "finalidadeNFSe": 0
      }
    }
  ]
}

Manager SaaS e Componente NFSe - TX2

No TX2, informe os campos dentro do setor do RPS:

VersaoEsquema=RTC
FinalidadeNFSe=0

Atenção: o valor 0 representa uma NFS-e regular e foi utilizado apenas como exemplo. Preencha o campo de acordo com a finalidade real da operação e com as regras fiscais aplicáveis ao prestador.

Se a operação estiver sujeita às regras específicas de retenção de PIS, COFINS ou CSLL da NT007, valide a versão de esquema aplicável, pois o cenário pode exigir RTC007.

Outras validações do IBS/CBS

Depois de informar a finalidade, podem surgir novas mensagens relacionadas a outros campos do grupo IBS/CBS, como operação pessoal, código da operação, CST, classificação tributária, NBS ou regime de apuração. Analise cada nova rejeição separadamente e não altere esses campos apenas com base na Exception de finNFSe.

Documentações relacionadas