ICMS 详解
州级流通税：计税方式、税率体系、税收替代与州际税差，以及按公司税制分开的 CSOSN / CST 代码表
ICMS（Imposto sobre Circulação de Mercadorias e Serviços）是巴西税负最重、规则最复杂的税种：由 27 个州各自立法，对货物流通、跨市运输和通信服务征收。它是非累积的（进项可抵扣）、价内的（税额包含在自己的计税基数里），并且有大量州级例外：税收替代（ST）、基数减免、递延、免税与州际税差（DIFAL）。
计税与税率
- 价内计算：基数 = 商品价格（含 ICMS 本身）+ 运费 + 保险 + 其他费用 − 折扣；销售给最终消费者时 IPI 也计入基数。18% 的名义税率对不含税价格的实际负担约 21.95%。
- 州内税率：由各州自行规定，多在 17%–20% 之间（圣保罗 18%、里约 20% 另加 2% FCP、米纳斯 18%…），烟酒、化妆品等「非必需品」可达 25%–35%。
- 州际税率：一般 12%；自南部、东南部（圣灵州除外）销往北部、东北部、中西部及圣灵州为 7%；进口商品（来源 1、2、3、8）跨州统一 4%。
- DIFAL（州际税差）：跨州销售给非纳税人（个人、未进行 ICMS 登记的企业）时，目的州内部税率与州际税率之差归目的州，由卖方缴纳；简易税制（CRT 1 / 4）免缴（ADI 5469），CRT 2 / 3 必须计算。
- FCP（扶贫基金附加）：部分州对部分商品加征 1%–2%，跨州时随 DIFAL 归目的州。
- 税收替代（ST）：对清单商品（按 CEST 划定），整个流通链条的 ICMS 由生产商或进口商按 MVA 加成后的基数一次性代扣；下游转售用 CST 60 / CSOSN 500，不再计税。
- 基数减免、免税、递延、暂停：各州按商品给予，对应 CST 20 / 40 / 51 / 50（一般税制）；简易税制不作此细分，以 CSOSN 400 / 300 表示不征税与豁免。
公司税制决定用 CSOSN 还是 CST
| CRT | 税制 | ICMS 代码 | 公司 invoice_type | DIFAL |
|---|---|---|---|---|
1 | Simples Nacional | CSOSN · 3 | simples_nacional / 1 | 免缴 |
2 | Simples Nacional，超过州级子上限 | CST · 2 | simples_nacional_excesso / 2 | 须计算 |
3 | 一般税制（Lucro Real / Presumido） | CST · 2 | tributacao_normal / lucro_normal / 3 | 须计算 |
4 | MEI | CSOSN · 3 | simples / 4 | 免缴 |
平台在本地校验代码位数与税制是否匹配：CRT 1 / 4 传入 CST、或 CRT 2 / 3 传入 CSOSN 时将被直接拒绝并提示原因，不会转发给税务局（否则必被税务局以 590 / 591 拒收，并消耗该 CNPJ 的调用配额）。
invoice_type 不在上表取值范围内时不作此校验。简易税制：CSOSN 表
CRT 1 和 4。字段 icms.situacao_tributaria 传入 3 位；平台支持全部 10 个代码。
| CSOSN | 含义 | 什么时候用 |
|---|---|---|
101 | 按简易税制征税，允许抵扣 | 销售给一般税制的纳税企业并传递 ICMS 抵扣；填写 aliquota_credito（按年收入档次 1.25%–3.95%）。 |
102 | 按简易税制征税，不允许抵扣 | 最常用：销售给个人、非纳税企业，或不传递抵扣的销售。 |
103 | 收入档次内免征 ICMS | 所在州对低收入档给予免税时。 |
201 | 允许抵扣并代扣 ICMS-ST | 作为替代方销售 ST 商品并传递抵扣。 |
202 | 不允许抵扣并代扣 ICMS-ST | 作为替代方销售 ST 商品，最常见的 ST 情形。 |
203 | 收入档次内免征并代扣 ICMS-ST | 103 与 ST 的组合。 |
300 | 豁免 | 宪法豁免：书籍、报纸、期刊及其纸张；出口。 |
400 | 不征税 | 不在 ICMS 范围内：赠品、样品、送修等不构成销售的发货。 |
500 | ICMS 已由 ST 或预征缴纳 | 转售 ST 商品；搭配 CFOP 5405 / 6404，可填代扣值（v_bc_st_ret、v_icms_st_ret）。 |
900 | 其他 | 以上均不适用时：进口、需同时填基数与税额的特殊情形。 |
一般税制：CST 表
CRT 2 和 3。字段 icms.situacao_tributaria 传入 2 位，XML 中与商品来源组合为 3 位；平台支持全部 15 个代码。
| CST | 含义 | 什么时候用 |
|---|---|---|
00 | 全额征税 | 最常用的常规销售；填写 aliquota。 |
10 | 征税并代扣 ICMS-ST | 作为替代方销售 ST 商品；填写 aliquota_mva、aliquota_icms_st。 |
20 | 计税基数减免 | 州法给予基数减免；填写 aliquota_reducao（减免百分比）。 |
30 | 免税或不征税，并代扣 ICMS-ST | 本环节免税但为下游代扣 ST。 |
40 | 免税 | 州法明确免税；可填 motivo_desoneracao 与 valor_desoneracao。 |
41 | 不征税 | 不在 ICMS 范围内；出口常用。 |
50 | 暂停征收 | 送修、演示、委托加工等暂时性发货。 |
51 | 递延 | 税负递延到后续环节；填写 aliquota_diferimento。 |
60 | ICMS 已由 ST 缴纳 | 转售 ST 商品；搭配 CFOP 5405 / 6404。 |
70 | 基数减免并代扣 ICMS-ST | 20 与 10 的组合。 |
90 | 其他 | 以上均不适用时。 |
02 · 15 · 53 · 61 | 燃料单相征税系列 | 燃料行业专用（02 自身环节、15 负责代扣、53 递延缴纳、61 已在前环节缴纳）；填写 ad_rem_icms。 |
商品来源（origem）
字段 products[].origem，两种税制均需填写。决定跨州税率（进口商品 4%）并成为 XML 里 CST/CSOSN 的首位。
| 值 | 含义 |
|---|---|
0 | 国产（3、4、5、8 以外） |
1 | 进口，直接进口（6 除外） |
2 | 进口，国内市场购入（7 除外） |
3 | 国产，进口成分 40%–70% |
4 | 国产，按基本生产工艺法规生产 |
5 | 国产，进口成分 ≤ 40% |
6 | 进口，直接进口，无同类国产品（CAMEX 名单） |
7 | 进口，国内购入，无同类国产品（CAMEX 名单） |
8 | 国产，进口成分 > 70% |
平台字段（税种 icms[] 行 / 内联 impostos.icms）
| 字段 | 用途 |
|---|---|
cenario · tipo_pessoa | 行的定位键：场景与人员类型，见下节。 |
codigo_cfop · situacao_tributaria | 操作代码与 CST/CSOSN；必填。 |
aliquota | ICMS 税率（%）。 |
aliquota_reducao | 基数减免百分比（CST 20 / 70）。 |
aliquota_fcp | FCP 附加税率（%）。 |
aliquota_mva · aliquota_icms_st · aliquota_reducao_st · aliquota_fcp_st | 作为替代方代扣 ST 时的加成率、ST 税率、ST 基数减免、ST 的 FCP（CST 10 / 30 / 70，CSOSN 201 / 202 / 203）。 |
v_bc_st_ret · v_icms_st_ret · v_icms_substituto · p_fcp_st_ret · v_bc_fcp_st_ret · v_fcp_st_ret | 转售 ST 商品时（CST 60 / CSOSN 500）填写前环节已代扣的基数与税额。 |
aliquota_credito | 简易税制传递给买方的抵扣率（CSOSN 101 / 201）。 |
aliquota_diferimento | 递延百分比（CST 51）。 |
motivo_desoneracao · valor_desoneracao | 免税理由代码与免税额（CST 40 / 41 / 50 / 90）。 |
beneficio_fiscal[] | 各州税收优惠代码：[{"estado":"SP","codigo":"SP800001"}]，写入 XML 的 cBenef。 |
disable_difal · difal_desconta_icms_inter · difal_base_por_dentro · v_bc_uf_dest | DIFAL 控制：关闭计算；基数按「双重价内」并扣除州际 ICMS（多数州的算法）；或直接指定目的州基数。 |
desconta_icms_pis_cofins | true 时从 PIS/COFINS 基数中扣除本行 ICMS（最高法院 Tema 69）。 |
税种里的场景与人员类型
| cenario | 含义 |
|---|---|
saida_dentro_estado | 出库，收件人在同一州 |
saida_fora_estado | 出库，收件人在其他州 |
entrada_dentro_estado | 入库，交易对方在同一州 |
entrada_fora_estado | 入库，交易对方在其他州 |
padrao | 默认行，没有匹配到具体场景时使用 |
- 查找顺序：当前场景 →
padrao→ 旧版的saida_dentro_estado/saida_fora_estado；每一步先按tipo_pessoa（fisica/juridica）过滤。 - 跨州销售给个人时，需在
saida_fora_estado+fisica行配置 CFOP 6108 与对应代码，否则回退到法人行。 - 进口（
transaction_type= 2）不区分场景，取第一条记录并优先 CFOP 3.xxx；出口（= 3）忽略tipo_pessoa。 - 无匹配行时开票失败，错误信息中会指明缺少的
cenario与tipo_pessoa。
常见业务的推荐组合
| 业务 | 简易税制（CRT 1 / 4） | 一般税制（CRT 3） |
|---|---|---|
| 常规销售 | CSOSN 102（101 + aliquota_credito） | CST 00 + aliquota |
| 转售 ST 商品 | CSOSN 500 · CFOP 5405 / 6404 | CST 60 · CFOP 5405 / 6404 |
| 作为替代方代扣 ST | CSOSN 202 / 201 · MVA | CST 10 · MVA |
| 跨州销售给个人（B2C） | CSOSN 102 · CFOP 6108 · 免 DIFAL | CST 00 · CFOP 6108 · DIFAL + FCP |
| 赠品 / 样品 / 送修等非销售发货 | CSOSN 400 | CST 41（送修 50） |
| 出口 | CSOSN 300 · CFOP 7101 / 7102 | CST 41 · CFOP 7101 / 7102 |
| 进口入库 | CSOSN 900 · CFOP 3102 | CST 00 · CFOP 3102 |
税率、减免与 ST 清单由各州法规定并经常变动；本页给出的数值是常见取值，最终以贵司会计与所在州的规定为准。CFOP 的选择见「CFOP 场景速查」。