---
title: "Emissão de Nota Fiscal de Serviço."
method: POST
path: "/nfse"
tags: ["ServiceInvoice"]
---

# Emissão de Nota Fiscal de Serviço.

`POST /nfse`

## Request body

- ServiceInvoiceRequest — Modelo de dados da requisição de criação de nota de serviço.
  - `requestId` string, required — Identificador único da requisição.
  - `companyId` string, required — Identificador único da empresa.
  - `rpsSerial` string, nullable — Série RPS de Documento Fiscal.
  - `rpsNumber` integer, nullable — Número RPS de Documento Fiscal.
  - `operationType` 'TRIBUTACAO_MUNICIPIO' | 'TRIBUTACAO_FORA_MUNICIPIO' | 'ISENTO' | 'IMUNE' | 'EXIGIBILIDADE_SUSPENSA_DECISAO_JUDICIAL' | 'EXIGIBILIDADE_SUSPENSA_PROC_ADM', required — Tipo de Operação.<p>Values:</p><ul><li><i>TRIBUTACAO_MUNICIPIO</i> - Tributação no Município.</li><li><i>TRIBUTACAO_FORA_MUNICIPIO</i> - Tributação fora do Município.</li><li><i>ISENTO</i> - Isenção.</li><li><i>IMUNE</i> - Imune.</li><li><i>EXIGIBILIDADE_SUSPENSA_DECISAO_JUDICIAL</i> - Exigibilidade Suspensa por Decisão Judicial.</li><li><i>EXIGIBILIDADE_SUSPENSA_PROC_ADM</i> - Exigibilidade Suspensa por Procedimento Administrativo.</li></ul>
  - `client` ServiceInvoiceClientRequest, required — Modelo de requisição do cliente.
    - `documentType` 'CNPJ' | 'CPF' | 'ESTRANGEIRO', required — Tipo de Documento.<p>Values:</p><ul><li><i>CNPJ</i> - CNPJ.</li><li><i>CPF</i> - CPF.</li><li><i>ESTRANGEIRO</i> - Estrangeiro.</li></ul>
    - `document` string, nullable — CNPJ, CPF ou Documentação Estrangeira.
    - `name` string, required — Razão social ou nome.
    - `cityRegistration` string, nullable — Inscrição Municipal.
    - `stateRegistration` string, nullable — Inscrição Estadual.
    - `email` string, email, nullable — E-mail.
    - `phone` string, nullable — Telefone.
    - `address` ServiceInvoiceClientAddressRequest — Modelo de requisição do endereço do cliente.
      - `street` string, required — Logradouro.
      - `number` string, required — Número.
      - `neighborhood` string, required — Bairro.
      - `cityCode` string, nullable — Código de Município.
      - `city` string, nullable — Município.
      - `state` string, nullable — Sigla de Estado.
      - `country` string, required — Sigla de País.
      - `complement` string, nullable — Complemento do endereço.
      - `zipCode` string, nullable — CEP.
  - `service` ServiceInvoiceServiceRequest, required — Modelo de requisição do serviço.
    - `cnae` string, nullable — CNAE.
    - `code` string, nullable — Código do serviço prestado.
    - `cityTaxCode` string, nullable — Código de Tributação de Município.
    - `cityTaxDescription` string, nullable — Descrição de Tributação de Município.
    - `description` string, required — Discriminação.
    - `values` ServiceInvoiceServiceValuesRequest, required — Modelo de requisição dos valores do serviço.
      - `value` number, double, required — Valor.
      - `deductionValue` number, double, nullable — Valor de dedução.
      - `unconditionalDiscount` number, double, nullable — Valor de desconto incondicionado.
      - `conditionalDiscount` number, double, nullable — Valor de desconto condicionado.
      - `retentionValue` number, double, nullable — Valor de outras Retenções.
      - `pisValue` number, double, nullable — Valor de PIS.
      - `cofinsValue` number, double, nullable — Valor de COFINS.
      - `inssValue` number, double, nullable — Valor de INSS.
      - `irValue` number, double, nullable — Valor de IR.
      - `csllValue` number, double, nullable — Valor de CSLL.
      - `issRetained` boolean, required — Indicador de retenção de ISS.
      - `issRate` number, double, nullable — Valor da alíquota de ISS.
    - `address` ServiceInvoiceServiceAddressRequest — Modelo de requisição do endereço do serviço.
      - `street` string, nullable — Logradouro.
      - `number` string, nullable — Número.
      - `neighborhood` string, nullable — Bairro.
      - `cityCode` string, nullable — Código de Município.
      - `city` string, nullable — Município.
      - `state` string, nullable — Sigla de Estado.
      - `complement` string, nullable — Complemento.
      - `zipCode` string, nullable — CEP.
  - `competenceDate` string, required — Data da competência.

## Response `200`

OK

