当前位置： API文档

operational_order_create.php（运营仓单据创建）

¥标准

1.接口说明

1.1 接口描述：通过接口推送创建erp系统运营仓管理-运营仓单据 数据
1.2 适用版本：网页版

2.调用场景

2.1 线下ERP等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

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

正式环境

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

11是

1.分配单 2.归还单 3.调拨单

入库运营仓

in_warehouse_name

string

40否

入库运营仓仓库名称，当单据类型为1.分配单、3.调拨单时，该字段必填

出库运营仓

out_warehouse_name

string

40否

出库运营仓仓库名称，当单据类型为2.归还单、3.调拨单时，该字段必填

仓库id

real_warehouse_id

string

40是代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
备注remarkvarchar255否备注
货品列表节点detail_listdata[ ]
是请求参数的2级数据节点，节点下数据字段详见下述“detail_list”

detail_list

名称字段类型长度必须描述
商家编码

sku_no

varchar40是代表单品(sku)所有属性的唯一编码，ERP内单品唯一编码（sku）。推送的spec_no值在ERP货品档案必须存在，且上一层单据退换单也必须存在此编号，否则单据会创建失败。SKU概念介绍,单击这里
数量numdecimal(19,4)是数量
备注remarkvarchar255否备注

4.响应参数

   4.1 响应参数

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

order_no

varchar20否单据号

5.请求示例

PHP
//其他入库单新建
<?php
        require_once('../WdtClient.php');
    $c = new WdtClient;
        $c->sid ='';
    $c->appkey ='';
    $c->appsecret ="";
    //测试环境地址
    //上线时需要换成线上的
        $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/operational_order_create.php'; // 测试的
    $spec_item = new stdClass();
    $spec_item->sku_no = "951027";
    $spec_item->num = "1";
    $detail_list = [$spec_item];

    $c->putApiParam('order_type', '1');
    $c->putApiParam('in_warehouse_name', "测试运营仓1");
    //$c->putApiParam('out_warehouse_name', 1);
       $c->putApiParam('real_warehouse_id', "240");
    $c->putApiParam("detail_list", json_encode($detail_list, JSON_UNESCAPED_UNICODE));
 
    $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": "",
	"order_no": "OP2604090006"
}

   6.2 异常响应示例

JSON
{
	"code": 1020,
	"message": "商家编码(新):【951027】分配数量不可超过公共可用库存",
	"order_no": null
}





常用工具