当前位置: API文档

composite.Composite.checkOrderByApi(综合审核接口)

¥标准

1.接口说明

1.1 接口描:支持多种类型的单据进行审核  销售订单,退换单,调拨出入库单
1.2 适用版本:客户端 V1.6.1.5及以上版本

1.3注意事项:校验 【店铺权限】【仓库权限】

2.调用场景

2.1 举例说明:自研商城、分销系统、全渠道等系统对接

3.请求参数说明

   3.1 请求地址


环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名

   3.3 业务请求参数

名称字段类型长度
必须描述
审核列表

param

Map<String, Object>

审核列表

param

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

1=订单审核 2=退换单审核 3=调拨出入库单审核
单号列表

order_no_list

List<String>

对应类型的单号列表


4.响应参数

名称字段类型长度
必须描述
状态码status
Int
成功返回0
返回值data

Map<String, Object>


结果相关数据

错误信息
messageString
无错误信息不返回

data

名称字段类型长度
必须描述
提示信息

message

String
审核成功时返回"审核成功"
错误列表errorListList<Map<String, Object>>
审核失败时返回

errorList

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

order_no

String
失败的单号
错误原因messageString
失败原因


5.请求示例

Json
[
    {
        "type":3,
        "order_no_list":[
            "RK2026070141"
        ]
    }
]
PHP

header("Content-Type: text/html; charset=UTF-8");

date_default_timezone_set("Asia/Shanghai");

$client=newWdtErpClient("url","wdtapi3","appkey","secret")

$param=newstdClass();

$param->type = 1;

$param->order_no_list = ["JY202502120024","JY202502120025"];

$data=$client->call("composite.Composite.checkOrderByApi",$param);

JAVA
C#
CURL
curl --location 'http://47.92.239.46/openapi?key=wdtapi3-test9&method=composite.Composite.checkOrderByApi&salt=136787110023126585465b366becff09&sid=wdtapi3&timestamp=457557554&v=1.0&sign=165233fbe044c9fe3b3135660f5ef150' \
--header 'Content-Type: application/json' \
--data '[
    {
        "type":3,
        "order_no_list":[
            "RK2026070141"
        ]
    }
]'

6.响应示例

   6.1 正常响应示例 

JSON

{"status":0,"data":{"message":"审核成功"}}

   6.2 异常响应示例

JSON
{
    "status": 0,
    "data": {
        "errorList": [
            {
                "order_no": "JY202502120024",
                "message": "订单状态不正确"
            },
            {
                "order_no": "JY202502120025",
                "message": "订单不存在"
            }
        ]
    }
}




常用工具