Ajuda vhsys

Como Configurar e Emitir a NFS-e Nacional

Publicado em

Encontre o CFOP certo Consulte o CFOP por código ou palavra-chave, sem erro na emissão.

Requisitos de acesso

Planos elegíveis

  • MEI
  • Essencial
  • Controle
  • Completo
  • Gestão Integrada
Compartilhar:

A Nota Fiscal de Serviço Nacional é o novo padrão adotado em todo o território nacional para a emissão de notas fiscais de serviço. Essa iniciativa é resultado de uma colaboração entre a Receita Federal, a ABRASF e o SERPRO.

Se a sua empresa presta serviços e precisa emitir a Nota Fiscal de Serviço Eletrônica no padrão Nacional (NFS-e), este artigo mostra passo a passo como fazer isso no vhsys com tranquilidade.

Vantagens:

  • Para empresas e prefeituras: facilita a transmissão do documento.

  • Integridade das informações: garante a segurança dos dados.

  • Disponibilidade: as informações ficam disponíveis em âmbito nacional e municipal.

Pré-requisitos

Antes de começar, é importante seguir algumas orientações para evitar erros durante o processo.

Após isso, vamos configurar o seu vhsys.

Configurar a Nota Fiscal de Serviço Nacional no vhsys

Antes de começar a emitir suas notas, é importante que os parâmetros da Nota Fiscal de Serviço, tanto os gerais quanto os do padrão nacional, estejam configurados corretamente.

Série DPS: Para emissões realizadas pelo nosso sistema, utilize sempre o padrão 1 ou 900.

Atenção: Caso você tenha emitido notas diretamente pelo site da prefeitura no passado, a série no PDF pode aparecer entre 70000 e 80000. Não utilize essa série no ERP, opte obrigatoriamente por 1 ou 900.

Para configurar os parâmetros gerais, acesse o artigo Parâmetros gerais da Nota Fiscal de Serviço.

Para configurar a “Adicionar atividades”:

  1. Acesse “Configurações”.

  2. Clique em “Parâmetros do sistema”.

  3. Localize a opção “Serviço”.

  4. Clique em “Nota fiscal de Serviço”.

  5. Vá até “Adicionar atividades”.

Tela de adicionar atividades do sistema exibindo campos de código de serviço, tributos e botões de ação.

  • Código do serviço = cTribNac (TAG no XML). No PDF que emitiu em seu portal estará: Código de Tributação Nacional

  • Código de serviço nacional = esse campo, é utilizado para para cidades que exigem os códigos de serviço no formato ABRASF e o código no formato nacional.

  • Código de tributação = cTribMun (caso não tenha essa TAG deixe em branco o campo) podem ocorrer casos onde deve ser preenchido com 001 ou 0.

No PDF que emitiu em seu portal estará: Código de Tributação Municipal

  • Imposto federal e Imposto municipal = Verifique essas informações diretamente no PDF da nota fiscal, pois o local onde os valores aparecem pode variar conforme a prefeitura.

  • Anexo CNAE = esse valor deverá ser resgatado na prefeitura caso seja solicitado pela mesma.

  • NBS = O Código NBS pode ser extraído diretamente do XML ou do PDF da nota (geralmente localizado no final do documento, no quadro de Informações Complementares). Caso a informação não conste nesses arquivos, você pode consultar o código correspondente à sua atividade junto da contabilidade.
    Atenção: o preenchimento deve ser feito apenas com números. Vale ressaltar que existe uma tabela oficial de correlação entre o código NBS e a atividade prestada.

Importante: A tabela de correlação da atividade e NBS está sujeita a atualizações por parte do GOV.

No XML vai ficar assim:

Linhas de código de programação evidenciando dados de tributação municipal e nacional em um arquivo integrado.

Para configurar a Nota Fiscal de Serviço Nacional:

  1. Acesse “Configurações”.

  2. Clique em “Parâmetros do sistema”.

  3. Localize a opção “Serviço”.

  4. Clique em “Nota fiscal de Serviço”.

  5. Vá até a parte de “NFSe Nacional” e ative a opção.

  6. Preencha os campos conforme a orientação do seu contador.

Passo a passo para habilitar da NFS Nacional

