Matriz de cenários de emissão de NFS-e
Índice dos 26 cenários de emissão. Cada um é o payload base abaixo + os campos do seu eixo.
Payload base (tomador completo)
Padrão recomendado: os obrigatórios + o tomador completo com endereço (a plataforma calcula os impostos automaticamente, mas não completa o endereço do tomador):
{
"borrower": {
"type": "LegalEntity",
"name": "EMPRESA TOMADORA EXEMPLO LTDA",
"federalTaxNumber": 11222333000181,
"email": "[email protected]",
"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
}
nota
CNPJ/CPF dos exemplos têm dígito verificador válido e os códigos de cidade são IBGE reais. Substitua pelos dados reais da sua operação. issRate/taxationType são opcionais (padrão: cálculo automático).
Os 26 cenários
| Cenário | Guia |
|---|---|
| Emissão padrão (tomador completo) | Por regime e tomador |
| Tomador pessoa física (CPF) | Por regime e tomador |
| Tomador pessoa jurídica (CNPJ) | Por regime e tomador |
| IBS/CBS com cálculo automático (payload mínimo) | Reforma Tributária (IBS/CBS) |
| IBS/CBS regime geral (com valores) | Reforma Tributária (IBS/CBS) |
| IBS/CBS compra governamental | Reforma Tributária (IBS/CBS) |
| Cálculo manual do ISS (issRate) | ISS e local de prestação |
| ISS isento | ISS e local de prestação |
| ISS imune | ISS e local de prestação |
| ISS com exigibilidade suspensa | ISS e local de prestação |
| Informar local de prestação | ISS e local de prestação |
| Serviço prestado fora do município | ISS e local de prestação |
| Três municípios | ISS e local de prestação |
| Retenção de IRRF | Retenções |
| ISS retido pelo tomador | Retenções |
| Retenção de PIS/COFINS/CSLL | Retenções |
| Retenção de INSS | Retenções |
| Retenção plena (ISS + federais) | Retenções |
| Evento | Tipos de atividade |
| Construção civil | Tipos de atividade |
| Locação | Tipos de atividade |
| Comércio exterior | Tipos de atividade |
| Substituição / nota referenciada | Tipos de atividade |
| Intermediário | Tipos de atividade |
| Com externalId | externalId e RPS |
| Com RPS (número + série) | externalId e RPS |
Cenários já documentados (guias dedicados)
- Cálculo automático de impostos — padrão da plataforma
- Cálculo manual de impostos
- Cliente no exterior
- Cliente não identificado