---
title: "Referência completa de campos de emissão de NFS-e - NFE.io | Docs"
description: "Todos os campos do corpo (POST) de emissão de NFS-e, com tipo, obrigatoriedade e descrição."
source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/cenarios-de-emissao/cenarios-referencia-completa-campos
last_updated: 2026-06-30
---

# Referência completa de campos de emissão de NFS-e

Lista de **todos os campos** aceitos no corpo (`POST`) de emissão de NFS-e. Apenas `cityServiceCode`, `description`, `servicesAmount` e `borrower` são **obrigatórios** — todo o restante é opcional e deve ser enviado apenas quando aplicável.

:::note
Por padrão a plataforma faz o **cálculo automático** dos impostos — os campos de alíquota/valor (`issRate`, `pisRate`, etc.) são opcionais e usados apenas no cálculo manual. Veja [Cálculo automático](./calculo-automatico-impostos.md) e [Cálculo manual](./calculo-manual-impostos.md).
:::

## Obrigatórios

| Campo | Tipo | Descrição |
|---|---|---|
| `cityServiceCode` | string | Código do serviço no município. |
| `description` | string | Descrição dos serviços. |
| `servicesAmount` | número | Valor dos serviços. |
| `borrower` | objeto | Tomador dos serviços (ver [Por regime e tomador](./por-regime-tributario.md)). |

## Identificação e datas

| Campo | Tipo | Descrição | Cenário |
|---|---|---|---|
| `externalId` | string | Identificação externa (idempotência). | [externalId e RPS](./externalid-e-rps.md) |
| `issuedOn` | data/hora | Data da emissão. | — |
| `accrualOn` | data (AAAA-MM-DD) | Data da competência da prestação. | — |
| `rpsSerialNumber` | string | Número de série da RPS. | [externalId e RPS](./externalid-e-rps.md) |
| `rpsNumber` | inteiro | Número da RPS. | [externalId e RPS](./externalid-e-rps.md) |

## Classificação do serviço

| Campo | Tipo | Descrição |
|---|---|---|
| `federalServiceCode` | string | Código federal do serviço (item da lista LC 116). |
| `cnaeCode` | string | Código CNAE (quando exigido pela cidade). |
| `nbsCode` | string | Código NBS (quando exigido pela cidade). |
| `ncmCode` | string | Código NCM (Nomenclatura Comum do Mercosul). |

:::tip
Sobre a validação de **CNAE × item da LC116** (algumas prefeituras exigem compatibilidade), veja [CNAE e item da LC116](../impostos-e-classificacao/cnae-e-item-da-lc116.md).
:::

## Valores e pagamento

| Campo | Tipo | Descrição |
|---|---|---|
| `paidAmount` | número | Valor dos serviços pago. |
| `paymentMethod` | enum | Forma de pagamento. |
| `deductionsAmount` | número | Valor de deduções. |
| `discountUnconditionedAmount` | número | Valor do desconto incondicionado. |
| `discountConditionedAmount` | número | Valor do desconto condicionado. |
| `isEarlyInstallmentPayment` | booleano | Indica pagamento antecipado de parcela. |

## ISS e tributação

| Campo | Tipo | Descrição | Cenário |
|---|---|---|---|
| `taxationType` | enum | Tipo da tributação (`WithinCity`, `OutsideCity`, `Free`, `Immune`, `SuspendedCourtDecision`, `FixedISSQN`, …). | [ISS e local](./local-de-prestacao.md) |
| `issRate` | número | Alíquota do ISS (cálculo manual; opcional). | [ISS e local](./local-de-prestacao.md) |
| `issTaxAmount` | número | Valor do ISS. | — |
| `issAmountWithheld` | número | Valor retido do ISS. | [Retenções](./retencoes.md) |
| `retentionType` | enum | Tipo de retenção do ISSQN (`withheldByBuyer`, `withheldByIntermediary`, `notWithheld`). | [Retenções](./retencoes.md) |
| `immunityType` | enum | Tipo de imunidade (apenas com `taxationType=Immune`). | [ISS e local](./local-de-prestacao.md) |

