Skip to main content

上传财报数据

接口描述​

上传财报信息(每次只能上传一个税种)。

请求地址​

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

示例报文整理中

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

Header 参数​

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

Body 请求参数​

参数名称类型必选说明
aggOrgIdString必选企业Id
创建企业返回的 id
accountIdString可选账号ID
多账号场景
yearInteger必选申报年份
格式yyyy
periodInteger必选申报月份
自然月(1-12)
durationInteger可选任务时长
(必须大于30),单位分钟
exActionInteger可选发起税局暂存任务
新版税局不支持此能力,即将下线。0 上传不发起税局暂存任务;1 上传发起税局暂存任务
isDirectDeclareBoolean可选是否上传数据直接申报
默认false
jrwcString可选是否兼容一分钱尾差
Y兼容,N不兼容。默认不兼容。
gzDeclareInteger可选财报覆盖申报
1表示覆盖申报;0表示不覆盖。默认及空为0; 当isDirectDeclare为true 时生效。此参数针对税局财报已申报,是否继续覆盖申报
overloadKjzdzzBoolean可选是否重置会计制度准则
传入true,重置清册和企业信息的财报备案设置,以上传报文的准则为准
waitResultBoolean可选是否等待结果
(仅针对浙江、云南、海南地区) 即将下线,新版税局无此功能
sfjxbdjyString可选是否进行表单校验
财报专用,Y=是/N=否 ;备注:非必传字段,请求Y则会对请求的表单节点与税局报表列表进行比对是否一致,税局要求申报的表单未请求则失败返回。默认传空,或者传N则是维持现状只校验必填表单(资产、利润),其他表单不上传默认以税局带出申报
attachNameString可选财报附注excel文件名称
财报附注使用,即将下线新版税局不支持
attachEncodeString可选财报附注excelbase64加密后的串,必传;EXCEL模板
财报附注使用,即将下线新版税局不支持
cbData可选财报月季度报文
当上传月季度报文时,该字段不允许为空,报文结构参考申报附录中的报文结构相应报文
jthbData可选企业集团合并财务报表
JSON格式,报文结构参考申报附录中的报文结构相应报文
cbnbData可选财报年度申报报文
上传财报年报时,该字段不为空,报文结构参考申报附录中的报文结构相应报文
optionCodeList[]可选多条弹窗设置明细

多条弹窗设置明细 optionCodeList​

参数名称类型必选说明
optionCodeString可选选项code
memoJsonString可选备注信息
fileCodeString必选文件编码
base64加密后的串,非必传。只有optionCode为强制申报使用
fileNameString必选文件名称

返回参数​

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

data 内容说明​

参数名称类型说明
messageString信息
上传成功! 上传成功,并发起申报!isDirectDeclare是true时
aggOrgIdString企业Id
企业Id
taskIdString任务ID
isDirectDeclare是true时,申报任务id,可以通过查询任务状态接口来查询任务执行的情况

错误码​

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

  • code:错误码。
  • message:错误描述信息,帮助理解和解决发生的错误。
错误码描述
PARAMETER_ERROR企业Id(aggOrgId)不能为空!
PARAMETER_ERROR申报年不能为空!
PARAMETER_ERROR申报月不能为空!
PARAMETER_ERROR请求参数year或period不合法!
PARAMETER_ERROR请求参数duration不能小于30
PARAMETERCheck请求参数isDirectDeclare=true和exAction=1参数非法!
PARAMETERCheck【cbData】或者【cbnbData】必传不能为空
PARAMETERCheck上传报文,校验异常,请联系管理员!
PARAMETERCheck上传报文,参数校验失败,请检查!
PARAMETERCheck上传报文,业务校验失败,请检查!
BUSINESS_ERROR任务不支持待上线
PARAMETERCheck参数业务校验异常
INTERFACE_ERROR接口异常,请联系管理员!
INTERFACE_ERROR系统繁忙,请降低调用频率!