蜀海平台API手册V20.doc

1、蜀海平台 API 手册 V2.0- 1 -目录1. 订单管理接口 .- 1 -1.1 创建订单 .- 1 -1.2 获取订单（API 下单的客户） .- 3 -1.3 获取订单（非 API 下单客户） .- 5 -1.4 订单接收（客户提供 URL） .- 6 -2. 退单管理接口 .- 8 -2.1 退货接收（客户提供 URL） .- 8 -3. 库存管理接口 .- 9 -3.1 获取代仓库存（WMS） .- 9 -4. 基础信息接口 .- 10 -4.1 获取门店 .- 10 -4.2 获取售价 .- 11 - 2 -1. 流程图蜀海方维护门店、商品的匹配关系，客户方下单才能推送成功我方

2、SAP 系统过账后，蜀海可将实际发货数量推送给客户方系统退货由我方发起，客户方做接收操作2. 订单管理接口2.1 创建订单2.1.1 接口调用请求说明测试地址 http:/123.57.211.198:3001/SHApi.asmxWSDL http:/123.57.211.198:3001/SHApi.asmx?WSDLPHP 版本 http:/123.57.211.198:3001/shapi_php.asmx测试用户名密码 hdltest01、haidilao01/平台账号和密码（我方提供）正式地址 http:/ hdl01、haidilao01/平台账号和密码（我方提供）请求方法 Cr

3、eateOrder备注描述 该方法主要实现蜀海供应链平台的下单操作，传入的门店编码、物料编码由我方自动匹配单位、规格、价格等都按蜀海为准，所以匹配一定要准确，建议客- 3 -户方获取我们的门店信息、商品信息做为客户的门店编码、商品编码，这样匹配就更简单了。2.1.2 请求参数说明参数 字段 是否必填 说明OrderEntity 订单实体OrderNo 是 客户方-订单号（主键）MemberName 否 客户方-客户名称ShopCode 是 客户方-门店代码ShopName 否 客户方-门店名称OrderType 否 订单类型（代采/代仓） ，抬头和明细必选填一个，如客户方未按订单拆分类型，明细

4、需要告知订单类型，优先级高于明细订单类型DeliveryDate 否 交货日期（格式：yyyy-MM-dd）可不填写，按蜀海下单截止时间为准CreateTime 是 创建时间OrderDetailList 订单实体-明细列表OrderDetailId 是 客户方-订单明细 IDSkuId 是 客户方-商品编码建议使用我方物料号做为客户方的商品编码SkuName 否 商品名称SkuPrice 否 商品售价（保留 2 位小数）SkuQty 是 订购数量（保留 2 位小数） ，标品必须为整数，例如按件销售，不能订0.5 件UnitName 否 单位名称，按蜀海签订合同销售单位为准，该字段只做记录-

5、4 -SpecName 否 规格名称OrderType 否 订单类型（代采/代仓）2.1.3 返回数据说明字段 说明订单消息实体ErrorCode 消息状态（1 成功，其他失败）ErrorMessage 消息描述OrderMessageEntityOrderNo 我方订单号C# 示例代码：/API订单SHApi.OrderEntity orderEntity = new SHApi.OrderEntity();orderEntity.OrderNo = “YUKU2016072501“; /客户方订单号，订单号唯一orderEntity.MemberName = “;orderEntity.S

6、hopCode = “CN022028“; /客户方门店编码orderEntity.ShopName = “;orderEntity.OrderType = “代采“; /订单类型（代采或代仓）orderEntity.CreateTime = DateTime.Now;List orderDetailList = new List();orderDetailList.Add(new SHApi.OrderDetailEntity()OrderDetailId = “1“, /客户方订单明细Id，唯一SkuId = “0201060010“, /客户方商品编码SkuQty = 2m /订购数量)

