ISS en detalle · TF Fiscal API

El ISS lo cobran más de 5.500 municipios sobre los servicios listados en la Ley Complementaria 116/2003. No se documenta en la NF-e sino en la factura electrónica de servicios (NFS-e) de cada municipio; la plataforma integra el sistema de São Paulo (Paulistana) y el estándar nacional (NFS-e Nacional).

Incidencia, alícuotas y lugar

Incidencia: cerca de 40 grupos y más de 200 ítems de la lista de la LC 116 (software, consultoría, reparación, transporte municipal, publicidad, educación, salud…). Servicio fuera de la lista no paga ISS; operaciones mixtas con mercancía se separan según la lista.
Alícuotas: mínima 2%, máxima 5%, definidas por ítem por cada municipio. En São Paulo la mayoría está entre 2% y 5%; desarrollo de software suele ser 2,9%.
Base: el precio del servicio; deducciones raras (construcción civil puede deducir materiales).
Lugar: por regla el municipio del establecimiento prestador; unos 20 ítems (construcción, limpieza, vigilancia, estacionamiento, eventos…) se gravan donde se ejecuta el servicio.
Retención (ISS retido): el tomador retiene y paga en lugar del prestador en los casos legales, por ejemplo cuando está en el municipio que grava y es sustituto designado, o el prestador no tiene registro allí.
Simples Nacional: ISS pagado en el DAS (Anexos III / IV / V, 2%–5% según la franja), pero la NFS-e sigue siendo obligatoria; MEI paga un valor fijo mensual.
Reforma: desde 2029 el ISS se reduce año a año y es sustituido por el IBS en 2033.

Campos de la empresa (registro NFS-e)

Definidos en /api/nfs/company/create o en la edición de la empresa; son los valores por defecto de cada NFS-e.

Campo	Significado	Valores
`im`	Inscripción Municipal	Emitida por el municipio
`codigo_municipio_nfse`	Código IBGE del municipio emisor	7 dígitos, p. ej. São Paulo 3550308
`codigo_servico_nfse`	Código de servicio por defecto	Ítem de la LC 116 (p. ej. 01.05) o código local del municipio (5 dígitos en São Paulo)
`cnae_nfse`	CNAE por defecto	7 dígitos
`regime_especial_tributacao`	Régimen especial de tributación (estándar ABRASF)	1 Microempresa municipal · 2 Estimativa · 3 Sociedad de profesionales · 4 Cooperativa · 5 MEI · 6 ME / EPP del Simples
`optante_simples_nacional`	Optante por el Simples Nacional	`true` / `false`
`serie_nfse` · `number_nfse`	Serie y número inicial del RPS

Campos de la emisión (/api/nfse/create)

Campo	Significado
`tomador`	Tomador: CPF / CNPJ, nombre, dirección, correo.
`descricao_servico`	Descripción del servicio (obligatoria).
`valor_servico`	Valor del servicio (R$), base de cálculo.
`aliquota_iss`	Alícuota del ISS (%), p. ej. `2.90`; en el Simples, la alícuota de la franja del anexo.
`iss_retido`	`false` pagado por el prestador; `true` retenido por el tomador.
`valor_iss`	Sobrescritura del valor: si es mayor que 0 sustituye el cálculo automático (base × alícuota ÷ 100).
`codigo_servico` · `cnae` · `codigo_municipio`	Sobrescriben los valores por defecto de la empresa por factura; en blanco usa el registro.

Cuando mercancía y servicio comparten factura, el ítem de servicio en la NF-e usa CFOP 5933 / 6933, pero el ISS no se calcula en la NF-e; el servicio puro va por NFS-e.

Cada municipio tiene su tabla de códigos de servicio, alícuotas y reglas de retención; antes de integrar una nueva ciudad, confirme su estándar (Paulistana, nacional u otro) y la tabla de códigos.