94 lines
4.3 KiB
Markdown
94 lines
4.3 KiB
Markdown
## 公司信息查询接口
|
||
"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
|
||
|
||
|
||
|
||
|