v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB

NFSe Nacional

Emitir

Quando uma NFS-e é enviada para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do prestador em nossa base, a nota não será aceita e você receberá uma mensagem de erro de forma síncrona.

Caso a nota seja aceita para processamento, ela será enviada para uma fila e será processada de forma assíncrona. Com isto, a nota poderá ser autorizada ou retornar um erro, de acordo com a validação do ambiente nacional.

Para verificar se a nota já foi autorizada, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

Abaixo você poderá verificar uma listagem dos principais campos disponíveis. Para verificar a listagem completa de campos veja o link a seguir.

Documentação completa dos campos da NFS-e nacional

post/nfsen

Query parameters

refstring required

Example:ref_dps_001

Referência única para o DPS/NFSe

Request body

data_emissaostring date-time

Data e hora da emissão da DPS.

serie_dpsinteger

Série da DPS.

numero_dpsinteger

Número da DPS.

data_competenciastring date

Data de competência da prestação do serviço.

emitente_dpsstring

Emitente da DPS.

codigo_municipio_emissorainteger

Código IBGE de 7 dígitos da localidade emissora da NFS-e.

cnpj_prestadorstring

Número da inscrição federal (CNPJ) do prestador do serviço.

nif_prestadorstring

Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior.

codigo_opcao_simples_nacionalstring

Situação perante Simples Nacional.

regime_especial_tributacaostring

Regime Especial de Tributação Municipal.

cnpj_tomadorstring

Número da inscrição federal (CNPJ) do tomador do serviço.

cpf_tomadorstring

Número da inscrição federal (CPF) do tomador do serviço.

nif_tomadorstring

Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior.

motivo_ausencia_nif_tomadorstring

Motivo para não informação do NIF.

codigo_municipio_prestacaostring

Código IBGE de 7 dígitos da localidade da prestação do serviço.

codigo_tributacao_nacional_issstring

Código de tributação nacional do ISSQN.

descricao_servicostring

Descrição completa do serviço prestado.

valor_serviconumber

Valor monetário do serviço (R$).

tributacao_issnumber

Tributação do ISSQN sobre o serviço prestado.

Response

Requisição aceita para processamento

statusstring

Status do processamento.

refstring

Referência do DPS.

protocolostring

Protocolo de recebimento do DPS.

Example response

{
  "status": "processando_autorizacao"
}