B2B2C接口文档 api

1 用户认证


本开放平台提供的接口调用,需对调用者进行认证。认证的内容为userName、password和key.

2 测试环境


测试系统地址:http://testns.mosuda.com

3 对应wsdl文件地址


测试接接口地址:http://testnsservice.mosuda.com/OrderService.svc

4 方法说明

4.1 AddOrder :创建订单


说明:备注:订单明细中的在售商品编码先取outer_sku_id字段,如果为空 ,取outer_iid字段,如果outer_iid为空,取sku_id
应用级输入参数
名称 类型 是否必须 示例值 默认值 描述
order Order Y 订单信息
userName String(255) Y 用户名
password String(255) Y 密码
key String(50) Y Appkey
返回结果
名称 类型 关联数据结构 描述
ServiceResult ServiceResult ServiceResult 系统返回对象

4.2 GetOrderExpressNo:根据订单号获取订单的运单号

应用级输入参数
名称 类型 是否必须 示例值 默认值 描述
orderId String(255) Y 订单号
返回结果:返回字符串

4.3 GetOrderStatus:根据订单号获取订单在魔速达中的状态

应用级输入参数
名称 类型 是否必须 示例值 默认值 描述
orderId String(11) Y 订单号
userName String(255) Y 用户名
password String(255) Y 密码
key String(50) Y appkey
返回结果
名称 类型 关联数据结构 描述
ServiceResult ServiceResult ServiceResult 系统返回对象

4.4ValidUser: 校验用户名和密码

应用级输入参数
名称 类型 是否必须 示例值 默认值 描述
userName String(255) Y 用户名
password String(255) Y 密码
返回结果
名称 类型 关联数据结构 描述
ServiceResult ServiceResult ServiceResult 系统返回对象

5 参数备注

5.1 Order数据结果说明

应用级输入参数
属性 类型 是否必须 限制 示例值 默认值 描述
tax_fee Decimal(8,2) Y 订单税费金额
code String(50) Y 唯一 订单编号
status String(255) Y 交易状态
discount_fee Decimal(8,2) 折扣
total_fee Decimal(8,2) Y 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。
date_created DateTime Y 订单创建时间:yyyy-MM-dd HH:mm:ss
shopName String(50) Y 店铺名称
alipay_id String(255) Y 买家的支付账号
alipay_no String(100) Y 唯一 交易流水号
buyer_nick String(100) Y 买家昵称
receiver_state String(255) Y 收货人的所在省份,行政区划分省份
receiver_address String(255) Y 收货人的详细地址
receiver_zip String(255) Y 收货人的邮编
receiver_city String(255) Y 收货人的所在城市,行政区划分城市
receiver_district String(255) Y 收货人所在地区,行政区划分地区
payment Decimal(8,2) Y 实付金额。精确到2位小数;单位:元
post_fee String(8,2) Y 邮费。精确到2位小数;单位:元。
receiver_name String(20) Y 收货人的姓名
receiver_mobile String(255) Y 收货人的手机号码
receiver_phone String(20) Y 收货人的电话号码
receiver_identity String(50) 收货人的身份证号码
items OrderItem[] 必须有一个订单明细

5.2 OrderItem数据结果说明

应用级输入参数
属性 类型 是否必须 限制 示例值 默认值 描述
title String(255) Y 订单商品名称
Price Decimal(10,2) Y 订单商品,单价精确到2位小数;单位:元
sku_id String(255) 商品编码
num String(8) Y 购买数量。取值范围:大于零的整数
outer_sku_id String(20) Y 商品规格编码
outer_iid String(20) 商品ID
total_fee Decimal(10,2) Y 总价,精确到2位小数;单位:元
pic_path String(255) 备注
screen_status String(2) 商品发货类型
01 合格
02 不良品-来货破损
03 商检抽样
04 极速商品1
06 不良品-库内破损
07 不良品-涂鸦
08 不良品-带标
09 过期
10 临期0-3月
11 临期4-6月
12 临期7-9月
14 极速商品2

5.3 ServicesResult数据结果说明

应用级输入参数
属性 类型 是否必须 限制 示例值 默认值 描述
IsSuccess Bool 是否成功
true:成功
Flase:失败
Message String 返回的消息
Data String 返回的数据