Skip to main content

Passo a Passo da Emissão (NFS-e)

A emissão da NFS-e no Emitix é realizada por meio de um Assistente Dinâmico (Wizard). Dividimos a complexidade da nota de serviço em 7 etapas claras.

Lembre-se: os dados de cada etapa são salvos automaticamente em memória. Se você fechar a aba por engano, não perderá o seu trabalho.

Para iniciar, acesse Módulos Fiscais → NFS-e no menu lateral e clique em Emissão de NFS-e.

Etapa 1 — Identificação (DPS)​

Etapa 1 - Identificação

Esta é a etapa de largada. Nela, definimos os parâmetros básicos da Declaração de Prestação de Serviço (DPS), que é o esqueleto da sua nota fiscal.

O formulário é focado no essencial e conta com inteligência de preenchimento para poupar seu tempo:

CampoDescrição
Data de CompetênciaÉ o mês e ano de referência em que o serviço foi efetivamente prestado. Pode ser diferente da data de emissão. O sistema já pré-preenche com a data atual.
UFO estado onde sua empresa está credenciada para emitir a nota.
Município EmissorA cidade de emissão. Exibe apenas as cidades que já estão integradas ao Padrão Nacional. Ao selecionar, o sistema exibe o Código IBGE automaticamente.

Inteligência de Preenchimento (Sidebar)​

Se você já tiver selecionado um Emitente Ativo no menu lateral, o Emitix fará o trabalho duro por você: ele cruzará os dados de endereço do seu cadastro com a base do IBGE e preencherá automaticamente a UF e o Município, deixando você livre para apenas conferir e avançar!

💡 Nota sobre Data de Emissão e Ambiente: Você não precisa se preocupar em preencher o horário exato da nota nem o ambiente (Produção/Homologação). O Emitix injeta a Data/Hora exata do servidor no momento do envio e captura o Ambiente diretamente das configurações do seu Emitente.

Etapa 2 — Prestador​

Etapa 2 - Prestador

A etapa do Prestador coleta os dados da sua empresa (quem realiza e emite a nota). Como a digitação manual está sujeita a erros, o Emitix automatiza praticamente 100% dessa etapa.

1. Seleção Rápida de Emitente​

Exibimos um Seletor de Emitentes no topo da tela. Ao escolher uma empresa da lista (ou se ela já estiver selecionada no seu menu lateral), absolutamente todos os campos abaixo são preenchidos sozinhos.

Se você ainda não tiver nenhum emitente configurado, o sistema exibirá uma tela vazia orientando o cadastro através do botão (+).

2. Automação de Dados (Consultas)​

Se você precisar preencher os dados manualmente, o sistema conta com duas integrações que aceleram o processo:

  • Consulta de CNPJ/CPF: Digite o documento e clique na lupa. O Emitix buscará a Razão Social, o Regime Tributário, o endereço completo e até a Inscrição Municipal (se disponível).
  • Consulta de CEP: Caso precise preencher apenas o endereço, basta digitar o CEP e aguardar. Logradouro, Bairro, Município e UF são carregados instantaneamente.

3. Série e Numeração Automáticas​

Ao identificar o prestador, o sistema consulta o banco de dados e localiza o número da última NFS-e emitida por você, preenchendo a Série e a Numeração da próxima nota para evitar furos de sequência. Por padrão, esses campos vêm bloqueados por um cadeado por segurança, mas você pode desbloqueá-los clicando no ícone se precisar forçar uma numeração diferente.

4. Fechamento Inteligente de Seções​

Conforme o sistema preenche os seus dados automaticamente (via Seletor ou Consulta), as seções de Identificação, Endereço, Contato e Regime Tributário são validadas e encolhidas (colapsadas) na tela com a mensagem "Dados preenchidos automaticamente". Isso reduz a poluição visual e evita a edição acidental de campos corretos. Caso queira visualizar, basta clicar no botão "Conferir".

Etapa 3 — Certificado​

Etapa 3 - Certificado

Informa o certificado digital A1 utilizado para assinar e transmitir a NFS-e.

Se o emitente selecionado já possui um certificado cadastrado na plataforma, esta etapa exibe uma confirmação e pode ser avançada diretamente.

Caso contrário, faça o upload do arquivo .pfx ou .p12 e informe a senha do certificado. O certificado deve estar válido e o CNPJ/CPF deve corresponder ao prestador.

Etapa 4 — Tomador​

Etapa 4 - Tomador

Esta etapa coleta os dados do Tomador (seu cliente, quem recebe o serviço). O preenchimento do tomador é opcional em vários municípios (ex.: serviços prestados ao público em geral).

