---
title: "Gera uma nota fiscal, podendo ser vinculada a uma cobrança existente ou avulsa."
method: POST
path: "/api/NotaFiscal"
tags: ["NotaFiscal"]
---

# Gera uma nota fiscal, podendo ser vinculada a uma cobrança existente ou avulsa.

`POST /api/NotaFiscal`

Esta API permite que empresas automatizem o processo de emissão de notas fiscais, otimizando o fluxo de trabalho e garantindo a conformidade fiscal.

Existem dois cenários para emissão:
1. **Nota fiscal vinculada a uma cobrança existente:**  
   - Informe **CobrancaId** e **NfServicoId**.  
   - A API processará a cobrança existente e retornará o número da nota fiscal gerada.  
            
2. **Nota fiscal avulsa (não vinculada a cobrança):**  
   - Informe apenas **NfServicoId** e um modelo de nota fiscal (**NfeModel**) com os dados do cliente, serviço e valores.  
   - A API processará os dados do modelo e retornará o número da nota fiscal gerada.

### Requisição
| **Campo**       | **Tipo** | **Descrição**                                      | **Obrigatório** |
|-----------------|----------|--------------------------------------------------|----------------|
| CobrancaId      | GUID     | Id da cobrança, caso a NF seja vinculada        | Não             |
| NfServicoId     | GUID     | Id do serviço da NF                               | Sim             |
| NfeModel        | Objeto   | Modelo da NF com cliente, serviço e valores      | Condicional*    |

\*Obrigatório apenas se **CobrancaId** não for informado (emissão avulsa).

## Headers

- `Aeskey` string, required

## Request body

- BknBankCobrancasBusinessNfeCommunicationRequestCreateNfeRequest
  - `cobrancaId` string, uuid
  - `nfServicoId` string, uuid
  - `nfeModel` BknBankCobrancasBusinessNfeCommunicationRequestNfeModel
    - `idExterno` string
    - `ambienteEmissao` string
    - `enviarPorEmail` boolean
    - `cliente` BknBankCobrancasBusinessNfeCommunicationRequestClienteModel
      - `tipoPessoa` string
      - `nome` string
      - `email` string
      - `cpfCnpj` string
      - `inscricaoMunicipal` string
      - `inscricaoEstadual` string
      - `telefone` string
      - `endereco` BknBankCobrancasBusinessNfeCommunicationRequestEnderecoModel
        - `pais` string
        - `uf` string
        - `cidade` string
        - `logradouro` string
        - `numero` string
        - `complemento` string
        - `bairro` string
        - `cep` string
    - `servico` BknBankCobrancasBusinessNfeCommunicationRequestServicoModel
      - `descricao` string
      - `issRetidoFonte` boolean
      - `valorCofins` number, double
      - `valorCsll` number, double
      - `valorInss` number, double
      - `valorIr` number, double
      - `valorPis` number, double
    - `valorTotal` number, double
    - `observacoes` string

## Response `200`

NF gerada com sucesso

- BknBankCobrancasDALNotaFiscalPostResponse
  - `Retorno` string
  - `DetalhesErro` string
  - `NfeId` string, uuid

## Other responses

- `401` — Não há permissão para acessar esta cobrança ou nota fiscal
- `404` — Não existe a cobrança por Id ou a nota fiscal por Id
- `500` — Erro gerando a NF da cobrança

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/versions/14db4977f490/schema)