Web Service de NFS-e (SMAR)

1. Introdução

O presente guia tem como objetivo auxiliar os contribuintes, empresas e desenvolvedores na adaptação e utilização do novo Sistema Nacional da Nota Fiscal de Serviço Eletrônica (NFS-e).
Aqui você encontrará orientações completas sobre o acesso ao sistema, suas configurações essenciais, recursos disponíveis, integração via API e os principais documentos de suporte técnico e normativo.

Este material foi elaborado para garantir uma transição tranquila e segura, proporcionando uma visão prática sobre cada etapa necessária para o uso eficiente do Emissor Nacional da NFS-e.

2. Como Acessar o Novo Sistema (Portal Nacional)?

3. Configurações Essenciais - Passos

Acesso Inicial

Usuário e Senha (cadastro inicial), Certificado Digital ou Conta GOV.BR (MEIs - níveis Prata ou Ouro).

Dados Cadastrais

Confirme e configure seu e-mail e telefone para contato. Defina valores aproximados de tributos.

Serviços Favoritos

Configure seus serviços mais comuns como "favoritos" para agilizar emissões, especialmente para MEIs.

Declaração de Prestação de Serviço (DPS)

A emissão da NFS-e se baseia na DPS. Pense na DPS como um "rascunho inteligente" da sua nota.

4. Recursos do Emissor Nacional

Consulta de NFS-e

Visualize as notas que você emitiu ou que foram emitidas para você.

Ações Pós-Emissão

Download do XML e DANFSe, cancelamento, substituição ou manifestação sobre notas recebidas.

Rascunhos (DPS)

O sistema salvará automaticamente seus rascunhos de DPS, permitindo retomar o preenchimento.

5. Providências Necessárias (AMBIENTE DE TESTE)

6. Emissão via Sistema Próprio

Entre em contato com a equipe técnica responsável pelo sistema utilizado. Informe sobre essa mudança para os ajustes necessários.

6.1 Processo de emissão da NFS-e Nacional

Este processo se baseia nos seguintes passos:

  1. Preenchimento e envio do arquivo por parte do contribuinte.
  2. Validação e envio do arquivo para o Portal da Nota Nacional.
  3. Recepção da NFS-e no sistema tributário municipal com a autenticação da NFS-e Nacional.

6.2 Funcionalidades Disponíveis

Geração da NFS-e

Responsável por receber os dados referentes a uma prestação de serviços, validar e gravar na base da Administração Tributária Municipal, gerando a NFS-e. Caso haja alguma inconsistência, uma mensagem de erro é retornada ao requisitante. Este processo é síncrono e não permite envio em lote nem via arquivo texto (.txt).

Cancelamento da NFS-e

Efetua o cancelamento de uma NFS-e já emitida e integrada com o sistema Tributário Municipal. Se a nota já estiver cancelada ou inexistente, será retornada uma mensagem informando o fato. O cancelamento é individual e não se vincula a RPS ou nota substituta. Este processo é síncrono.

Substituição da NFS-e

Gera uma nova NFS-e em substituição à anterior, cancelando a nota substituída (caso ainda não esteja). Utiliza a mesma estrutura da geração, adicionando os campos que identificam a nota substituída e o motivo da substituição. Este processo também é síncrono.

6.3 Padrões Técnicos

A troca de mensagens entre o Web Service do Sistema de Notas Fiscais de Serviço Eletrônicas e o sistema do contribuinte será realizada no padrão SOAP, com troca de mensagens XML estilo Document/Literal. O WSDL (Web Service Description Language) é utilizado para descrever os serviços disponíveis.

Padrão de Certificado Digital

O certificado digital deve ser emitido por Autoridade Certificadora credenciada pela ICP-Brasil, tipo A1 ou A3. Ele é exigido tanto na transmissão quanto na assinatura de documentos, contendo o CNPJ ou CPF do emitente conforme o tipo de certificado.

Padrão de Assinatura Digital

As NFS-e enviadas devem ser assinadas digitalmente conforme o padrão XML Signature definido pelo W3C. O esquema XML utilizado é o xmldsig-core-schema_v1.01.xsd.

6.4 Estrutura dos dados

6.5 Modelos dos XMLs

6.6 Perguntas frequentes

7. Tabelas de Referência

Saiba Mais sobre a Reforma Tributária - Outras Fontes

Todos os direitos reservados SMAR APD - Copyright ©