当前位置： API文档

order_cancel.php（业务单据取消）

¥标准

1.接口说明

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

● 执行业务单的取消功能

           普通仓业务单能取消的状态是：待审核，待财审，已审核，如果没有取消成功返回错误信息，其他状态都是不能取消的，调用会返回错误信息。

           委外仓业务单能取消的状态是：待审核，待财审，已审核，待推送，推送失败，已推送。

2.调用场景

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

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

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

正式环境

https://openapi.huice.com/openapi/order_cancel.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.采购退货单

是否允许已审核（待财审+已审核状态）的单子取消

is_reject_review

int
是

0已审核的单子无法进行取消。

1已审核的单子，支持自动驳回审核再进行取消。（待财审状态先驳回审核，再取消；已审核、待推送、推送失败 状态先驳回财审再驳回审核再取消）默认为0

（当is_reject_review=1时，针对委外单据已推送状态，自动向下游发起“撤销采购单”，再驳回财审、驳回审核、系统内部取消）

业务单号

order_no

String


是业务单号

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_cancel.php';

	$c->putApiParam('order_no', 'CG2512110101');
	$c->putApiParam('type', '1'); //1.采购单  2.采购退货单
	$c->putApiParam('is_reject_review', '1'); //0已审核的单子无法进行取消。1已审核的单子，可以先进行驳回审核再进行取消
	$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": "采购单状态不正确"
}





常用工具