init
This commit is contained in:
93
requirements.md
Normal file
93
requirements.md
Normal file
@@ -0,0 +1,93 @@
|
||||
## 公司信息查询接口
|
||||
"https://a.cmdp.cn/cmds/v1/company/info-rest/custom?name=深圳市致远速联信息技术有限公司&api=p_info,p_biddings_all"
|
||||
|
||||
## 税务健康测评接口
|
||||
使用步骤:
|
||||
1,调用通用加密服务获取签名
|
||||
2,通过key 以及查询参数,获取下载url
|
||||
3,通过2中的url 下载数据文件
|
||||
|
||||
1.1数据签名
|
||||
采用国密算法,使用用户私钥(SM2)对消息(用户ID+时间戳+请求的Path,包括参数等)的哈希值(SM3)进行签名后的base64字符串,存放在Http协议请求头(Header)中
|
||||
base64(SM2(SM3({user-id}{timestamp}{nonce}{uri}{Body})))
|
||||
其中参数
|
||||
参数名称 是否必填 参数描述
|
||||
user-id 是 用户ID
|
||||
timestamp 是 时间戳,精确到秒,一分钟超时
|
||||
nonce 否 随机数
|
||||
uri 是 请求接口的完整url地址
|
||||
Body 否 请求体json,签名时的json和请求接口的json必须完全一致(包含格式化等情况)
|
||||
|
||||
示例代码如下:
|
||||
|
||||
PS:签名时的数据(例如:随机数和时间戳等)必须和请求接口时的保持一致
|
||||
2.1 税务健康测评接口
|
||||
请求方式:post
|
||||
接口url https://api.cmdp.cn/v1/eval/tax-risk
|
||||
|
||||
接口说明:
|
||||
执行税务健康测评
|
||||
2.2.1 请求头参数值
|
||||
英文名称 中文名称 类型 是否必填 说明
|
||||
x-gi-user-id 用记名 string 是
|
||||
x-gi-user-sig 签名 string 是 步骤1 中获取
|
||||
x-gi-nonce 随机数 String 否
|
||||
x-gi-timestamp 时间戳 Int 是
|
||||
|
||||
2.2.2 输入参数值
|
||||
英文名称 中文名称 类型 是否必填 说明示例
|
||||
req_no 第三方申请单号 string 是 第三方申请单号
|
||||
callback 结果回调地址 string 否 结果回调地址
|
||||
detail.file_url 用于评测的财务报表文件地址(目前仅支持Excel格式) string 否 用于评测的财务报表文件地址(目前仅支持Excel格式),该字段与data字段选择其中一个填写即可
|
||||
detail.data
|
||||
用于评测的财务报表Json数据 Object 否 用于评测的财务报表Json数据(具体数据项字段可参考字段表),该字段与file_url字段选择其中一个填写即可
|
||||
detail.company_name 企业名称,工商注册的企业全称 string 否 企业名称,工商注册的企业全称
|
||||
detail.period 测评周期,年度,季度(第一季度,第二季度...) string 是 测评周期,年度,季度(第一季度,第二季度...)
|
||||
detail.year 报告期 string 是 报告期
|
||||
detail.is_verify 是否校验参数数值 bool 否 是否校验参数数值
|
||||
detail.cit 企业所得税应纳税额合计,单位:万元 number 是 企业所得税应纳税额合计,单位:万元
|
||||
detail.vat 增值税应纳税额合计,单位:万元 number 是 增值税应纳税额合计,单位:万元
|
||||
detail.input_vat 增值税进项税额,单位:万元 number 是 增值税进项税额,单位:万元
|
||||
detail.output_vat 增值税销项税额,单位:万元 number 是 增值税销项税额,单位:万元
|
||||
detail.pre_cit 上一期企业所得税应纳税额合计,单位:万元 number 是 上一期企业所得税应纳税额合计,单位:万元
|
||||
detail.pre_vat 上一期增值税应纳税额合计,单位:万元 number 是 上一期增值税应纳税额合计,单位:万元
|
||||
detail.pre_input_vat 上一期增值税进项税额,单位:万元 number 是 上一期增值税进项税额,单位:万元
|
||||
detail.pre_output_vat 上一期增值税销项税额,单位:万元 number 是 上一期增值税销项税额,单位:万元
|
||||
|
||||
2.3 输出参数值
|
||||
英文名称 类型 说明
|
||||
code
|
||||
Int 结果状态码,200为成功,其他均为失败
|
||||
msg
|
||||
string 状态码信息
|
||||
Data.req_no
|
||||
string 第三方申请单号
|
||||
Data.order_no string CMDP订单号
|
||||
|
||||
|
||||
|
||||
3.查询结果接口
|
||||
请求方式:GET
|
||||
接口url https://api.cmdp.cn/v1/eval/order/{order_no}
|
||||
|
||||
接口说明:
|
||||
获取结果文件的下载url, {order_no}为步骤2接口的返回
|
||||
|
||||
3.1请求头参数值
|
||||
英文名称 中文名称 类型 是否必填 说明
|
||||
x-gi-user-id 用记名 string 是
|
||||
x-gi-user-sig 签名 string 是 步骤1 中获取
|
||||
x-gi-nonce 随机数 String 否
|
||||
x-gi-timestamp 时间戳 Int 是
|
||||
|
||||
|
||||
3.2. 输出参数值
|
||||
英文名称 中文名称 类型 单位 说明
|
||||
status 订单状态 Int -1/无效 ,0/正在执行,99/执行成功, 98/执行失败
|
||||
detail 订单详情 objecy
|
||||
detail.files 结果文件地址 Array
|
||||
detail.error 错误提示信息 string
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user