Skip to main content

发起税款缴纳任务

接口描述​

该接口用于批量发起税款缴纳任务。

请求地址​

POSThttps://qst.imfbp.com/apihub/api?Action=Tax.Declare.LoadPaymentTask

示例报文整理中

可先参考请求结构与公共参数。

Header 参数​

参数名称类型必选说明
TimestampString必选公共参数。
SecretIdString必选公共参数。
SignatureString必选公共参数。
AlgorithmString可选公共参数。
Content-TypeString必选取值:application/json

Body 请求参数​

参数名称类型必选说明
aggOrgIdString必选企业id
accountIdString可选账号ID(多账号场景使用)
tdztswjgmcString可选特定主体税务机关名称
yearInteger必选年
periodInteger必选月
durationInteger可选任务时长(必须大于30),单位分钟
disableDeclareCacheString可选禁用申报缓存
Y/N 非必传参数,默认为空。Y=不缓存 空/N或者不传这个参数=缓存
detail[]必选税种明细列表

detail​

参数名称类型必选说明
yzpzzlDmString必选应征凭证种类代码
fromDateString必选有效期起
toDateString必选有效期止
taxAmountNumber必选申请缴款金额
agreementAccountString可选三方缴款协议号
zspmDmString可选文化事业建设费为区分税种明细,需要传参征收品目代码(zspmDm)302170100代表娱乐业文化事业建设费或302170200代表广告业文化事业建设费
jkfsString可选缴款方式 :
0=三方协议号缴款
1=银行端缴款
2=二维码缴款;
不传则默认三方协议缴款
yhzhString可选银行账号 (银行账号缴款用的到,不传税局默认选择付款信息为空)
zsxmDmString可选征收项目代码工会经费=39900/水利建设专项收入=30221 合并缴款则可以为空
bsswjgString可选跨区域缴款(只针对房产税,城镇土地使用税,环保税)上传办税税务机关上传格式 省|市|区 如“湖南省|湘潭市|岳塘区”
kqyswjgmcString可选跨区域税局机关名称
sebyzString可选请求税额大于税局税额5元以内,税额不一致允许缴款,(Y是/N否 (仅针对部分区域财行税按照税目判断小于1元不需要缴款)默认=N否)

返回参数​

参数名称类型说明
codeInteger200 表示请求成功,其他参见错误码
messageString错误提示信息
startTimelong开始时间
endTimelong结束时间
callIdlong调用记录标识
dataObject返回数据

data 内容说明​

参数名称类型说明
aggOrgIdString企业Id
taskIdString任务id,供查询税款缴纳任务结果时使用
taskIds[]各税种缴款任务明细

各税种缴款任务明细​

参数名称类型说明
yzpzzlDmString应征凭证种类代码
fromDateString所属期起
toDateString所属期止
taxProjectCodeString税种项目代码
taskIdString任务id
msgString提示信息,如:当前增值税及附加税(适用于一般纳税人)税种正在缴款中,请稍后再试!

错误码​

若请求错误,服务器将返回的JSON文本包含以下参数:

  • code:错误码。
  • message:错误描述信息,帮助理解和解决发生的错误。
错误码描述
PARAMETER_ERROR企业Id(aggOrgId)不能为空!
PARAMETER_ERROR请求参数year或period不能为空!
PARAMETER_ERROR请求参数year或period不合法!
PARAMETER_ERROR应征凭证种类代码为BDA0611033的企业所得税A类(2018年版)(查账征收)已停用,
请改用应征凭证种类代码BDA0611159来标志企业所得税A类(2021年版A类)(查账征收)