当前位置: API文档

order_audit.php(业务单据审核接口)

¥标准

1.接口说明

1.1 接口描述:第三方系统触发erp中待审核(待确认)的业务单据审核
1.2 注意事项:接口支持批量执行,单次批量操作单据数量最大为50条。批量操作情况下,接口支持部分成功,失败的单据将在错误信息中返回具体的失败原因

2.调用场景

2.1 第三方系统触发erp中待审核(待确认)的业务单据审核

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

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

正式环境

https://openapi.huice.com/openapi/order_audit.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



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

操作业务类型

type



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

业务单号

order_no



业务单号,目前需要单个单号进行请求

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_audit.php';
	
	$c->putApiParam('order_type', "7");
		$c->putApiParam('type', "2");
			$c->putApiParam('order_no', "CG2512160045");
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

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

   6.2 异常响应示例

JSON
{
	"code": 0,
	"message": "",
	"errors_list": [{
		"order_no": "CG2512160049",
		"error_info": "仅可审核 待审核 状态的采购单"
	}]
}




常用工具