---
title: "Nfse emit"
method: POST
path: "/api/v1/nfse/emit"
tags: ["nfse"]
---

# Nfse emit

`POST /api/v1/nfse/emit`

## Request

- Base URL: `https://www.foxnfe.com.br`
- URL: `https://www.foxnfe.com.br/api/v1/nfse/emit`
- Auth: HTTP bearer

## Request body

- PostApiV1NfseEmitRequest
  - `competencia` string, required
  - `cnpj_prestador` string, required
  - `inscricao_municipal` string, required
  - `razao_social_prestador` string, nullable
  - `descricao_servico` string, required
  - `cnae` string, nullable
  - `codigo_tributacao_nacional` string, nullable: Obrigatório na ausência de cnae.
  - `codigo_tributacao_municipal` string, nullable: Obrigatório na ausência de cnae.
  - `aliquota_iss` number, nullable: Obrigatório na ausência de cnae.
  - `codigo_municipio_prestacao` string, required
  - `codigo_nbs` string, nullable: Obrigatório quando rtc.incluir,true.
  - `valor_servico` number, required
  - `valor_deducoes` number, nullable
  - `informacoes_adicionais` string, nullable
  - `tomador` object, required
    - `cnpj` string, nullable: Validação adicional de domínio é aplicada pelo servidor (por exemplo dígitos verificadores e autorização). Obrigatório na ausência de tomador.cpf.
    - `cpf` string, nullable: Validação adicional de domínio é aplicada pelo servidor (por exemplo dígitos verificadores e autorização). Obrigatório na ausência de tomador.cnpj.
    - `nome` string, required
    - `endereco` union
      - unknown[]
        - unknown
      - object
  - `rtc` object, nullable
    - `incluir` boolean
    - `resolution_id` string: Obrigatório quando rtc.incluir,true.
    - `sku` string: Obrigatório quando rtc.incluir,true.
    - `cind_op` string: Obrigatório quando rtc.incluir,true.
    - `fin_nfse` '0' | '1' | '2': Obrigatório quando rtc.incluir,true.
    - `ind_dest` '0' | '1': Obrigatório quando rtc.incluir,true.
  - `prestador` object, required
    - `endereco` object, required
      - `logradouro` string, required
      - `numero` string, required
      - `bairro` string, required
      - `codigo_municipio` string, required
      - `uf` string, required
      - `cep` string, required

## Response `202`

Resposta implementada pelo controlador.

- object
  - `nfse_id` integer
  - `status` 'draft' | 'pending' | 'processing' | 'authorized' | 'rejected' | 'canceled' | 'substituted'
  - `message` string

---

[API](https://skmtc.dev/foxnfe/apis/fox-nf-e-api.md) · [All operations](https://skmtc.dev/foxnfe/apis/fox-nf-e-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foxnfe/apis/fox-nf-e-api/revisions/8820a6e016b0?raw)