---
title: "Emitir"
method: POST
path: "/nfse"
tags: ["NFSe"]
---

# Emitir

`POST /nfse`

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 da prefeitura.

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

   ⚠ **Reforma Tributária**
  * Abaixo, campos novos da API de NFSe são denotados com <sup>(RT)</sup> e destacados em *itálico*. Durante a transição, alguns municípios podem não aceitar ou não interpretar estes campos.
  * Muitos municípios estão migrando para o novo padrão da <a href="/reference/emitir_dps_nacional">API de NFSe Nacional</a>, verifique em nosso <a href="https://focusnfe.com.br/guides/reforma-tributaria/">Guia da Reforma Tributária</a>.

   ⚠ **ATENÇÃO** Alguns municípios podem ter campos adicionais ou regras específicas para preenchimento de campos.
Estas exceções tem se mostrado frequentes em função da **Reforma Tributária**.
Consulte nossa lista de [Municípios Integrados](https://focusnfe.com.br/cidades-integradas-nfse/) para orientações sobre especificidades de seu município.

Abaixo você poderá verificar uma listagem dos principais campos disponíveis.

## Query parameters

- `ref` string, required

## Request body

- NFSeRequest
  - `data_emissao` string, date-time, required — Data/hora de emissão da NFSe. Alguns municípios não utilizam hora e ela será descartada caso seja fornecida. Formato padrão ISO 8601.
  - `natureza_operacao` '1' | '2' | '3' | '4' | '5' | '6', required — Natureza da operação. Informar um dos códigos abaixo. Valor padrão: 1. Campo ignorado em alguns municípios.<br> 1: Tributação no município<br> 2: Tributação fora do município<br> 3: Isenção<br> 4: Imune<br> 5: Exigibilidade suspensa por decisão judicial<br> 6: Exigibilidade suspensa por procedimento administrativo
  - `regime_especial_tributacao` '1' | '2' | '3' | '4' | '5' | '6' — Código do regime especial de tributação. Campo ignorado em alguns municípios<br> 1: Microempresa municipal<br> 2: Estimativa<br> 3: Sociedade de profissionais<br> 4: Cooperativa<br> 5: MEI - Simples Nacional<br> 6: ME EPP- Simples Nacional
  - `optante_simples_nacional` boolean, required — Informar true (verdadeiro) ou false (falso) se a empresa for optante pelo Simples Nacional. Campo ignorado em alguns municípios.
  - `incentivador_cultural` boolean — Informe true (verdadeiro) ou false (falso). Valor padrão: false. Campo ignorado em alguns municípios.
  - `prestador` Prestador, required
    - `cnpj` string, required — CNPJ do prestador de serviços. Caracteres não numéricos são ignorados.
    - `inscricao_municipal` string, required — Inscrição municipal do prestador.
    - `codigo_municipio` string — Código IBGE de 7 dígitos do município do prestador.
  - `tomador` Tomador, required
    - `cpf` string, required — CPF do tomador, se aplicável. Caracteres não numéricos são ignorados.
    - `cnpj` string, required — CNPJ do tomador, se aplicável. Caracteres não numéricos são ignorados.
    - `nif` string — <sup>(RT)</sup> *NIF (Número de Identificação Fiscal) do tomador estrangeiro, fornecido por órgão de administração tributária no exterior, se aplicável.*
    - `motivo_ausencia_nif` '0' | '1' | '2' — <sup>(RT)</sup> *Motivo para não informação do NIF do tomador estrangeiro, se aplicável.*<br> *0: Não informado na nota de origem*<br> *1: Dispensado do NIF*<br> *2: Não exigência do NIF*
    - `inscricao_municipal` string — Inscrição municipal do tomador. Caracteres não numéricos são ignorados.
    - `razao_social` string — Razão social ou nome do tomador.
    - `telefone` string — Telefone do tomador. Tamanho máximo: 11 caracteres (somente números).
    - `email` string, email — Email do tomador.
    - `endereco` EnderecoTomador
      - `logradouro` string — Nome do logradouro.
      - `tipo_logradouro` string — Tipo do logradouro. Usado apenas para alguns municípios. Valor padrão: os 3 primeiros caracteres do logradouro.
      - `numero` string — Número do endereço.
      - `complemento` string — Complemento do endereço.
      - `bairro` string — Bairro do endereço.
      - `codigo_municipio` string — Código IBGE do município.
      - `uf` string — UF do endereço.
      - `cep` string — CEP do endereço. Caracteres não numéricos são ignorados.
  - `servico` Servico, required
    - `valor_servicos` number, float, required — Valor dos serviços.
    - `valor_deducoes` number, float — Valor das deduções.
    - `valor_pis` number, float — Valor do PIS.
    - `valor_cofins` number, float — Valor do COFINS.
    - `valor_inss` number, float — Valor do INSS.
    - `valor_ir` number, float — Valor do IRRF.
    - `valor_csll` number, float — Valor do CSLL.
    - `iss_retido` boolean, required — Informar se o ISS foi retido.
    - `valor_iss` number, float — Valor do ISS. Campo ignorado por alguns municípios que realizam seu próprio cálculo.
    - `valor_iss_retido` number, float — Valor do ISS Retido. Campo ignorado em alguns municípios.
    - `outras_retencoes` number, float — Valor de outras retenções. Campo ignorado em alguns municípios.
    - `base_calculo` number, float — Base de cálculo do ISS. Valor padrão igual ao valor_servicos. Campo ignorado em alguns municípios.
    - `aliquota` number, float — Alíquota do ISS. Algumas cidades permitem usar até 4 dígitos decimais.
    - `desconto_incondicionado` number, float — Valor do desconto incondicionado. Campo ignorado em alguns municípios.
    - `desconto_condicionado` number, float — Valor do desconto condicionado. Campo ignorado em alguns municípios.
    - `item_lista_servico` string, required — Código da lista de serviços, conforme Lei Complementar 116/2003. <sup>(RT)</sup> *Com a Reforma Tributária, alguns municípios passaram adotar o padrão nacional (vide [Tabela Lista Serviço Nacional](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/anexo_b-nbs2-lista_servico_nacional-snnfse.xlsx)).*
    - `codigo_cnae` string — Código CNAE de 7 dígitos. Campo ignorado em alguns municípios.
    - `codigo_tributario_municipio` string — Código tributário conforme tabela do município.
    - `discriminacao` string, required — Discriminação dos serviços. Tamanho pode variar conforme o município.
    - `codigo_municipio` string, required — Código IBGE do município de prestação do serviço (7 dígitos).
    - `percentual_total_tributos` number, float — Percentual aproximado de todos os impostos, de acordo com a Lei da Transparência. Disponível apenas em alguns municípios.
    - `fonte_total_tributos` string — Fonte da informação de total de tributos (ex: "IBPT"). Disponível apenas para alguns municípios.
    - `codigo_nbs` string — <sup>(RT)</sup> *Código da lista de Nomenclatura Brasileira de Serviços (vide [Tabela NBS](https://www.gov.br/mdic/pt-br/images/REPOSITORIO/scs/decos/NBS/NBSa_2-0.csv)).*
    - `codigo_indicador_operacao` string — <sup>(RT)</sup> *Código indicador de operação (vide [Tabela IndOp](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/anexovii-indop_ibscbs_v1-00-00.xlsx)).*
    - `ibs_cbs_classificacao_tributaria` string — <sup>(RT)</sup> *Código de Classificação Tributária do IBS e CBS (vide [Tabela de Correlação NBS-cClassTrib](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/rtc/anexoviii-correlacaoitemnbsindopcclasstrib_ibscbs_v1-00-00.xlsx) e [Tabela de Classificação Tributária](https://dfe-portal.svrs.rs.gov.br/DFE/ClassificacaoTributaria)).*
    - `ibs_cbs_situacao_tributaria` string — <sup>(RT)</sup> *Código de Situação Tributária do IBS e CBS (vide tabelas acima).*
    - `ibs_cbs_base_calculo` number, float — <sup>(RT)</sup> *Base de cálculo do IBS e CBS.*
    - `ibs_uf_aliquota` number, float — <sup>(RT)</sup> *Alíquota da UF para IBS da localidade de incidência.*
    - `ibs_mun_aliquota` number, float — <sup>(RT)</sup> *Alíquota do Município para IBS da localidade de incidência.*
    - `cbs_aliquota` number, float — <sup>(RT)</sup> *Alíquota da União para CBS.*
    - `ibs_uf_valor` number, float — <sup>(RT)</sup> *Valor do IBS da UF calculado.*
    - `ibs_mun_valor` number, float — <sup>(RT)</sup> *Valor do IBS do Município calculado.*
    - `cbs_valor` number, float — <sup>(RT)</sup> *Valor do CBS da União calculado.*
  - `intermediario` Intermediario — Esta seção é ignorada se não suportada pelo município.
    - `cpf` string — CPF do intermediário, se aplicável. Caracteres não numéricos são ignorados.
    - `cnpj` string — CNPJ do intermediário, se aplicável. Caracteres não numéricos são ignorados.
    - `nif` string — <sup>(RT)</sup> *NIF (Número de Identificação Fiscal) do intermediario estrangeiro, fornecido por órgão de administração tributária no exterior, se aplicável.*
    - `motivo_ausencia_nif` '0' | '1' | '2' — <sup>(RT)</sup> *Motivo para não informação do NIF do intermediário estrangeiro, se aplicável.*<br> *0: Não informado na nota de origem*<br> *1: Dispensado do NIF*<br> *2: Não exigência do NIF*
    - `inscricao_municipal` string — Inscrição municipal do intermediário. Caracteres não numéricos são ignorados.
    - `razao_social` string — Razão social ou nome do intermediário.
  - `codigo_obra` string — Código da obra quando construção civil. Tamanho máximo: 15 caracteres.
  - `art` string — Código ART quando construção civil. Este campo é ignorado em alguns municípios.
  - `numero_nfse_substituido` string — Caso o município permita substituição de notas, aqui você poderá informar o número da NFSe a ser substituída.
  - `numero_rps_substituido` string — Caso o município permita substituição de notas, aqui você poderá informar o número do RPS a ser substituído.
  - `serie_rps_substituido` string — Obrigatório se informado o campo numero_rps_substituido. Indica a série do RPS a ser substituído.
  - `tipo_rps_substituido` string — Obrigatório se informado o campo numero_rps_substituido. Indica o tipo do RPS a ser substituído. Caso desconheça este valor, utilize "1".

## Response `201`

Recurso criado com sucesso

- ProcessandoAutorizacaoResponse
  - `status` string — Status do processamento.
  - `ref` string — Referência do DPS.
  - `protocolo` string — Protocolo de recebimento do DPS.

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `422` — O servidor entendeu a requisição, mas os dados são inválidos ou não podem ser processados

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/revisions/a32e528fc383/schema)