ISS 详解 · TF Fiscal API

ISS（Imposto sobre Serviços）由 5,500 多个市各自征收，对象是补充法 116/2003 清单里的服务。它不通过 NF-e，而是通过各市自有的服务电子发票（NFS-e）系统开具；平台已对接圣保罗市（Paulistana）和全国统一标准（NFS-e Nacional）。

征税范围、税率与纳税地

范围：LC 116 清单约 40 大类 200 余项服务（软件、咨询、维修、运输市内、广告、教育、医疗…）。不在清单内的服务不征 ISS；含有货物的混合服务按清单规定拆分。
税率：最低 2%、最高 5%，由各市按服务项设定。圣保罗多数服务 2%–5%，软件开发常见 2.9%。
基数：服务价格，一般不作扣减（建筑等少数项目可扣除材料）。
纳税地：一般为服务提供者机构所在市；建筑、清洁、保安、停车、活动等约 20 项按服务实际发生地。
代扣（ISS retido）：服务接受方在法定情形下代提供者扣缴——例如接受方位于纳税地市且为该市指定的替代方、或提供者未在该市登记。
简易税制：ISS 并入 DAS（附表 III / IV / V 按收入档 2%–5%），但仍需开具 NFS-e；MEI 按月固定额缴纳。
税改：2029 年起 ISS 逐年递减，2033 年由 IBS 取代。

公司级字段（NFS-e 登记）

在 /api/nfs/company/create 或公司编辑接口设置，作为每张 NFS-e 的默认值。

字段	含义	取值
`im`	市政登记号（Inscrição Municipal）	由开具市核发
`codigo_municipio_nfse`	开具市的 IBGE 代码	7 位，如圣保罗 3550308
`codigo_servico_nfse`	默认服务代码	LC 116 项目（如 01.05）或该市的本地代码（圣保罗 5 位）
`cnae_nfse`	默认活动 CNAE	7 位
`regime_especial_tributacao`	特殊税制（ABRASF 标准）	1 市级微型企业 · 2 估算制 · 3 专业人士合伙 · 4 合作社 · 5 MEI · 6 简易税制 ME / EPP
`optante_simples_nacional`	是否加入简易税制	`true` / `false`
`serie_nfse` · `number_nfse`	RPS 系列与起始编号

开票字段（/api/nfse/create）

字段	含义
`tomador`	服务接受方：CPF / CNPJ、名称、地址、邮箱。
`descricao_servico`	服务描述（必填）。
`valor_servico`	服务金额（R$），即计税基数。
`aliquota_iss`	ISS 税率（%），如 `2.90`；简易税制填其附表对应档的税率。
`iss_retido`	`false` 由提供者缴纳；`true` 由接受方代扣代缴。
`valor_iss`	税额覆盖：大于 0 时替代自动计算（基数 × 税率 ÷ 100）。
`codigo_servico` · `cnae` · `codigo_municipio`	按票覆盖公司默认值；留空时使用公司登记值。

货物与服务同票时，NF-e 上的服务行用 CFOP 5933 / 6933，但 ISS 本身不在 NF-e 上计算；纯服务请通过 NFS-e 开具。

每个市的服务代码表、税率和代扣规则都不同；接入新城市前请先确认该市的标准（Paulistana、全国标准或其他）与代码表。