---
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

- Base URL: `https://sandbox.openfinance.celcoin.dev/invoices/v1`
- URL: `https://sandbox.openfinance.celcoin.dev/invoices/v1/nfse`
- Auth: HTTP bearer

## 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.dev/celcoin/apis/invoice-webservice.md) - [All operations](https://skmtc.dev/celcoin/apis/invoice-webservice/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/invoice-webservice/revisions/3623710a53b5?raw)