TF Fiscal
开发文档

税种

创建税种

把按场景分行的商品行税务参数存成一个税种;平台生成编号,NF-e 或 NFC-e 商品行之后按编号引用。

POST/openapi/v2/empresas/{empresaId}/classes-imposto
需要 token、timestamp、sign 三个签名头,参见认证与签名。

税种归属路径里的主体。不要传 codigo:编号由平台生成(TF 加 10 位数字),在响应里返回,开票与其余接口都用它。每个组是一组行,一行对应一个场景;开票时平台按本票选出适用的行。场景、选行与覆盖规则见税种。

路径参数

empresaId*
string主体标识

* 必填字段

请求体

tipo*
string税种类型
descricao
string税种名称
*
icms 与 issqn 合计至少 1 行。
arrayICMS 行
arrayIPI 行
*
至少 1 行。
arrayPIS 行
*
至少 1 行。
arrayCOFINS 行
*
icms 与 issqn 合计至少 1 行。
arrayISSQN 行
arrayIBS 与 CBS 行
array按目的州 ICMS 参数

* 必填字段

200
税种已创建,版本 1。
codigo
string税种编号
tipo
string税种类型
descricao
string税种名称
situacao
string税种状态
array不符原因
versao
int版本号
icms
array该组的行
ipi
array该组的行
pis
array该组的行
cofins
array该组的行
issqn
array该组的行
ibsCbs
array该组的行
icmsPorEstado
array按目的州 ICMS 参数
dataCriacao
string创建时间
dataUltimaAlteracao
string最后修改时间

每一行按开票时同名组的规则校验,另加税种自身的规则:

校验错误码
请求体带了 codigo:编号由平台生成10005208
任意层级出现不存在的字段;消息点名路径,如 icms[0].aliquotaX10005210
数值或布尔传成字符串,如 "aliquota": "18"10005213
必填、格式、取值范围、ICMS 行用 Padrao、pis / cofins 各至少 1 行、icms 与 issqn 合计至少 1 行、每组最多 50 行10001001
同一组内 cenario、tipoPessoa、naoContribuinte 组合重复10005211
cfop 首位与场景不符;ISSQN 的 Padrao 行不校验10005212
ISSQN 行 cfop 不是 5933(Padrao 行也一样),或 ICMS 行用了 593310005214
更新时 tipo 与现值不同10005216
该类型不能有的组:NFe 带 issqn,NFCe 带 ipi10005218
NFCe 税种的行场景不是 SaidaDentroEstado / Padrao10005219
NFCe 税种带了 NFC-e 开票没有的字段,如 icms[0].difal10005217
naoContribuinte 为 true 或 tipoPessoa 为 Fisica 的 ICMS 行用了 CST / CSOSN 10、30、70、101、201、202、203,或带 percentualCreditoSimples10004047
PIS / COFINS 01 行的 aliquota 与主体已配置计税制度的法定税率不符10005008
按主体 CRT 判断税码:CRT 1 / 4 只能 CSOSN,CRT 2 / 3 只能 CST10004046
税码存在(ICMS、PIS、COFINS、IPI、IBS/CBS)10005203
IBS/CBS 分类码属于所填 CST10005204
税码要求的字段;CSOSN 101 / 201 的 percentualCreditoSimples 可由主体档案补齐10004043
不适用于该税码的字段10004044

留到开票时做:ST 类税码要求 CEST、税务引擎的全部计算。数值按原样保存与回显:18.00 读回仍是 18.00。