Optante Simples Nacional = opSimpNac (TAG no XML)

  • Regime especial de tributação = regEspTrib (o “0” representa a opção nenhum).

  • Exibir Inscrição Municipal = No Vhsys o campo 'Exibir Inscrição Municipal' terá duas opções, use a opção "Sim" se no seu PDF de uma nota já emitida no portal, houver o seu número de Inscrição Municipal impresso. Caso o PDF exiba apenas um traço (-), marque como "Não".

    • Porte = Consultar no PDF

  • Emitir pelo portal nacional = Escolha como sua nota será emitida.

    • Não (Padrão): Mantém o comportamento atual. A nota continua sendo emitida pela regra/sistema do município.

    • Sim: Força o envio da nota diretamente para o Portal Nacional do Governo Federal, ignorando a emissão pelo sistema da prefeitura.

Atenção:

Aqui estão alguns pontos importantes que você precisa saber sobre a configuração:

  • Validação com a contabilidade: Antes de alterar a opção para "Sim", recomendamos fortemente que você confirme essa mudança com o seu contador. Se a sua empresa ou município ainda não estiver habilitada no Portal Nacional, a emissão da nota será recusada. Caso isso aconteça, não se preocupe: é só voltar a opção para "Não".

  • Notas antigas e cancelamentos: Essa alteração é válida apenas para as novas notas que você for emitir. Se precisar cancelar notas já emitidas, você deve fazer isso pelo mesmo caminho em que elas foram geradas originalmente, independentemente de como a sua configuração está agora.

  • Histórico da configuração: Se por acaso você desmarcar a opção "NFS-e Nacional" e decidir marcá-la novamente no futuro, o sistema vai lembrar da sua última escolha ("Sim" ou "Não"). Por isso, vale sempre a pena dar uma conferida na configuração antes de prosseguir.

  • Valor aproximado dos tributos = Se a sua empresa for ME ou EPP, esse campo normalmente é preenchido com o número 3, mas isso pode mudar conforme o tipo de serviço ou a atividade da empresa.
    Para MEI, o valor costuma ser 2, mas também pode variar.

