Emissão de NFS-e por tipo de atividade
Grupos específicos por tipo de serviço — inclua apenas quando aplicável.
Evento
Grupo activityEvent (nome, datas, endereço do evento).
{
"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,
"taxationType": "Free",
"activityEvent": {
"name": "Show Musical 2026",
"code": "EVT2026",
"beginOn": "2026-06-01",
"endOn": "2026-06-02",
"address": {
"country": "BRA",
"postalCode": "01311-000",
"street": "Avenida Exemplo",
"number": "1000",
"district": "Centro",
"city": {
"code": "3304557",
"name": "Rio de Janeiro"
},
"state": "RJ"
}
}
}
Construção civil
Grupo construction (inscrição imobiliária, workId CNO, encapsulationNumber, endereço da obra).
{
"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,
"construction": {
"propertyFiscalRegistration": "123456789",
"workId": {
"scheme": "CNO",
"value": "12345678901234"
},
"encapsulationNumber": "123456789012",
"siteAddress": {
"country": "BRA",
"postalCode": "01311-000",
"street": "Avenida Exemplo",
"number": "1000",
"district": "Centro",
"city": {
"code": "3550308",
"name": "São Paulo"
},
"state": "SP"
}
}
}
Locação
Grupo lease (categoria, objeto, extensão).
{
"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,
"lease": {
"category": "Lease",
"objectType": "Road",
"totalLength": 15.5
}
}
Comércio exterior
Grupo foreignTrade (tomador no exterior). Veja também Cliente no exterior.
{
"borrower": {
"type": "LegalEntity",
"name": "GLOBAL TECH CONSULTING INC",
"federalTaxNumber": 0,
"email": "[email protected]",
"address": {
"country": "USA",
"postalCode": "10001",
"street": "5th Avenue",
"number": "100",
"district": "Manhattan",
"city": {
"name": "New York"
},
"state": "NY"
}
},
"cityServiceCode": "4444",
"description": "Serviço de consultoria (cenário exemplo).",
"servicesAmount": 1000.0,
"taxationType": "Export",
"foreignTrade": {
"serviceMode": "CrossBorder",
"relationShip": "NoLink",
"currency": "USD",
"serviceAmountInCurrency": 200.0,
"supportMechanismProvider": "None",
"supportMechanismReceiver": "None",
"temporaryGoods": "None",
"mdicDelivery": false
}
}
Substituição / nota referenciada
Grupo referenceSubstitution (chave da NFS-e substituída + motivo).
{
"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,
"referenceSubstitution": {
"id": "NFSE11112222333344445555666677778888999900001111",
"reason": "Correção de preenchimento"
}
}
Intermediário
Grupo intermediary + retentionType=withheldByIntermediary (responsabilidade do intermediário).
{
"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,
"intermediary": {
"name": "INTERMEDIARIO EXEMPLO LTDA",
"federalTaxNumber": 11222333000181
},
"retentionType": "withheldByIntermediary",
"issAmountWithheld": 50.0
}