1. Botão "Emitir sem Tomador"​

Se o serviço prestado não exigir a identificação do cliente, você pode simplesmente clicar no botão "Emitir sem tomador" localizado no topo do formulário. A tela será substituída por um aviso amigável e você poderá pular a etapa instantaneamente, poupando tempo.

2. Automação de Preenchimento (CNPJ e CEP)​

Para evitar que você tenha que digitar todos os dados do seu cliente manualmente, implementamos dois atalhos poderosos:

  • Lupa do CNPJ: Se o seu cliente for Pessoa Jurídica, digite apenas o CNPJ e clique na lupa. O Emitix vai até a Receita Federal, descobre a Razão Social e busca o endereço completo da empresa dele.
  • Busca por CEP: Se o cliente for Pessoa Física ou estrangeiro, preencha o documento/nome e digite apenas o CEP. O sistema preenche o logradouro, bairro, município e UF sozinho.

3. Endereço Colapsável​

Para manter a tela limpa e evitar que você altere sem querer um endereço que já veio correto da base de dados (via busca de CNPJ ou CEP), a seção de Endereço encolhe automaticamente assim que é preenchida, exibindo a mensagem "Endereço preenchido automaticamente". Caso precise conferir ou adicionar um complemento (como o número do apartamento), basta clicar em "Conferir" para abrir a seção novamente.

Etapa 5 — Serviço​

Etapa 5 - Serviço

Esta etapa é o coração da nota fiscal: ela descreve o que foi feito e onde. Criamos atalhos para que você não precise decorar códigos tributários ou digitar textos longos repetidamente.

Serviço Cadastrado (o atalho mais rápido)​

No topo da etapa, o cartão Serviço Cadastrado (visível quando há um emitente selecionado) permite escolher um serviço que você já cadastrou. Ao escolher, o Emitix preenche todos os campos da etapa de uma vez: código da LC 116, descrição, local da prestação e tributação. Você ainda pode ajustar qualquer campo, e a alteração vale só para esta nota.

  • Busca: digite parte do nome, do código ou da descrição para listar os serviços ativos.
  • Botão "Serviços": abre a lista completa, com paginação e busca.
  • Botão "+": cadastra um serviço novo sem sair da nota, e ele já é aplicado ao salvar.

Se você já tinha preenchido algo na etapa, o Emitix pede confirmação antes de substituir os campos. Serviços inativos não aparecem nessa busca.

💡 Os serviços são cadastrados na tela Produtos / Serviços, na visão Serviços. Veja Cadastrando um serviço para NFS-e. Eles são exclusivos da NFS-e e não se misturam com os itens de NF-e e NFC-e.

Se preferir preencher na hora, use os atalhos abaixo.

1. Busca Inteligente de Serviço (LC 116)​

Você não precisa saber de cor o código do serviço (LC 116/2003). Basta usar a barra de pesquisa: digite uma palavra-chave (ex: "manutenção", "software", "limpeza") e o Emitix exibirá uma lista suspensa com todas as opções correspondentes. Ao clicar na opção correta, o sistema destaca a sua escolha para fácil conferência.

2. Preenchimento Automático da Descrição​

Assim que você seleciona um serviço na busca, o sistema copia automaticamente a descrição oficial da lei para o campo "Descrição do Serviço". Você pode usar esse texto base e apenas complementá-lo com os detalhes específicos do seu cliente (ex: período, tipo de equipamento, etc.), poupando muita digitação.

3. Local de Prestação Inteligente​

Por padrão, o Emitix assume que o serviço foi prestado na mesma cidade da sua empresa (Emitente), deixando a UF e o Município já pré-preenchidos. Caso você tenha prestado o serviço em outra cidade, basta alterar os campos. Essa mudança é crucial, pois define para qual prefeitura o imposto (ISS) será devido.

4. Tributação e Detalhes Finais​

  • Código Municipal e CNAE: Se a sua prefeitura exigir, você pode informar o código tributário específico do município e o CNAE da sua atividade.
  • Tipo de Tributação: O padrão é "Tributado no município", mas você pode alterar para Isento, Imune, Exportação, entre outros.
  • Informações Complementares: Um campo de texto livre para você incluir observações extras, termos de garantia ou número de contratos que precisem sair impressos na nota.

Etapa 6 — Valores e Tributos​

Etapa 6 - Valores e Tributos

Esta é a etapa onde o dinheiro e os impostos entram em cena. Construímos a interface como uma calculadora em tempo real para evitar que você precise fazer contas de cabeça ou preencher dados redundantes.

1. Formatação Monetária Dinâmica​

