TF Fiscal
开发文档

税种

更新税种

整份替换税种;任何修改版本号都加 1。

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

传整份税种,tipo 须与现值一致:没传的组或行就没有了。任何修改都使版本加 1,只改 descricao 也加;内容与现有完全一致时不做任何修改。IncompativelComRegime 的税种按主体当前税制校验通过后恢复 Compativel。已受理的票不受影响,它们已存下展开后的税务参数与所用版本。

路径参数

empresaId*
string主体标识
codigo*
string税种编号

* 必填字段

请求体

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

* 必填字段

200
税种已更新。
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。