IPI 详解 · TF Fiscal API

IPI（Imposto sobre Produtos Industrializados）在两个时点征收：工业产品出厂时和进口清关时。税率由 TIPI 表按 NCM 逐项规定，从 0% 到烟草的 300%，按「必需程度」有选择地课征。它是价外的：税额加在商品价格之上、计入发票总额，卖给最终消费者时还要并入 ICMS 的基数。

纳税人、税率与计算

纳税人：工业企业（含委托加工、组装、包装改变性质的「工业化」）、进口商，以及法律视同工业企业的批发商（进口货批发）。纯商贸企业不属于纳税人，票面填写非征税代码即可。
税率：TIPI 表按 NCM 给出，多数消费品 0%–15%，饮料按单位定额或专门表，烟草最高。同一 NCM 的税率全国统一。
基数：商品价格 + 运费 + 保险 + 其他费用 − 无条件折扣；进口时为海关价 + 进口税（II）。
价外：IPI 不包含在商品单价里，另行计算后计入发票总额（vNF）。买方是最终消费者或用于自用时，IPI 计入 ICMS 基数；买方是转售商时不计入。
非累积：工业企业采购原料的 IPI 可抵扣（入库 CST 00）。
简易税制：IPI 并入 DAS 统一缴纳，票面用非征税代码（99 或 53）、税率 0、归类 999。
税改：2027 年起 IPI 税率归零，仅保留对与马瑙斯自贸区产品竞争的商品征收。

CST 表

两种税制共用。字段 ipi.situacao_tributaria。

方向	CST	含义	什么时候用
出库	`50`	征税出库	工业企业销售自产品；填写 `aliquota`。
出库	`51`	零税率	TIPI 中税率为 0 的产品。
出库	`52`	免税	法律明确免税的产品。
出库	`53`	不征税	商贸企业转售、简易税制公司的常用选择。
出库	`54`	豁免	出口、书籍报刊等宪法豁免。
出库	`55`	暂停	送修、委托加工、展会等暂时性发货。
出库	`99`	其他出库	通用代码；非工业企业的另一常用取值。
入库	`00`	可抵扣的入库	工业企业采购原料。
入库	`01` – `05` · `49`	零税率 / 免税 / 不征税 / 豁免 / 暂停 · 其他入库	与出库 51–55 / 99 对应。

平台字段与规则

字段	用途
`ipi.situacao_tributaria`	CST。00 / 49 / 50 / 99 生成征税组（含基数与税额），其余生成非征税组。
`ipi.aliquota`	税率（%）。非纳税人填写 0。
`ipi.codigo_enquadramento`	法律归类代码；`999` = 其他 / 常规征税，适用于绝大多数情形。免税、豁免等按 IPI 归类表填对应代码。
`ipi.valor_unidade`	按单位定额征收时的每单位税额（饮料等）。
`price_includes_ipi`	票级或商品级标志：true 表示传入的单价已含 IPI，平台据此反算税额，而非在价格之上叠加。
`ipi_devolvido`	退货票上退回的 IPI 金额（XML 的 impostoDevol）。

TIPI 表由联邦政府定期修订，税率以最新 TIPI 为准。是否构成「工业化」、是否视同工业企业，请与会计确认。