Esqueça a dor de cabeça de contar zeros ou acertar a vírgula. Todos os campos de valor (como Valor do Serviço, Valor Recebido ou Deduções) formatam a moeda para Reais (R$) automaticamente enquanto você digita.

2. Cálculo Automático de ISS​

Você não precisa calcular o imposto manualmente. Ao preencher o Valor do Serviço, as Deduções (se houver) e a Alíquota do ISS, o Emitix calcula imediatamente a Base de Cálculo e o Valor do ISS. Esses campos ficam travados na tela e são atualizados em tempo real, evitando qualquer erro matemático de digitação.

3. Bloqueio Inteligente de Alíquota​

Se a sua empresa for optante pelo Simples Nacional, a alíquota de ISS costuma vir embutida na guia do DAS. Para garantir que você não tribute o serviço duas vezes por engano, o sistema bloqueia automaticamente o campo de Alíquota (deixando-o cinza) caso você não esteja retendo o ISS na fonte.

4. Lei da Transparência Fiscal (Total Aproximado)​

Para cumprir a Lei 12.741/2012 (que exige informar os impostos aproximados na nota), o sistema oferece opções dinâmicas. Você pode escolher exibir o valor em R$, em Porcentagem, ou pela Alíquota do Simples Nacional. A tela se adapta magicamente — digo, instantaneamente — à sua escolha, exibindo apenas os campos corretos. (Nota: O sistema não permite que empresas ME/EPP do Simples Nacional selecionem a opção "Não informar", garantindo a conformidade fiscal).

Etapa 7 — Revisão e Envio​

Etapa 7 - Revisão e Envio

A última etapa antes da nota ganhar valor fiscal. Desenvolvemos esta tela para garantir que você tenha 100% de confiança antes de apertar o botão de envio.

1. Painel de Validação Inteligente​

Em vez de deixar a nota ser rejeitada pela prefeitura por esquecimento de dados, o Emitix faz uma validação local instantânea. Se faltar qualquer informação (como esquecer o certificado ou o valor do serviço), o sistema exibe um alerta, marca a seção específica com uma etiqueta de "Pendente" e bloqueia o botão de emissão até que tudo seja corrigido.

2. Edição Rápida Direcionada​

Notou um erro no endereço do Tomador durante a leitura do resumo? Não é necessário clicar em "Voltar" várias vezes. Cada bloco da revisão possui um botão "Editar" que teletransporta você direto para a etapa exata do erro. Ao corrigir, você avança e volta para o resumo.

3. Emissão Ágil (Atalho de Teclado)​

Para quem emite um alto volume de notas e prefere manter as mãos no teclado, implementamos um atalho focado em produtividade: se a revisão estiver OK, basta pressionar Alt + Enter para transmitir a NFS-e imediatamente.

O Resultado da Transmissão​

Ao clicar em Emitir NFS-e, o documento é processado pelo Padrão Nacional e retornará:

  • Autorizada: NFS-e gerada com sucesso! A chave de acesso de 50 dígitos é validada e você já pode baixar o PDF (DANFSE) e o XML.
  • Rejeitada: Alguma regra técnica da prefeitura ou da Receita barrou a nota. O Emitix exibirá o motivo exato para que você possa corrigir o rascunho e reemitir sem perder os dados.

⚠️ Atenção: NFS-e transmitidas para o ambiente de Produção possuem valor fiscal imediato e irreversível.

Emissão via API enviando o XML​

O assistente acima é o caminho para quem emite pela interface. Se você integra um ERP ou sistema próprio que já gera a DPS em XML, não precisa convertê-la para JSON: a rota POST /nfse/emitir aceita o XML direto, no campo xml.

O Emitix lê os dados da DPS, segue o mesmo fluxo da emissão em JSON (identificação do emitente, cota de emissão), assina com o certificado do emitente e envia ao Padrão Nacional. O retorno é exatamente o mesmo da emissão em JSON.

info

Referência completa do endpoint​

Headers e resposta detalhada estão na documentação da API: Emissão de NFS-e.

DPS ou xml: escolha um​

O corpo da requisição aceita um dos dois campos para a nota, nunca os dois e nunca nenhum:

CampoTipoObrigatórioDescrição
DPSobject✅ (se não enviar xml)A DPS no formato JSON do Emitix.
xmlstring✅ (se não enviar DPS)O XML completo da DPS, como texto.
certificatestring⚙️ OpcionalCertificado A1 em Base64. Se não for enviado, usa o certificado cadastrado no emitente.
pass_certificatestring⚙️ OpcionalSenha do certificado A1.

Formato de XML aceito​

