1. 接口调用说明
1.1. 接口说明
开放平台接口调用采用外层公共报文及内层业务报文相结合的方式，外层公共报文格式参考本章节，其中content字段为内层业务报文，内层报文需先进行业务接口报文组装（参考具体业务接口请求示例）并 base64 加密，将加密后json串填入content字段，完成请求报文组装。
1.2. 调用方式
方式：HTTPS +POST 方式
重要参数设置：Content-Type：application/json
1.3. 请求参数
1.3.1. 参数示例
{
"dataExchangeId": "32 位随机数",
"content": "业务接口请求示例 base64 的 json 串",
"entCode": "企业税号"
}
1.3.2. 请求参数说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| dataExchangeId | 数据交换流水号 | String | 32 | 是 | 数据交换流水号(唯一);时间 (yyyyMMddHHmmssSSS)+15位的随机数,也可以自定义 |
| content | 请求内容 | String | 不定长 | 是 | 需要交换的数据内容;业务接口请求示例base64的json串 |
| entCode | 企业税号 | String | 15/20 | 是 | 企业税号 |
1.4. 返回结果
1.4.1. 返回示例
{
"status": true,
"code": 0,
"msg": "查验成功发票一致",
"timestamp": "2022-03-25T14:10:34.907+08:00",
"data": {
"dataExchangeId": "请求流水号",
"content": "base64 请求数据内容或返回数据内容，解码后看返回结果",
"entCode": "企业税号"
}
}
1.4.2. 返回说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| status | 状态代码 | boolean | 是 | true-成功 false-失败 | |
| code | 状态信息 | int | 是 | 非0都为失败，失败信息见msg描述 | |
| msg | 提示信息 | String | 否 | 请求接口错误提示信息 | |
| timestamp | 时间搓 | String | 29 | 是 | 时间格式：yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| data | 反馈内容 | Object | 否 | status为true时存在 | |
| dataExchangeId | 数据交换流水号 | String | 32 | 是 | 数据交换流水号(唯一);时间 (yyyyMMddHHmmssSSS)+15位的随机数,也可以自定义 |
| content | 请求内容 | String | 是 | 接口反馈base64字符串 | |
| entCode | 企业税号 | String | 15/20 | 是 | 企业税号 |