蜀海平台API手册V20

1、蜀海平台API手册V2.0目录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 -1. 流程图蜀海方维护门店、商品的匹配关系，客户方下单才能推送成功我方SAP系统过账后，蜀海可将实际发货数量推送给客户方系统退货由我方发起，客户方做接收操作2. 订单管理接口2.

2、1 创建订单2.1.1 接口调用请求说明测试地址98:3002/SHApi.asmxWSDL98:3002/SHApi.asmx?WSDLPHP版本98:3002/shapi_php.asmx测试用户名密码hdltest01、haidilao01/平台账号和密码（我方提供）正式地址正式用户名密码hdl01、haidilao01/平台账号和密码（我方提供）请求方法CreateOrder备注描述该方法主要实现蜀海供应链平台的下单操作，传入的门店编码、物料编码由我方自动匹配单位、规格、价格等都

3、按蜀海为准，所以匹配一定要准确，建议客户方获取我们的门店信息、商品信息做为客户的门店编码、商品编码，这样匹配就更简单了。2.1.2 请求参数说明参数字段是否必填说明OrderEntity订单实体OrderNo是客户方-订单号（主键）MemberName否客户方-客户名称ShopCode是客户方-门店代码ShopName否客户方-门店名称OrderType否订单类型（代采/代仓），抬头和明细必选填一个，如客户方未按订单拆分类型，明细需要告知订单类型，优先级高于明细订单类型DeliveryDate否交货日期（格式：yyyy-MM-dd）可不填写，按蜀海下单截止时间为准CreateTime是创建时间

4、OrderDetailList订单实体-明细列表OrderDetailId是客户方-订单明细IDSkuId是客户方-商品编码建议使用我方物料号做为客户方的商品编码SkuName否商品名称SkuPrice否商品售价（保留2位小数）SkuQty是订购数量（保留2位小数），标品必须为整数，例如按件销售，不能订0.5件UnitName否单位名称，按蜀海签订合同销售单位为准，该字段只做记录SpecName否规格名称OrderType否订单类型（代采/代仓）2.1.3 返回数据说明字段说明OrderMessageEntity订单消息实体ErrorCode消息状态（1成功，其他失败）ErrorMessage

5、消息描述OrderNo我方订单号C# 示例代码：/API订单SHApi.OrderEntity orderEntity = new SHApi.OrderEntity();orderEntity.OrderNo = "YUKU2016072501" /客户方订单号，订单号唯一orderEntity.MemberName = ""orderEntity.ShopCode = "CN022028" /客户方门店编码orderEntity.ShopName = ""orderEntity.OrderType = &quo

6、t;代采" /订单类型（代采或代仓）orderEntity.CreateTime = DateTime.Now;List<SHApi.OrderDetailEntity> orderDetailList = new List<SHApi.OrderDetailEntity>();orderDetailList.Add(new SHApi.OrderDetailEntity()OrderDetailId = "1", /客户方订单明细Id，唯一SkuId = "0201060010", /客户方商品编码SkuQty = 2

7、m /订购数量);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.Cre

8、ateOrder(header, orderEntity);if (message.ErrorCode = 1) /消息状态（1成功，其他失败）Java 示例代码或者 以下Java DemoPHP版本 Demo2.2 获取订单（API下单的客户）2.2.1 接口调用请求说明测试地址98:3002/SHApi.asmxWSDL98:3002/SHApi.asmx?WSDL测试用户名密码hdltest01、haidilao01/平台账号和密码（我方提供）正式地址正式用户名密码hdl01、haidilao01/平台账号和密码（我

9、方提供）请求方法GetOrder备注描述该方法主要实现根据客户方的订单号查询订单明细信息，返回对应的订单明细实发数量、明细标识2.2.2 请求参数说明参数字段是否必填说明OrderNo是客户方-订单号2.2.3 返回数据说明字段说明OrderEntity订单实体OrderNo客户方-订单号MemberName客户方-客户名称ShopCode客户方-门店代码ShopName客户方-门店名称OrderType订单类型（代采/代仓）DeliveryDate交货日期（格式：yyyy-MM-dd）ErrorCode消息状态（1成功，其他失败）ErrorMessage消息描述实体明细列表OrderDeta

10、ilList订单实体-明细列表OrderDetailId客户方-订单明细IDSkuId客户方-商品编码SkuName商品名称SkuPrice商品售价（保留2位小数）SkuQty订购数量（保留2位小数）UnitName单位名称SpecName规格名称FinalQty实发数量（保留2位小数）FlagW未发货 S已发货 D已删除2.3 获取订单（非API下单客户）2.3.1 接口调用请求说明测试地址98:3002/SHApi.asmxWSDL98:3002/SHApi.asmx?WSDL测试用户名密码平台账号和密码（我方提供）正

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