- ServiceInvoiceResponse — Modelo de Resposta da Nota Fiscal de Serviço.
  - `serviceInvoiceId` string — Identificador da Nota de Serviço.
  - `requestId` string, nullable — Identificador de Requisição.
  - `rpsSerial` string, nullable — Série RPS de Documento Fiscal.
  - `rpsNumber` integer — Número RPS de Documento Fiscal.
  - `operationType` 'TRIBUTACAO_MUNICIPIO' | 'TRIBUTACAO_FORA_MUNICIPIO' | 'ISENTO' | 'IMUNE' | 'EXIGIBILIDADE_SUSPENSA_DECISAO_JUDICIAL' | 'EXIGIBILIDADE_SUSPENSA_PROC_ADM' — Tipo de Operação.<p>Values:</p><ul><li><i>TRIBUTACAO_MUNICIPIO</i> - Tributação no Município.</li><li><i>TRIBUTACAO_FORA_MUNICIPIO</i> - Tributação fora do Município.</li><li><i>ISENTO</i> - Isenção.</li><li><i>IMUNE</i> - Imune.</li><li><i>EXIGIBILIDADE_SUSPENSA_DECISAO_JUDICIAL</i> - Exigibilidade Suspensa por Decisão Judicial.</li><li><i>EXIGIBILIDADE_SUSPENSA_PROC_ADM</i> - Exigibilidade Suspensa por Procedimento Administrativo.</li></ul>
  - `client` MongoServiceInvoiceClient — Modelo de Cliente de Nota Fiscal de Serviço.
    - `documentType` 'CNPJ' | 'CPF' | 'ESTRANGEIRO' — Tipo de Documento.<p>Values:</p><ul><li><i>CNPJ</i> - CNPJ.</li><li><i>CPF</i> - CPF.</li><li><i>ESTRANGEIRO</i> - Estrangeiro.</li></ul>
    - `document` string, nullable — CNPJ, CPF ou Documentação Estrangeira.
    - `name` string, nullable — Razão Social ou Nome.
    - `cityRegistration` string, nullable — Inscrição Municipal.
    - `stateRegistration` string, nullable — Inscrição Estadual.
    - `email` string, nullable — E-mail.
    - `phone` string, nullable — Telefone.
    - `address` MongoServiceInvoiceClientAddress — Modelo de Endereço de Cliente de Nota Fiscal de Serviço.
      - `street` string, nullable — Logradouro.
      - `number` string, nullable — Número.
      - `neighborhood` string, nullable — Bairro.
      - `cityCode` string, nullable — Código de Município.
      - `city` string, nullable — Município.
      - `state` string, nullable — Sigla de Estado.
      - `country` string, nullable — Sigla de País.
      - `complement` string, nullable — Complemento.
      - `zipCode` string, nullable — CEP.
  - `service` MongoServiceInvoiceService — Modelo de Serviço de Nota Fiscal de Serviço.
    - `cnae` string, nullable — CNAE.
    - `code` string, nullable — Código de Serviço Prestado.
    - `cityTaxCode` string, nullable — Código de Tributação de Município.
    - `cityTaxDescription` string, nullable — Descrição de Tributação de Município.
    - `description` string, nullable — Discriminação.
    - `value` number, double — Valor.
    - `deductionValue` number, double, nullable — Valor de Dedução.
    - `unconditionalDiscount` number, double, nullable — Valor de Desconto Incondicionado.
    - `conditionalDiscount` number, double, nullable — Valor de Desconto Condicionado.
    - `retentionValue` number, double, nullable — Valor de outras Retenções.
    - `pisValue` number, double, nullable — Valor de PIS.
    - `cofinsValue` number, double, nullable — Valor de COFINS.
    - `inssValue` number, double, nullable — Valor de INSS.
    - `irValue` number, double, nullable — Valor de IR.
    - `csllValue` number, double, nullable — Valor de CSLL.
    - `issRetained` boolean — Indicador de ISS Retido.
    - `issRate` number, double, nullable — Aliquota de ISS.
    - `baseValue` number, double — Valor Base de Cálculo.
    - `issRetainedValue` number, double — Valor de ISS Retido.
    - `netValue` number, double — Valor Líquido.
    - `address` MongoServiceInvoiceServiceAddress — Modelo de Endereço de Serviço de Nota Fiscal de Serviço.
      - `street` string, nullable — Logradouro.
      - `number` string, nullable — Número.
      - `neighborhood` string, nullable — Bairro.
      - `cityCode` string, nullable — Código de Município.
      - `city` string, nullable — Município.
      - `state` string, nullable — Sigla de Estado.
      - `complement` string, nullable — Complemento.
      - `zipCode` string, nullable — CEP.
  - `status` 'PROCESSING' | 'APPROVED' | 'REJECTED' | 'CANCELED' — Tipo de Status.<p>Values:</p><ul><li><i>PROCESSING</i> - Processando.</li><li><i>APPROVED</i> - Aprovado.</li><li><i>REJECTED</i> - Rejeitado.</li><li><i>CANCELED</i> - Cancelado.</li></ul>
  - `linkXml` string, nullable — Link do XML.
  - `linkPdf` string, nullable — Link do PDF.
  - `competenceDate` string, date-time, nullable — Data de Competência.
  - `created` string, date-time — Data de Criação.

## Other responses

- `201` — Created
- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error
- `501` — Not Implemented

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)