A raiz do XML deve ser a tag <DPS> do Padrão Nacional (xmlns="http://www.sped.fazenda.gov.br/nfse"), contendo o grupo <infDPS>. Namespaces e prefixos são aceitos e todos os valores são lidos como texto, preservando zeros à esquerda.

note

Somente Padrão Nacional​

XMLs de NFS-e no padrão ABRASF ou de layouts municipais próprios (lote de RPS, por exemplo) não são aceitos, porque não possuem o grupo <infDPS>. Cada requisição emite uma DPS.

caution

Exemplo ilustrativo​

O XML abaixo é resumido, usa dados fictícios e o ambiente de homologação (tpAmb = 2). Os grupos exigidos variam conforme o município, o regime do prestador e o serviço prestado, então valide o seu XML em homologação antes de emitir em produção.

Exemplo de emissão​

Corpo da requisição. O XML vai como uma string única (aspas escapadas):

{
  "xml": "<DPS xmlns=\"http://www.sped.fazenda.gov.br/nfse\" versao=\"1.00\"><infDPS>...</infDPS></DPS>"
}

Como o XML fica ilegível com tantas aspas escapadas, o mais prático é manter a DPS em um arquivo (dps.xml) e deixar o jq montar o corpo:

<?xml version="1.0" encoding="UTF-8"?>
<DPS xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.00">
  <infDPS>
    <tpAmb>2</tpAmb>
    <dhEmi>2026-10-23T13:27:00-03:00</dhEmi>
    <verAplic>1.0.0</verAplic>
    <serie>1</serie>
    <dCompet>2026-10-23</dCompet>
    <tpEmit>1</tpEmit>
    <cLocEmi>3550308</cLocEmi>
    <prest>
      <CNPJ>12345678901234</CNPJ>
      <regTrib>
        <opSimpNac>3</opSimpNac>
        <regApTribSN>1</regApTribSN>
        <regEspTrib>0</regEspTrib>
      </regTrib>
    </prest>
    <toma>
      <CNPJ>43210987654321</CNPJ>
      <xNome>CLIENTE TOMADOR</xNome>
    </toma>
    <serv>
      <locPrest>
        <cLocPrestacao>3550308</cLocPrestacao>
      </locPrest>
      <cServ>
        <cTribNac>010201</cTribNac>
        <xDescServ>Desenvolvimento de software personalizado sob encomenda</xDescServ>
      </cServ>
    </serv>
    <valores>
      <vServPrest>
        <vServ>999.00</vServ>
      </vServPrest>
      <trib>
        <tribMun>
          <tribISSQN>1</tribISSQN>
          <tpRetISSQN>1</tpRetISSQN>
        </tribMun>
        <totTrib>
          <vTotTrib>
            <vTotTribFed>0.00</vTotTribFed>
            <vTotTribEst>0.00</vTotTribEst>
            <vTotTribMun>0.00</vTotTribMun>
          </vTotTrib>
        </totTrib>
      </trib>
    </valores>
  </infDPS>
</DPS>
curl -X POST https://api.emitix.com.br/nfse/emitir \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "api-key: SUA_API_KEY_AQUI" \
  -d "$(jq -n --rawfile xml dps.xml '{xml: $xml}')"

Regras e erros comuns​

Todos os erros abaixo voltam como 400 Bad Request.

MensagemO que aconteceuComo resolver
Não é permitido informar os campos 'DPS' e 'xml' simultaneamente.A requisição trouxe os dois campos.Envie apenas um deles.
É obrigatório informar o campo 'DPS' ou 'xml'.Nenhum dos dois foi enviado.Envie DPS (JSON) ou xml.
XML não pode ser vazio.O campo xml chegou em branco.Confira se o arquivo foi lido antes de montar o corpo.
XML de NFS-e inválido ou malformado: ...O XML tem erro de sintaxe (tag aberta e não fechada, por exemplo).Valide o XML em um editor ou validador antes de enviar.
XML inválido: não foi possível identificar a estrutura da DPS/NFS-e.O XML não tem a raiz <DPS> nem o grupo <infDPS>.Use a DPS do Padrão Nacional.
Estrutura de DPS inválida: infDPS não encontrado no XML.A raiz <DPS> existe, mas sem o grupo <infDPS>.Inclua o grupo <infDPS> dentro da DPS.
tip

Quem é o emitente?​

O emitente é definido pela tag tpEmit: com 1 vale o CNPJ ou CPF do prestador (prest), com 2 o do tomador (toma) e com 3 o do intermediário (interm). O certificado cadastrado nesse emitente é usado automaticamente, a menos que você envie certificate e pass_certificate na requisição.