12、/代采ShopName客户方-门店名称OrderType订单类型（代采/代仓）DeliveryDate交货日期（格式：yyyy-MM-dd）CreateTime订单创建时间OrderPrice订购金额Order_DetailQty明细行数SapOrderNoSAP订单号实体明细列表OrderDetailList订单实体-明细列表OrderNoOMS订单号SkuId商品编码SkuName商品名称SkuPrice商品单价SkuQty订购数量UnitName单位描述FinalQty实发数量Flag状态：W未发货、S已发货、D已删除2.4 订单接收（客户提供URL）2.4.1 接口调用请求说明接口PO

13、ST地址http:/xxx/ShApi/GetOrder备注描述客户方提供接收地址， 蜀海方会定时将已发货的订单通过xml方式推送到指定的接收地址2.4.2 请求参数说明参数字段是否必填说明2.4.3 POST数据说明字段说明Order退单实体OrderNo客户方-订单号ShopCode客户方-门店代码DeliveryDate交货日期（格式：yyyy-MM-dd）实体明细列表OrderDetailList订单明细列表OrderDetailId客户方-订单明细IdSkuId客户方-商品编码SkuQty订购数量OmsSkuPrice我方-商品单价FinalQty实发数量FlagS已发货 D已取消P

14、OST XML 如下：<?xml version="1.0" encoding="utf-8"?><Order> <OrderNo>2017090116280001</OrderNo> <ShopCode>CN022028</ShopCode> <DeliveryDate>2017-09-02</DeliveryDate> <OrderDetailList> <OrderDetail> <OrderDetailId>2017

15、0901001</ OrderDetailId > <SkuId>0201040001</SkuId> <SkuQty>2</ SkuQty > <OmsSkuPrice>2</ OmsSkuPrice > <FinalQty>2</ FinalQty ><Flag>S</ Flag > </OrderDetail> <OrderDetail> <OrderDetailId>20170901002</ OrderDetai

16、lId > <SkuId>0202090002</SkuId> <SkuQty>5</ SkuQty > <OmsSkuPrice>0</ OmsSkuPrice > <FinalQty>0</ FinalQty ><Flag>D</ Flag > </OrderDetail> </OrderDetailList></Order>2.4.4 返回参数说明说明接收成功，直接返回success，失败直接返回失败原因3. 退单管理接口3.1

17、 退货接收（客户提供URL）3.1.1 接口调用请求说明接口POST地址http:/xxx/ShApi/GetReturn备注描述客户方提供接收地址， 蜀海方会定时将已入库的退货单通过xml方式推送到指定的接收地址3.1.2 请求参数说明参数字段是否必填说明3.1.3 POST数据说明字段说明ReturnOrder退单实体ReturnOrderNo我方-退单号OmsMemberCode我方-客户代码CustomerShopCode客户方-门店代码ReturnDate退货日期（格式：yyyy-MM-dd）CustomerOrderNo客户方-原订单号实体明细列表ReturnOrderDetail

18、List退货明细列表CustomerSkuId客户方-商品编码ReturnQty退货数量（保留3位小数）POST XML 如下：<?xml version="1.0" encoding="utf-8"?><ReturnOrder> <ReturnOrderNo>7000117062116280001</ReturnOrderNo> <CustomerShopCode>CN022028</CustomerShopCode> <ReturnDate>2017-07-19<

19、;/ReturnDate> <CustomerOrderNo>CN022028CG20170717004-1</CustomerOrderNo> <ReturnOrderDetailList> <ReturnOrderDetail> <CustomerSkuId>0201040001</CustomerSkuId> <ReturnQty>1.12</ReturnQty> </ReturnOrderDetail> <ReturnOrderDetail> <Custo

20、merSkuId>0201040007</CustomerSkuId> <ReturnQty>2</ReturnQty> </ReturnOrderDetail> </ReturnOrderDetailList></ReturnOrder>3.1.4 返回参数说明说明接收成功，直接返回success，失败直接返回失败原因4. 库存管理接口4.1 获取代仓库存（WMS）4.1.1 接口调用请求说明测试地址98:3002/SHApi.asmxWSDL

21、98:3002/SHApi.asmx?WSDL测试用户名密码平台账号和密码（我方提供）正式地址正式用户名密码平台账号和密码（我方提供）请求方法GetSkuStock_WMS备注描述该方法主要实现该客户在蜀海代仓，且使用我方WMS管理的，返回代仓物料的结存4.1.2 请求参数说明参数字段是否必填说明4.1.3 返回数据说明字段说明Output_SkuStock_WMS消息实体ErrorCode消息状态（1成功，其他失败）ErrorMessage消息描述SkuStockList库存列表MaterialNumber我方-物料号SkuName物料描述Actual_Qty可用库存Unavailable_Qty不可用库存UnitCode发货单位UnitName发货单位描述CustomerMaterialNumber客户方-物料号5. 基础信息接口5.1 获取门店5.1.1 接口调用请求说明测试地址98:3002/SHApi.asmxWSDL98:3002/SHApi.asmx?WSDL测试用户名密码平台账号和密码（我方提供）正式地址正式用户名密码平台账号和密码（我方提供）请求方法GetShop备注描述该方法主要实现该客户的门店信息返回5.1.2 请求参数说明参数字段是否必