wms_stockinout_order_push.php(创建委外出入库单)
¥定制
1.接口说明
1.1 接口描述:获取ERP的采购单信息 |
1.2 适用版本:客户端 V2.4.0.5及以上版本 |
1.3 增量获取: |
1.4 时间跨度:start_time和end_time最大跨度为30天。 |
2.调用场景
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|
测试环境 | https://sandbox.wangdian.cn/openapi2/wms_stockinout_order_push.php |
正式环境 | https://api.wangdian.cn/openapi2/wms_stockinout_order_push.php |
3.2 公共请求参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
卖家账号 | sid | String |
| 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 |
接口账号 | appkey | String |
| 是 | 本开放平台“自助对接”功能模块内自助申请,申请流程单击这里
|
时间戳 | timestamp | int |
| 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 |
签名 | sign | String |
| 是 | API输入参数签名结果,签名算法介绍单击这里
|
3.3 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
入库单列表节点 | stockin_info | data |
| 是 | 其他入库单列表节点 |
stockin_info
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
外部单号 | outer_no | varchar | 40 | 是 | 外部系统的唯一单据编号,避免重复推送数据 |
外部系统单号 | api_outer_no |
|
|
|
|
仓库编号 | warehouse_no | varchar | 40 | 是 | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
邮资 | logistics_fee | decimal | (19,4) | 否 | 物流或者快递运输货物产生的费用 |
其他费用 | other_fee | decimal | (19,4) | 否 | 其他费用 |
物流编号 | logistics_code | varchar | 20 | 否 | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
物流单号 | logistics_no | varchar | 40 | 否 | 物流公司的运单号,用于追踪物流、快递流转信息(路由)的数字编码 |
是否审核 | is_check | int |
| 否 | 1:审核 0:不审核 默认0 |
是否创建批次 | is_create_batch | varchar | 40 | 否 | 0:否;1:是,默认是0。ERP“批次管理”不存在推送的批次号,是否允许单据创建成功,并创建新的“批次号”。 is_create_batch=0时,入库单推送的“批次号”ERP“批次管理不存在”,单据创建失败,并返回错误信息。 is_create_batch=1时,入库单推送的“批次号”ERP“批次管理不存在,单据会创建成功,并在ERP“批次管理”创建一个新的批次,请谨慎使用此字段。 |
省 | province |
|
|
|
|
市 | city |
|
|
|
|
县(区) | district |
|
|
|
|
详细地址 | address |
|
|
|
|
联系人 | contact |
|
|
|
|
手机号 | mobile |
|
|
|
|
固话 | telno |
|
|
|
|
自定义属性1 | prop1 |
|
|
|
|
自定义属性2 | prop2 |
|
|
|
|
自定义属性3 | prop3 |
|
|
|
|
自定义属性4 | prop4 |
|
|
|
|
备注 | remark | varchar | 255 | 否 | 其他入库单备注 |
货品明细节点 | goods_list | data |
| 是 | 入库单货品列表节点 |
goods_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
商家编码 | spec_no | varchar | 40 | 是 | ERP内单品唯一编码(SKU),代表单品(SKU)所有属性,并且为库存量出入计算最小单元。SKU概念介绍,单击这里, 注意:推送的spec_no值在ERP货品档案必须存在,否则单据会创建失败。 |
入库数量 | stockin_num | decimal | (19,4) | 是 | 入库数量 |
货位编号 | position_no | varchar | 20 | 否 | 商品在仓库内的位置编号,不传此参数,读ERP配置【入库开单货位优先级配置】,来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 |
批次 | batch_no | varchar | 20 | 否 | 货品批次编号 |
生产日期 | production_date | date |
| 否 | 货品生产日期,格式:YYYY-MM-DD |
有效期天数 | validity_days | int | 11 | 否 | 商品有效期,单位:天 |
价格 | price |
|
|
|
|
原价 | src_price | decimal | (19,4) | 是 | 上层单据的的货品价格,例如采购单的税前折后单价为采购入库的原价,原价减去入库价得出货品优惠。其他入库没有上层单据,根据业务情况自行传值。无特殊业务建议同入库价一致。 |
入库价 | stockin_price | decimal | (19,4) | 是 | 入库价格,如推送为0默认取成本价。 |
税率 | tax | decimal | (19,4) | 否 | 对征税对象的征收比例或征收额度。例如税率为16%,请求时填值为0.16 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
错误码 | code | int | 11
| 是 | 状态码:0表示成功,其他表示失败 |
错误原因 | message | varchar | 255 | 是 | 错误原因 |
入库单号 | stockin_no | varchar | 40 | 是 | ERP系统生成入库单据分配的单号 |
4.2 业务响应参数
5.请求示例
PHP | <?php
require_once("../WdtClient.php");
$c = new WdtClient;
$c->sid = '';
$c->appkey = '';
$c->appsecret = '';
$c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/shop.php';
$c->putApiParam('shop_no', 'api_test');
$json = $c->wdtOpenApi();
var_dump($json);
?> |
JAVA | package com.wangdian.api.basic;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import com.wangdian.api.WdtClient;
public class ShopQuery {
public static void main(String[] args) {
// TODO Auto-generated method stub
WdtClient client = new WdtClient("", "", "", "");
Map<String, String> params = new HashMap<String, String>();
params.put("shop_no", "ghs2test");
try {
String response = client.execute("shop.php", params);
System.out.println(response);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
} |
C# | using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;
namespace LogisticsQuery
{
class LogisticsQuery
{
static void Main(string[] args)
{
WdtClient client = new WdtClient();
client.sid = "";
client.appkey = "";
client.appsecret = "";
client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/logistics.php";
client.putParams("logistics_no", "CSOTHER");
string result = client.wdtOpenapi();
Console.WriteLine(result);
Console.ReadKey();
}
}
} |
6.响应示例
6.1 正常响应示例
JSON
| {
"code": 0,
"shoplist": [
{
"platform_id": "127",
"sub_platform_id": "0",
"shop_id": "2",
"shop_no": "ft001",
"shop_name": "飞拓测试店铺",
"account_id": "",
"account_nick": "",
"province": "420000",
"city": "420100",
"district": "0",
"address": "",
"contact": "139",
"zip": "",
"mobile": "",
"telno": ""
}
]
} |
6.2 异常响应示例
JSON
| {
"code": 0,
"shoplist": [
{
"platform_id": "127",
"sub_platform_id": "0",
"shop_id": "2",
"shop_no": "ft001",
"shop_name": "飞拓测试店铺",
"account_id": "",
"account_nick": "",
"province": "420000",
"city": "420100",
"district": "0",
"address": "",
"contact": "139",
"zip": "",
"mobile": "",
"telno": ""
}
]
} |