purchase_return_end.php(取消采购退货单)
¥标准
1.接口说明
1.1 接口描述:实现普通仓采购退货单的取消,停止等待功能。实现委外仓采购退货单的取消功能。 |
1.2 适用版本:客户端 V2.4.0.5及以上版本 |
1.3 注意事项: ①普通仓取消采购退货单 ②委外仓取消采购退货单 该接口支持批量处理采购退货单的最大数量是20(建议批量处理)。 |
2.调用场景
2.1 举例说明:客户自研SCM系统,通过API接口对接,希望在SCM系统里面操作采购退货单的终止操作。 |
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|
测试环境 | http://sandbox.wangdian.cn/openapi2/purchase_return_end.php |
正式环境 | http://api.wangdian.cn/openapi2/purchase_return_end.php |
委外仓取消采购退货单地址:
环境 | HTTP地址 |
---|
测试环境 | http://sandbox.wangdian.cn/openapi2/purchase_return_end_wms.php |
正式环境 | http://api.wangdian.cn/openapi2/purchase_return_end_wms.php |
3.2 公共请求参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
卖家账号 | sid | String |
| 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 |
接口账号 | appkey | String |
| 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里
|
时间戳 | timestamp | int |
| 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 |
签名 | sign | String |
| 是 | API输入参数签名结果,签名算法介绍单击这里
|
3.3 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
采购退货单操作类型 | type | int |
| 是 | 0取消,1停止等待 注:取消委外采购退货单可不传该字段 |
采购退货单是否允许已审核的单子取消
| is_reject_review | int |
| 否 | 0已审核的单子无法进行取消,1已审核的单子,可以先进行驳回审核再进行取消。默认为0 |
采购退货单批量列表节点
| purchase_return_no_list | data[] |
| 是 | 采购退货单批量列表节点 |
purchase_return_no_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
采购退货单编号
| purchase_return_no | String |
| 是 | 采购退货单编号 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
错误数量 | error_count | int | 11 | 否
| 批量处理采购退货单出现错误的采购退货单数量。 |
5.请求示例
PHP | <?php
require_once("../WdtClient.php");
$c = new WdtClient;
$c->sid = '';
$c->appkey = '';
$c->appsecret = '';
$c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/purchase_return_end.php';
//当type为0或1时
$purchase_return_no_list = array(
array(
'purchase_return_no'=>""
),
array(
'purchase_return_no'=>""
)
);
$c->putApiParam('type', 0);
$c->putApiParam('is_reject_review', 0);
$c->putApiParam('purchase_return_no_list', json_encode($purchase_return_no_list));
$json = $c->wdtOpenApi();
var_dump($json);
?> |
JAVA | package com.wangdian.api.purchase;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import java.util.ArrayList;
import com.alibaba.fastjson.JSON;
import com.wangdian.api.WdtClient;
public class purchaseReturnEnd {
public static void main(String[] args) {
// TODO Auto-generated method stub
WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url");
//测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看,测试环境url=https://sandbox.wangdian.cn/openapi2/
//调用正式环境时请将sid、appkey、appsecret切换为实际参数,参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看,调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/
Map<String, String> params = new HashMap<String, String>();
ArrayList<HashMap<String, String>> arrayList = new ArrayList<>();
arrayList.add(new HashMap<String, String>(){{put("purchase_return_no","");}});
arrayList.add(new HashMap<String, String>(){{put("purchase_return_no","");}});
arrayList.add(new HashMap<String, String>(){{put("purchase_return_no","");}});
params.put("type", "0");
params.put("is_reject_review", "1");
params.put("purchase_return_no_list", JSON.toJSONString(arrayList));
try {
String response = client.execute("purchase_return_end.php", params);
System.out.println(response);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
} |
C# | using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;
namespace purchaseReturnEnd
{
class purchaseReturnEnd
{
static void Main(string[] args)
{
WdtClient client = new WdtClient();
client.sid = "";
client.appkey = "";
client.appsecret = "";
client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/purchase_return_end.php";
var purchase_return_no_list =new []
{
purchase_return_no="CR20230405001",
} ;
client.putParams("type", 1);
client.putParams("purchase_return_no_list ", json);
string result = client.wdtOpenapi();
Console.WriteLine(result);
Console.ReadKey();
}
}
} |
6.响应示例
6.1 正常响应示例
JSON
| {
"code": 0,
"message":"",
"error_count":
} |
6.2 异常响应示例
JSON
| {
"code": ,
"message": "",
"error_count":
} |