This commit is contained in:
lychang
2026-05-19 19:42:55 +08:00
commit 5e3dac3020
21 changed files with 8611 additions and 0 deletions

93
requirements.md Normal file
View 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