## Retenções federais

| Campo | Tipo | Descrição | Cenário |
|---|---|---|---|
| `irAmountWithheld` | número | Valor retido do IR. | [Retenções](./retencoes.md) |
| `cstPisCofins` | enum | Código de Situação Tributária PIS/COFINS. | — |
| `pisCofinsBaseTax` | número | Base de cálculo de PIS/COFINS. | — |
| `pisAmount` / `pisRate` / `pisAmountWithheld` | número | Valor / alíquota / valor retido do PIS. | [Retenções](./retencoes.md) |
| `cofinsAmount` / `cofinsRate` / `cofinsAmountWithheld` | número | Valor / alíquota / valor retido do COFINS. | [Retenções](./retencoes.md) |
| `csllAmount` / `csllRate` / `csllAmountWithheld` | número | Valor / alíquota / valor retido do CSLL. | [Retenções](./retencoes.md) |
| `inssRate` / `inssAmountWithheld` | número | Alíquota / valor retido do INSS. | [Retenções](./retencoes.md) |
| `ipiRate` / `ipiAmount` | número | Alíquota / valor do IPI (SP). | — |
| `othersAmountWithheld` | número | Valor de outras retenções. | — |

:::note
Clientes às vezes enviam `irRate` (alíquota do IR), mas **o contrato não tem esse campo** — para o IR, use `irAmountWithheld` (valor retido).
:::

## Reforma Tributária (IBS/CBS)

| Campo | Tipo | Descrição | Cenário |
|---|---|---|---|
| `ibsCbs` | objeto | Grupo de IBS/CBS (`operationIndicator`, `classCode`, `situationCode`, `ibs`, `cbs`, `governmentPurchase`, …). | [Reforma Tributária](./reforma-tributaria-ibs-cbs.md) |

## Local e grupos de atividade

| Campo | Tipo | Descrição | Cenário |
|---|---|---|---|
| `location` | objeto | Local da prestação do serviço. | [ISS e local](./local-de-prestacao.md) |
| `activityEvent` | objeto | Atividade de evento (nome, datas, endereço). | [Tipos de atividade](./tipos-de-atividade.md) |
| `realEstate` | objeto | Operações com bens imóveis (exceto obras). | — |
| `construction` | objeto | Obras de construção civil. | [Tipos de atividade](./tipos-de-atividade.md) |
| `lease` | objeto | Locação/sublocação/arrendamento/direito de passagem. | [Tipos de atividade](./tipos-de-atividade.md) |
| `foreignTrade` | objeto | Transações com residentes/domiciliados no exterior. | [Tipos de atividade](./tipos-de-atividade.md) |
| `referenceSubstitution` | objeto | NFS-e a ser substituída. | [Tipos de atividade](./tipos-de-atividade.md) |
| `deduction` | objeto | Deduções/reduções da base de cálculo do ISSQN. | — |
| `benefit` | objeto | Benefício municipal aplicado à base do ISSQN. | — |
| `suspension` | objeto | Suspensão da exigibilidade do ISSQN. | [ISS e local](./local-de-prestacao.md) |

## Partes adicionais

| Campo | Tipo | Descrição |
|---|---|---|
| `intermediary` | objeto | Intermediário do serviço. |
| `recipient` | objeto | Destinatário (quando diferente do tomador). |

## Tributos aproximados e informações adicionais

| Campo | Tipo | Descrição |
|---|---|---|
| `approximateTax` | objeto | Tributos aproximados (fonte + alíquota). |
| `approximateTotals` | objeto | Totais aproximados dos tributos (Lei 12.741/2012). |
| `additionalInformation` | string | Informações adicionais (texto, máx. 500 caracteres). |
| `additionalInformationGroup` | objeto | Grupo de informações adicionais. |
| `serviceAmountDetails` | objeto | Informações adicionais de tributação do serviço. |

## Veja também

- [Matriz de cenários de emissão](./matriz-de-cenarios.md)
- [Cenários de erro 400 na emissão](../erros-e-status/cenarios-de-badrequest-na-emissao.md)