---
title: "Emissão de NFS-e com externalId e RPS - NFE.io | Docs"
description: "Como usar externalId (idempotência) e RPS na emissão de NFS-e."
source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/cenarios-de-emissao/cenarios-externalid-e-rps
last_updated: 2026-06-30
---

# Emissão de NFS-e com externalId e RPS

Campos de integração: `externalId` (idempotência) e `RPS` (número + série).

### Com externalId

`externalId` garante idempotência — reenvio com o mesmo valor retorna 400 (já existe).

```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,
  "externalId": "NFSE-EXEMPLO-0001"
}
```

### Com RPS (número + série)

`rpsNumber` + `rpsSerialNumber` identificam o recibo provisório.

```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,
  "rpsSerialNumber": "A",
  "rpsNumber": 1001
}
```

## Veja também

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