Emitir NFSe Nacional

POST/v1/nfse/emit

POST /v1/nfse/emit emite uma NFS-e Nacional (mod: "NFSE") — Nota Fiscal de Serviços Eletrônica no padrão instituído pelo Comitê Gestor da NFS-e (Convênio NFS-e), que substitui gradualmente os sistemas municipais de nota fiscal de serviço.

Validação síncrona, processamento assíncrono

Esta chamada retorna 202 Accepted assim que o documento entra na fila — não espera pela confirmação do ambiente nacional; rejeições de regra de negócio do ambiente nacional só aparecem depois, consultando GET /v1/nfse/{id} com o invoiceId. Já os erros de formato e consistência do payload são devolvidos na hora, com 400 e status: "ERRO_VALIDACAO", listando cada campo em campos: [{ campo, mensagem }] (endereço incompleto, CNPJ com dígito verificador inválido, grupo IBS/CBS incompleto etc.). Nenhum valor fiscal é inventado pelo motor: o que o XSD exige e não foi informado é erro.

Numeração da DPS

Omita numero_dps para o motor alocar o próximo número por (CNPJ do prestador, série, ambiente) — o número usado volta em numero_dps e serie_dps na resposta. Se você informar o número e ele já tiver sido usado na série, a resposta é 409 com status: "ERRO_VALIDACAO". serie_dps deve estar entre 1 e 49999.

CNPJ alfanumérico

cnpj_prestador, cnpj_tomador, cnpj_intermediario e cnpj_destinatario aceitam o CNPJ alfanumérico ([0-9A-Z]{12}[0-9]{2}, maiúsculo, sem máscara) com conferência do dígito verificador. CPF continua numérico.

Parâmetros do corpo

Campos comuns

modstring

Valores aceitos: NFSE

Modelo do documento: fixo NFSE para NFS-e Nacional.

data_emissaostring

Data e hora de emissão do documento (ISO 8601).

cnpj_prestadorstring

CNPJ do prestador do serviço. Informe cnpj_prestador ou cpf_prestador.

razao_social_prestadorstring

Razão social ou nome do prestador.

codigo_municipio_prestadorstring

Código do município do prestador (tabela IBGE). Usado como município emissor quando codigo_municipio_emissora não é enviado. Não gera <end> sozinho: para informar o endereço do prestador, envie também cep_prestador, logradouro_prestador, numero_prestador e bairro_prestador.

codigo_municipio_prestacaostring

Município da prestação do serviço (tabela IBGE). Obrigatório (ou codigo_pais_prestacao, para serviço no exterior).

cnpj_tomadorstring

CNPJ do tomador do serviço. Informe cnpj_tomador ou cpf_tomador.

razao_social_tomadorstring

Razão social ou nome do tomador. Obrigatória quando o tomador é informado; para não identificar o tomador, omita todos os campos dele.

descricao_servicostring

Descrição do serviço prestado (obrigatória).

codigo_tributacao_nacional_issstring

Código de tributação nacional do ISS, 6 dígitos (obrigatório).

valor_serviconumber

Valor do serviço prestado (obrigatório, maior que zero).

Esses são só os campos essenciais para uma emissão simples de serviço. Veja a listagem completa de campos de NFS-e Nacional para todos os grupos opcionais (endereço no exterior, intermediário, comércio exterior, obra, evento, tributação de PIS/COFINS/IRRF/CSLL, IBS/CBS com destinatário, substituição, imunidade/suspensão, etc).

Resposta

202 Accepted

messagestring

Confirmação de que o documento entrou na fila de processamento.

invoiceIdstring

UUID interno do documento — use na chamada de consulta.

accessKeystring

Identificador (Id) da DPS calculado no enfileiramento.

numero_dpsstring

Número da DPS efetivamente usado (o informado, ou o alocado pelo motor quando numero_dps veio vazio).

serie_dpsstring

Série da DPS efetivamente usada.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/nfse/emit \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mod": "NFSE",
    "data_emissao": "2026-08-19T12:00:00-03:00",
    "cnpj_prestador": "11222333000181",
    "razao_social_prestador": "Consultoria Exemplo LTDA",
    "codigo_municipio_prestador": "3550308",
    "codigo_municipio_prestacao": "3550308",
    "cnpj_tomador": "98765432000198",
    "razao_social_tomador": "Cliente Exemplo LTDA",
    "descricao_servico": "Consultoria em tecnologia da informação",
    "codigo_tributacao_nacional_iss": "010701",
    "valor_servico": 1500.00
  }'

Node.js

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');

const resposta = await client.emit({
  mod: 'NFSE',
  data_emissao: new Date().toISOString(),
  cnpj_prestador: '11222333000181',
  razao_social_prestador: 'Consultoria Exemplo LTDA',
  codigo_municipio_prestador: '3550308',
  codigo_municipio_prestacao: '3550308',
  cnpj_tomador: '98765432000198',
  razao_social_tomador: 'Cliente Exemplo LTDA',
  descricao_servico: 'Consultoria em tecnologia da informação',
  codigo_tributacao_nacional_iss: '010701',
  valor_servico: 1500.0,
});
console.log(resposta.invoiceId);

Python

from datetime import datetime, timezone
from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')

resposta = client.emit({
    "mod": "NFSE",
    "data_emissao": datetime.now(timezone.utc).isoformat(),
    "cnpj_prestador": "11222333000181",
    "razao_social_prestador": "Consultoria Exemplo LTDA",
    "codigo_municipio_prestador": "3550308",
    "codigo_municipio_prestacao": "3550308",
    "cnpj_tomador": "98765432000198",
    "razao_social_tomador": "Cliente Exemplo LTDA",
    "descricao_servico": "Consultoria em tecnologia da informação",
    "codigo_tributacao_nacional_iss": "010701",
    "valor_servico": 1500.00,
})
print(resposta["invoiceId"])

Java

import br.com.saascore.nfe.NFeClient;
import br.com.saascore.nfe.model.NfseData;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");

NfseData nota = new NfseData();
nota.mod = "NFSE";
nota.data_emissao = java.time.Instant.now().toString();
nota.cnpj_prestador = "11222333000181";
nota.razao_social_prestador = "Consultoria Exemplo LTDA";
nota.codigo_municipio_prestador = "3550308";
nota.codigo_municipio_prestacao = "3550308";
nota.cnpj_tomador = "98765432000198";
nota.razao_social_tomador = "Cliente Exemplo LTDA";
nota.descricao_servico = "Consultoria em tecnologia da informação";
nota.codigo_tributacao_nacional_iss = "010701";
nota.valor_servico = 1500.00;

var resposta = client.emit(nota);
System.out.println(resposta.invoiceId);

Exemplo de resposta

{
  "message": "Documento enfileirado para processamento",
  "invoiceId": "e5f0a1b2-...",
  "accessKey": "35260811222333000181NFSE10000000011000000018"
}