当前位置： API文档

order_stop_waiting.php（业务单停止等待）

¥标准

1.接口说明

1.1 接口描述：第三方系统触发erp中业务单据停止等待。
1.2 注意事项：

当type=1时，执行业务单的停止等待功能，只能停止等待部分入库的业务单，如果没有停止等待成功返回错误信息，其他状态都是不能停止等待的，也会返回错误信息。当type=2时，执行业务单的明细停止等待功能，只能操作部分入库的业务单，如果没有停止等待成功返回错误信息，其他状态都是不能停止等待的，也会返回错误信息。（外部仓库，停止等待时，会自动向外仓发起停止等待申请）

2.调用场景

2.1 客户自研SCM系统，通过API接口对接，希望在SCM系统里面操作业务单据的停止等待。

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

https://openapi.ali.huice.cc/openapi/order_stop_waiting.php

正式环境

https://openapi.huice.com/openapi/order_stop_waiting.php

   3.2 公共请求参数


名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果

   3.3 业务请求参数

名称字段类型长度
必须描述

业务单据类型

type

int
是

1.采购单 2.采购退货单

操作类型

operation _type

int
是

1停止等待（终止出库），2明细停止等待（仅 type=1时，支持明细停止等待）

业务单批量列表节点

order_no

data[]
是业务单号
商家编码列表节点spec_no

data[]


否

商家编码列表节点,当operation _type=2时必传。

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint40是状态码:0表示成功,其他表示失败
错误原因messagevarchar255是错误原因

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	//sid appkey appsecret 需要换成自己的
	$c->sid = '';
	$c->appkey = '';
	$c->appsecret = '';
	//测试环境地址
	//上线时需要换成线上的
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/order_stop_waiting.php';

	$c->putApiParam('order_no', 'JY2603180871');
	$c->putApiParam('type', '1'); //1停止等待（终止出库），2明细停止等待（仅 type=1时，支持明细停止等待）
	$c->putApiParam('operation_type', '1'); //1.采购单 2.采购退货单
	$json = $c->wdtOpenApi();
	$array = json_decode($json, true); // 转成数组
	echo json_encode($array, JSON_UNESCAPED_UNICODE); // 输出中文正常显示
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
	"code": 0,
	"message": "处理成功"
}

   6.2 异常响应示例

JSON

{
    "code": -1,
    "message": "采购单状态不正确"
}






常用工具