接口说明
调用该接口,作废电子收据
API 方法名:nuonuo.OpeMplatform.invalidElectronic 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| orderno | String | 否 | 64 | 订单号 | 1024975114819612672 |
| electronicNo | String | 否 | 17 | 收据流水号 | 70926890-00000086 |
| invalidReasonType | String | 否 | 1 | 作废原因类型:0-转开发票 1-销货退回 2-服务终止 3-开具有误 4-其他 | 1 |
| invalidReason | String | 是 | 100 | 作废原因,当invalidReasonType为4时必填 | 双方协商 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态编码 | E0000 |
| describe | String | 否 | - | 描述信息 | 作废成功 |
| result | Object | 否 | - | 数据内容 | - |
| └ invalidDate | String | 否 | - | | 2022-04-24 14:30:23 |
| └ electronicNo | String | 否 | - | | 97068528-00000208 |
| └ pdfUrl | String | 否 | - | | http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/hBvmnv-gXDZp0 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.invalidElectronic"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"orderno\": \"1024975114819612672\",
\"invalidReasonType\": \"1\",
\"electronicNo\": \"70926890-00000086\",
\"invalidReason\": \"双方协商\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
响应报文示例
{
"code":"E0000",
"describe":"作废成功",
"result":{
"invalidDate":"2022-04-19 20:57:05",
"electronicNo":"97068528-00000185",
"pdfUrl":"http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/bJ=Mrv-b8My0w"
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E9323 | 订单编号不能为空 | 检查订单编号 |
E9947 | 收据流水号不能为空 | 检查收据流水号 |
E9946 | 收据不存在 | 检查收据流水号和收据单号 |
E9948 | 收据流水号和收据单号并非同一收据 | 检查收据流水号和收据单号 |
E9949 | 该收据已经作废 | |
E9950 | 非已开具状态收据不能作废 | |
E9999 | 收据作废失败 | |