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.
{
"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,
"irAmountWithheld": 15.0
}
ISS retido pelo tomador
issAmountWithheld + retentionType=withheldByBuyer.
{
"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,
"issAmountWithheld": 50.0,
"retentionType": "withheldByBuyer"
}
Retenção de PIS/COFINS/CSLL
Retenção conjunta dos três tributos federais.
{
"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,
"pisAmountWithheld": 6.5,
"cofinsAmountWithheld": 30.0,
"csllAmountWithheld": 10.0
}
Retenção de INSS
inssAmountWithheld — cessão de mão de obra/empreitada.
{
"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,
"inssAmountWithheld": 110.0
}
Retenção plena (ISS + federais)
Todas as retenções juntas — tomador grande / órgão público.
{
"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,
"issAmountWithheld": 50.0,
"retentionType": "withheldByBuyer",
"irAmountWithheld": 15.0,
"pisAmountWithheld": 6.5,
"cofinsAmountWithheld": 30.0,
"csllAmountWithheld": 10.0,
"inssAmountWithheld": 110.0
}