Sempre confirme essa informação com a contabilidade, que pode orientar o preenchimento correto conforme o enquadramento da sua empresa.

  • Regime tributário do simples nacional = regApTribSN (TAG no XML)

  • Percentual total de tributos do Simples Nacional = pTotTribSN (existem casos onde essa TAG não existe no XML, então preencha com 2,00.

No XML vai ficar assim:

Linhas de código detalhando as opções selecionadas para o Simples Nacional e o regime de tributação escolhido.

Estrutura de código mostrando dados de ambiente, data de emissão, versão do emissor web e número de inscrição.

Caso queira entender um pouco mais sobre os campos.

Defina as opções do campo “Optante Simples Nacional”:

  • 1 - Não Optante: empresa fora do Simples Nacional (Lucro Presumido ou Lucro Real).

  • 2 - Optante – Microempreendedor Individual (MEI): empresa registrada como MEI, com regime tributário simplificado.

  • 3 - Optante – Microempresa ou Empresa de Pequeno Porte (ME/EPP): empresa enquadrada no Simples Nacional, com regras específicas para ME e EPP.

No PDF do portal Nacional será localizado pelo campo 'Simples Nacional na Data de Competência'

No Vhsys, acesse a aba Gerais nas configurações da NFS-e e preencha o campo Optante Simples Nacional, selecionando a mesma informação que aparece impressa no seu PDF.

Escolha as opções do campo “Regime especial de tributação”:

  • Nenhum: empresa sem regime especial de tributação.

  • 1 - Ato Cooperado (Cooperativa): para cooperativas registradas legalmente.

  • 2 - Estimativa: usada quando os impostos são calculados por estimativa, não por faturamento real.

  • 3 - Microempresa Municipal: empresas de pequeno porte com regime simplificado municipal.

  • 4 - Notário ou Registrador: cartórios (serviços notariais e de registro).

  • 5 - Profissional Autônomo: pessoa física prestadora de serviços sem vínculo empregatício.

  • 6 - Sociedade de Profissionais: empresas formadas por profissionais liberais (ex.: contadores, advogados, médicos).

Defina qual o “Porte” da sua empresa:

  • MEI (Microempreendedor Individual): empresa de pequeno porte com regime simplificado e limites reduzidos de faturamento.

  • ME e EPP (Microempresa - ME ou Empresa de Pequeno Porte - EPP): empresas enquadradas no Simples Nacional, com limites maiores de receita anual.

Ao escolher o Porte da sua empresa, as opções vão variar:

MEI

Tipo de retenção ISS: define quem é responsável pelo recolhimento do ISS (Imposto Sobre Serviços).

  • 1 - Não retido: o prestador do serviço recolhe o ISS.

  • 2 - Retido pelo Tomador: o cliente (tomador do serviço) faz a retenção e o recolhimento do imposto.

  • 3 - Retido pelo Intermediário: a empresa intermediadora da operação é quem retém e recolhe o ISS.

Tipo de retenção PIS/COFINS: indica se os tributos PIS e COFINS serão retidos na fonte.

  • 1 - Retido: o valor dos tributos é descontado e recolhido pelo tomador.

  • 2 - Não retido: o prestador é quem recolhe o PIS e COFINS.

ME e EPP

Valor aproximado dos tributos: define como o sistema exibirá o valor estimado dos tributos na emissão da NFS-e.

  • 1 - Preencher os valores monetários em cada NFS-e emitida: o usuário informa manualmente os valores em reais de cada imposto.

  • 2 - Configurar os valores percentuais correspondentes: o sistema calcula automaticamente com base em percentuais definidos nas configurações.

  • 3 - Informar a alíquota do Simples: usado por empresas do Simples Nacional; basta informar a alíquota total do regime.

Regime tributário do Simples Nacional: define como será feita a apuração e exibição dos tributos federais e municipais nas notas.

  • 1 - Regime de apuração dos tributos federais e municipal pelo SN: todos os tributos são calculados dentro do Simples Nacional.

  • 2 - Regime de apuração dos tributos federais pelo SN e o ISSQN pela NFS-e: o ISS é calculado conforme a legislação municipal, enquanto os tributos federais seguem o Simples Nacional.

  • 3 - Regime de apuração dos tributos federais e municipal pela NFS-e: tanto tributos federais quanto municipais seguem suas legislações específicas (fora do cálculo consolidado do Simples).

No PDF será localizado pelo campo Regime de Apuração Tributária pelo SN

No Vhsys localize o campo 'Regime tributário do simples nacional' e marque exatamente a mesma opção descrita no seu PDF.

Atenção:

Depois de configurados, esses campos são preenchidos automaticamente na Nota fiscal de Serviço (NFS-e).

  • Será necessário a emissão de uma nota teste no valor de R$ 1,00 apenas para validação.

  • Após emitir a nota de teste com sucesso, cancele a nota.

É importante confirmar todas as informações com a contabilidade da empresa para garantir que a emissão da NFS-e Nacional siga as regras vigentes e que os impostos sejam calculados corretamente.

Rejeições e erros comuns na NFSe Nacional

Aqui vamos mostrar as principais rejeições que podem acontecer ao emitir a NFS-e Nacional e como resolvê-las.

Dica: Todas as informações usadas na emissão da NFS-e Nacional pelo vhsys estão no XML de uma nota emitida no Portal Nacional.

Rejeição: O CEP informado para o endereço nacional do tomador do serviço não existe ou não pertence ao município do endereço do tomador.

Aviso na tela informando que o número do CEP preenchido não corresponde ao município do destinatário.

Por que o erro acontece?

  • O CEP do prestador ou do tomador não consta na base de dados dos correios. O Portal Nacional utiliza a base dos correios para validar o CEP, portanto, mesmo que o CEP esteja vinculado ao cnpj da empresa, o Portal Nacional não irá aceitar.

  • Nesse caso, o cliente deve consultar o contador para saber como atualizar o CEP da empresa dele para um CEP válido

Como resolver?

  • Preencher um CEP válido no cadastro do prestador ou do tomador.

Rejeição: Email inválido

Alerta em vermelho indicando que o endereço de e-mail digitado não é válido para o sistema.

Por que o erro acontece?

  • O cadastro do tomador ou do prestador possui mais de um e-mail, ou um e-mail inválido

  • Nesse caso, o Webservice da Nota Nacional não está aceitando mais de um e-mail.

Como resolver?

  • Manter apenas um e-mail no cadastro do prestador ou tomador

Rejeição: Regime especial de tributação não permitido para o prestador do serviço com código de tributação na data de competência, informados na DPS, conforme parametrização do município de incidência do ISSQN.

Mensagem de bloqueio explicando que o regime de tributação escolhido diverge da parametrização aceita.

Por que o erro acontece?

  • O cadastro do prestador no portal nacional não permite o envio do Regime Especial de Tributação

Como resolver?

Nos parâmetros do sistema, marcar o campo “Regime especial de tributação” como “Nenhum”.

Mensagem indicando que a Inscrição Municipal não possui complementos registrados para envio.

Rejeição: IM do prestador não deve ser informado, pois não existem informações complementares registradas no CNC NFS-e do município emissor informado na DPS.

Alerta sobre a obrigatoriedade de informar um grupo específico de total de tributos para pequenas empresas

Por que o erro acontece?

  • A IM do prestador não possui vínculo com o webservice Nacional

  • Nesse caso, o cliente não deve enviar a IM, apesar de precisar dela preenchida nos dados da empresa

Como resolver?

Nos parâmetros do sistema, marcar o campo “Exibir Inscrição Municipal” como “Não”.

Campo suspenso de exibir Inscrição Municipal configurado de forma desativada com a opção não.

Rejeição: Para ME/EPP somente um dos 3 poderá ser informado: grupo vTotTrib ou pTotTrib ou pTotTribSN.

Alerta sobre a obrigatoriedade de informar um grupo específico de total de tributos para pequenas empresas.

Por que o erro acontece?

  • No caso desse cliente, o campo “Percentual total de tributos do Simples Nacional” está sendo enviado com valor 0

Como resolver?

Nos parâmetros do sistema, preencher um valor diferente de “0” no campo “Percentual total de tributos do Simples Nacional”.

Caixa de preenchimento indicando o número seis como o percentual de impostos do Simples Nacional.

Rejeição: No mês de competência da NFS-e, a opção de situação perante o Simples Nacional, do prestador, informada na DPS não está de acordo com o cadastro Simples Nacional.

Erro destacando que o dado do Simples Nacional não está de acordo com o cadastro do mês vigente.

Por que o erro acontece?

  • O campo “Optante Simples Nacional” não está selecionado conforme o cadastro da empresa dele no portal nacional

Como resolver?

Nos parâmetros do sistema, preencher a opção correta no campo “Optante Simples Nacional”.

Lista suspensa de seleção do Simples Nacional marcada para empresa de pequeno porte.

Rejeição: A IM deve ser informada para o emitente prestador do serviço na DPS, conforme informações complementares registradas no CNC NFS-e do município emissor informado na DPS.

Aviso exigindo o envio dos dados complementares da Inscrição Municipal do prestador do serviço.

Por que o erro acontece?

  • Nesse caso, o prestador possui a IM cadastrada no Portal Nacional, mas não está enviando na nota.

Como resolver?

Preencher a IM nos dados da empresa, e nos parâmetros do sistema marcar “Sim” na opção “Exibir Inscrição Municipal”.

Campo suspenso exibindo Inscrição Municipal configurado e ativado com a opção sim.

Rejeição: Erro de esquema. - The 'http://www.sped.fazenda.gov.br/nfse:cTribNac' element is invalid - The value '0101' is invalid according to its datatype 'http://www.sped.fazenda.gov.br/nfse:TSCodTribNac' - The Pattern constraint failed.

Mensagem de erro estrutural de esquema indicando valores inválidos de acordo com o portal do governo.

Por que o erro acontece?

  • Nesse caso, o código do serviço não está de acordo com a quantidade de caracteres que o schema da NFSe Nacional aceita (o código da atividade deve conter 6 dígitos)

Como resolver?

Preencher o código do serviço/atividade corretos na nota e nos parâmetros do sistema.

Na nota:

Lista suspensa utilizada para selecionar e buscar uma atividade de serviço cadastrada na plataforma.

Nos parâmetros:

Campo editável preenchido com os códigos numéricos de serviço e atividade solicitados.

Rejeição: Erro de esquema. - The 'http://www.sped.fazenda.gov.br/nfse:cTribMun' element is invalid - The value '620150001' is invalid according to its datatype 'http://www.sped.fazenda.gov.br/nfse:TCCodTribMun' - The Pattern constraint failed.

Erro acusando valor em desacordo no campo do código de tributação municipal.

Por que o erro acontece?

  • Nesse caso, o código de tributação do serviço não está preenchido com o código correto.

Como resolver?

  • Nos parâmetros do sistema, preencher o código correto no campo “Código de Tributação”

Na maioria dos municípios esse código é “0”.

Dois campos de texto configurados mostrando códigos de tributação e serviço lado a lado.

Rejeição: O código de tributação nacional informado não existe conforme a lista de serviços nacional do Sistema Nacional NFS-e.

Alerta informando que o código nacional pesquisado não existe na lista atualizada de serviços do governo.

Por que o erro acontece?

  • Nesse caso, o código do serviço/atividade preenchido está inválido.

Como resolver?

  • Nos parâmetros do sistema, preencher o código correto no campo “Código de Serviço”.

Caixa de inserção contendo um código nacional de serviço válido de seis caracteres numéricos.

Rejeição: Conjunto de Série, Número, Código do Município Emissor e CNPJ/CPF informado nesta DPS já existe em uma NFS-e gerada a partir de uma DPS enviada anteriormente.

Mensagem de bloqueio de duplicidade destacando que a série e o documento já constam no banco de dados.

Por que o erro acontece?

  • Nesse caso, o número do RPS já foi utilizado ou o número da Série não é aceita pelo município

  • Cada município pode utilizar uma série diferente, por exemplo, Porto Alegre utiliza a Série 495 enquanto Curitiba utiliza a Série 1.

Como resolver?

No cadastro da nota, utilizar a Série que o município aceita ou informar o número do RPS que ainda não foi utilizado.

Campos de série e número do documento mostrando um bloqueio na continuidade do preenchimento.

Compartilhar:

Assuntos relacionados

vhsys — Empresa desorganizada não perde só tempo, perde dinheiro todos os dias. Comece seu teste grátis.

Este artigo foi útil?

Escolha uma opção para avaliar.

Perguntas Frequentes

Quais são os pré-requisitos para configurar a NFS-e Nacional no vhsys?

Antes de configurar, você precisa ter um cadastro no Portal Nacional de Gestão da NFS-e. Verifique também se sua prefeitura já adotou o padrão nacional. Após o cadastro no portal, é importante salvar o XML e o PDF de uma nota já emitida por lá para usar como referência nas configurações do vhsys.

Como configuro as atividades de serviço para a NFS-e Nacional?

Acesse "Configurações > Parâmetros do sistema > Serviço > Nota fiscal de Serviço" e vá em "Adicionar atividades". Preencha o "Código do serviço" (cTribNac) e o "Código de tributação" (cTribMun), se aplicável. As informações de imposto federal e municipal devem ser consultadas no PDF de uma nota já emitida.

O que devo fazer após configurar todos os parâmetros da NFS-e Nacional?

Depois de configurar, emita uma nota fiscal de teste no valor de R$ 1,00 para validar o processo. Após a emissão bem-sucedida, cancele esta nota. Se não conseguir cancelar pelo sistema vhsys, o cancelamento deverá ser feito diretamente no Portal Nacional da NFS-e. Confirme sempre os dados com sua contabilidade.

Recebi uma rejeição sobre a Inscrição Municipal (IM), como resolver?

Se a rejeição diz que a IM não deve ser informada, vá aos parâmetros da nota e marque "Exibir Inscrição Municipal" como "Não". Se o erro diz que a IM deve ser informada, certifique-se de que ela está preenchida nos dados da sua empresa e marque a mesma opção como "Sim" nos parâmetros.

Por que estou recebendo uma rejeição sobre o Regime Especial de Tributação?

Este erro ocorre quando seu cadastro no portal nacional não permite o envio desta informação. Para corrigir, acesse os parâmetros da nota fiscal de serviço no vhsys e, no campo "Regime especial de tributação", selecione a opção "Nenhum". Isso ajustará a emissão conforme as regras do seu cadastro no portal.

Teste grátis