当前位置： API文档

order_reject.php（业务单据驳回审核接口）

¥标准

1.接口说明

1.1 接口描述：第三方系统触发erp中已审核、已财审的业务单据驳回审核

1.2 注意事项：

接口支持批量执行，单次批量操作单据数量最大为50条。批量操作情况下，接口支持部分成功，失败的单据将在错误信息中返回具体的失败原因。

2.调用场景

2.1 第三方系统触发erp中已审核、已财审的业务单据驳回审核

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

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

正式环境

https://openapi.huice.com/openapi/order_reject.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 业务请求参数

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

业务单据类型

order_type

int
是

1.销售订单 2.售后单  4.委外入库单 5.委外出库单 6.调拨单7.采购单

驳回审核类型

type

int
是

2.驳回审核 3.驳回财务审核。（仅采购单、销售订单时，3 财务审核 才生效，其他业务单据财审提示“该业务单据暂不支持财务审核”）

业务单号

order_no

data[]
是业务单号

order_no_list

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

业务单编号

order_no

int
是

业务单编号


4.响应参数

   4.1 公共响应参数

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

处理失败的错误列表

errors_list

data

data[]

否

处理失败的错误列表,当code为0,errors_list 也为空，则表示全部成功。code为0，errors_list不为空，代表部分成功。

errors_list

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

错误的业务单号

order_no

int40是错误的业务单号order_no
错误原因

error_inf

varchar255是错误原因

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_reject.php';
	
    $order_no_list = array();
    $spec1 = new stdClass();
    $spec1->order_no = "xxx";
    $order_no_list []= $spec1;
    $spec2 = new stdClass();
    $spec2->order_no = "xxx";
    $order_no_list []= $spec2;

    $c->putApiParam('type', 1);  //1.采购单  2.采购退货单
    $c->putApiParam('is_reject_review', 1);  //否	0已审核的单子无法进行取消。1已审核的单子，可以先进行驳回审核再进行取消。（待财审状态先驳回审核，再取消；已审核、待推送、推送失败 状态先驳回财审再驳回审核再取消）默认为0（当is_reject_review=1时，针对已推送状态，需向下游发起“撤销采购单”，再驳回财审、驳回审核、系统内部取消）
    $c->putApiParam("order_no_list", json_encode($order_no_list, JSON_UNESCAPED_UNICODE));
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
	"code": 0,
	"message": "",
	"errors_list": []
}

   6.2 异常响应示例

JSON






常用工具