---
title: "Emissão de NFS-e com retenções - NFE.io | Docs"
description: "Cenários de retenção na emissão de NFS-e: IRRF, ISS retido, PIS/COFINS/CSLL, INSS e retenção plena."
source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/cenarios-de-emissao/cenarios-retencoes
last_updated: 2026-06-30
---

# Emissão de NFS-e com retenções

Retenções via campos `*AmountWithheld` (sempre ≥ 0).

### Retenção de IRRF

`irAmountWithheld` — IR retido na fonte pelo tomador.

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "EMPRESA TOMADORA EXEMPLO LTDA",
    "federalTaxNumber": 11222333000181,
    "email": "contato@exemplo.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01311-000",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "4444",
  "description": "Serviço de consultoria (cenário exemplo).",
  "servicesAmount": 1000.0,
  "irAmountWithheld": 15.0
}
```

### ISS retido pelo tomador

`issAmountWithheld` + `retentionType=withheldByBuyer`.

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "EMPRESA TOMADORA EXEMPLO LTDA",
    "federalTaxNumber": 11222333000181,
    "email": "contato@exemplo.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01311-000",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "4444",
  "description": "Serviço de consultoria (cenário exemplo).",
  "servicesAmount": 1000.0,
  "issAmountWithheld": 50.0,
  "retentionType": "withheldByBuyer"
}
```

### Retenção de PIS/COFINS/CSLL

Retenção conjunta dos três tributos federais.

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "EMPRESA TOMADORA EXEMPLO LTDA",
    "federalTaxNumber": 11222333000181,
    "email": "contato@exemplo.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01311-000",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "4444",
  "description": "Serviço de consultoria (cenário exemplo).",
  "servicesAmount": 1000.0,
  "pisAmountWithheld": 6.5,
  "cofinsAmountWithheld": 30.0,
  "csllAmountWithheld": 10.0
}
```

### Retenção de INSS

`inssAmountWithheld` — cessão de mão de obra/empreitada.

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "EMPRESA TOMADORA EXEMPLO LTDA",
    "federalTaxNumber": 11222333000181,
    "email": "contato@exemplo.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01311-000",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "4444",
  "description": "Serviço de consultoria (cenário exemplo).",
  "servicesAmount": 1000.0,
  "inssAmountWithheld": 110.0
}
```

### Retenção plena (ISS + federais)

Todas as retenções juntas — tomador grande / órgão público.

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "EMPRESA TOMADORA EXEMPLO LTDA",
    "federalTaxNumber": 11222333000181,
    "email": "contato@exemplo.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01311-000",
      "street": "Avenida Paulista",
      "number": "1000",
      "district": "Bela Vista",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "4444",
  "description": "Serviço de consultoria (cenário exemplo).",
  "servicesAmount": 1000.0,
  "issAmountWithheld": 50.0,
  "retentionType": "withheldByBuyer",
  "irAmountWithheld": 15.0,
  "pisAmountWithheld": 6.5,
  "cofinsAmountWithheld": 30.0,
  "csllAmountWithheld": 10.0,
  "inssAmountWithheld": 110.0
}
```

## Veja também

- [Matriz de cenários de emissão](./matriz-de-cenarios.md)