7、;orderEntity.OrderDetailList = orderDetailList.ToArray();SHApi.MySoapHeader header = new SHApi.MySoapHeader();header.userName = “hdltest01“;header.userPwd = “haidilao01“;SHApi.SHApiSoapClient client = new SHApi.SHApiSoapClient();SHApi.OrderMessageEntity message = client.CreateOrder(header, orderEnti

8、ty);if (message.ErrorCode = 1)/消息状态（1成功，其他失败）- 5 -Java 示例代码或者 以下Java DemoJavaGetSHApi_Test.rarPHP版本 DemoPhpGetSHApi_Test.rar2.2 获取订单（API 下单的客户）2.2.1 接口调用请求说明测试地址 http:/123.57.211.198:3001/SHApi.asmxWSDL http:/123.57.211.198:3001/SHApi.asmx?WSDL- 6 -测试用户名密码 hdltest01、haidilao01/平台账号和密码（我方提供）正式地址 http

9、:/ hdl01、haidilao01/平台账号和密码（我方提供）请求方法 GetOrder备注描述 该方法主要实现根据客户方的订单号查询订单明细信息，返回对应的订单明细实发数量、明细标识2.2.2 请求参数说明参数 字段 是否必填 说明OrderNo 是 客户方-订单号2.2.3 返回数据说明字段 说明OrderEntity 订单实体OrderNo 客户方-订单号MemberName 客户方-客户名称ShopCode 客户方-门店代码ShopName 客户方-门店名称OrderType 订单类型（代采/代仓）DeliveryDate 交货日期（格式：yyyy-MM-dd）ErrorCode

10、消息状态（1 成功，其他失败）ErrorMessage 消息描述实体明细列表 OrderDetailList 订单实体-明细列表OrderDetailId 客户方-订单明细 IDSkuId 客户方-商品编码SkuName 商品名称SkuPrice 商品售价（保留 2 位小数）SkuQty 订购数量（保留 2 位小数）UnitName 单位名称SpecName 规格名称- 7 -FinalQty 实发数量（保留 2 位小数）Flag W 未发货 S 已发货 D 已删除2.3 获取订单（非 API 下单客户）2.3.1 接口调用请求说明测试地址 http:/123.57.211.198:3001/

11、SHApi.asmxWSDL http:/123.57.211.198:3001/SHApi.asmx?WSDL测试用户名密码 平台账号和密码（我方提供）正式地址 http:/ 平台账号和密码（我方提供）请求方法 GetOrderList备注描述 该方法主要实现使用蜀海供应链平台下单，但想获取我们的订单数据，调用该接口即可，返回的门店编码、物料编码为我方编码，需要客户方做匹配关系2.3.2 请求参数说明参数 字段 是否必填 说明DeliveryDate 是 交货日期（yyyy-MM-dd）2.3.3 返回数据说明字段 说明订单消息实体ErrorCode 消息状态（1 成功，其他失败）Outpu

12、t_OrderErrorMessage 消息描述OrderList 订单列表OmsOrderNo OMS 订单号MemberCode 客户代码ShopCode 门店代码OrderType 代仓/代采- 8 -ShopName 客户方-门店名称OrderType 订单类型（代采/代仓）DeliveryDate 交货日期（格式：yyyy-MM-dd）CreateTime 订单创建时间OrderPrice 订购金额Order_DetailQty 明细行数SapOrderNo SAP 订单号实体明细列表 OrderDetailList 订单实体-明细列表OrderNo OMS 订单号SkuId 商品编

13、码SkuName 商品名称SkuPrice 商品单价SkuQty 订购数量UnitName 单位描述FinalQty 实发数量Flag 状态：W 未发货、S 已发货、D 已删除2.4 订单接收（客户提供 URL）2.4.1 接口调用请求说明接口 POST 地址 http:/xxx/ShApi/GetOrder备注描述 客户方提供接收地址， 蜀海方会定时将已发货的订单通过 xml 方式推送到指定的接收地址2.4.2 请求参数说明参数 字段 是否必填 说明2.4.3 POST 数据说明字段 说明- 9 -Order 退单实体OrderNo 客户方-订单号ShopCode 客户方-门店代码DeliveryDate 交货日期（格式：yyyy-MM-dd）实体明细列表 OrderDetailList 订单明细列表OrderDetailId 客户方-订单明细 IdSkuId 客户方-商品编码SkuQty 订购数量OmsSkuPrice 我方-商品单价FinalQty 实发数量Flag S 已发货 D 已取消POST XML 如下：2017090116280001CN0220282017-09-02201709010010201040001222S201709010020202090002500D