点击右侧按钮复制完整请求地址，参数值请替换为实际有效值

请求参数 （暂无请求参数）

请求参数说明

# 接口名称：增值税发票验真
#### 描述：输入发票信息，验证真假
请求地址 url：https://api.shuliancloud.com/v4/invoice/check
请求方式 method：get/post

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名，<a href='#sign'>签名算法说明</a>  |
| invoiceCode  |  varchar | 否  | 发票代码【注意：除全电票外，其他必传】 |
| invoiceNo  |  varchar | 是  | 发票号码 |
| invoiceDate  |  varchar | 是  | 开票日期（格式：yyyy-MM-dd） |
| invoiceAmt  |  varchar | 是  | 开票金额 ，必须精确到两位小数【注意：全电票传价税合计，其他发票传不含税金额】|
| verCode  |  varchar | 否  | 校验码，除专票外，其他必填 |

<a name="sign">

#### 签名算法说明：
######  服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。
     如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;
     拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;
     加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;
</a>

#### 正确返回：
```
{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "orderNo": "935774813741997730",
		"result": "一致",// 校验结果，一致、不一致
        "info": {
            "buyerBank": "交通*****支行 41162199901****230210",//购方开户行账户
            "machineCode": "", //机器编码
            "notes": "", //发票备注
            "salerName": "杭州******限公司", //销方名称
            "buyerTaxNo": "91410100M****8T8M", //购方税号
            "invoiceDate": "2024-08-15", //开票日期
            "buyerName": "河南*******有限公司", //购方名称
            "invoiceCode": "", //发票代码
            "verCode": "2433200*****274660945", //校验码
            "invoiceAmt": "94.34", //合计金额
            "totalTaxAmt": "5.66", //合计税额
            "totalAmt": "100.00", //价税合计
            "salerContact": "浙江省杭州市*******室 0571-89*****1", //销方地址电话
            "salerTaxNo": "9133*******72B", //销方税号
            "salerBank": "", //销方开户行账户
            "itemList": [
                {
                    "taxRate": "0.06", //税率
                    "priceUnit": "94.3396226415094", //单价
                    "unit": "", //单位
                    "amount": "1", //数量
                    "priceAmt": "94.34", //金额
                    "name": "*信息技术服务*技术服务费", //商品名称
                    "taxAmt": "5.66", //税额
                    "spec": "" //规格
                }
            ],
            "invoiceNo": "24332000000274****45", //发票号码
            "ret_code": 0, //无效字段
            "status": "1", //发票状态 1、未作废　2、作废 3、红冲
            "buyerContact": "河南自贸试验区****号 0371-66****67"//购方地址电话
        }
    }
}
```

#### 返回字段说明：

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，计费  | 
| msg  | code对应的说明描述   | 
| data  | 验证结果详细信息|  
| orderNo  | 订单号|
| info  | 发票信息，见返回示例 | 


#### code错误码说明
|  code |  说明 |
| ------------ | ------------ |
| 200  | 成功，计费  |
| 400  | 参数错误   |
| 404  | 请求资源不存在   |
| 500  | 系统内部错误，请联系服务商   |
| 501  |第三方服务异常
| 601  | 服务商未开通接口权限 |
| 602  | 账号停用 |
| 603  | 余额不足请充值 |
| 604  | 接口停用 |
|1001|其他，以实际返回为准

返回参数 （暂无返回参数）

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，计费  | 
| msg  | code对应的说明描述   | 
| data  | 验证结果详细信息|  
| orderNo  | 订单号|
| info  | 发票信息，见返回示例 |