文档中心 > API类目 > 跨境易API

AddOrder (创建订单)

请求地址

环境 HTTP请求地址
测试接口地址 http://bbctestservice.ekjshop.com/OrderService.svc

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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[] 必须有一个订单明细
└ 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
userName String(255) Y 用户名
password String(255) Y 密码
key String(50) Y Appkey

响应参数

名称 类型 关联数据结构 描述
ServiceResult ServiceResult ServiceResult 系统返回对象
  • └ IsSuccess
  • Bool
  • 是否成功 true:成功 Flase:失败
  • └ Message
  • String
  • 返回的消息
  • └ Data
  • String
  • 返回的数据

请求示例

  • .NET
  • JAVA
            OrderService.Order ord = new Order();
            ord.WarehouseCode = "KJYNS";
            ord.code = "Ns201607041439a";
            ord.status = "已付款";
            ord.discount_fee = Convert.ToDecimal(0);
            ord.total_fee = Convert.ToDecimal(100);
            ord.date_created = DateTime.Now;
            ord.shopName = "一通百母婴";
            ord.alipay_id = "Aaccounts1123456";
            ord.alipay_no = "Nnoss20160704";
            ord.buyer_nick = "张三";
            ord.receiver_state = "广东省";
            ord.receiver_address = "广东省深圳市南山区沙河西路3006号";
            ord.receiver_zip = "518000";
            ord.receiver_city = "深圳市";
            ord.receiver_district = "南山区";
            ord.payment = Convert.ToDecimal(100);
            ord.post_fee ="0";
            ord.tax_fee = Convert.ToDecimal(0);
            ord.receiver_name = "张三丰";
            ord.receiver_mobile = "13256566565";
            ord.receiver_phone = "0755-22233110";
            ord.receiver_identity = "430482199103010058";
            OrderItem[] _item = new OrderItem[] { new OrderItem { title = "爱他美奶粉1段 600g", price = Convert.ToDecimal(100), sku_id = "YTB0232", num = "1", 
                                                                total_fee = Convert.ToDecimal(100), outer_iid = "123456987" } };
            ord.items = _item;
            OrderClient client = new OrderClient();
            var msg= client.AddOrder(ord, "user*****", "pwd*****", "key*****");

响应示例

  • xml返回示例
 <IsSuccess>是否成功</IsSuccess>
       <Message>错误消息</Message>
       <Data>返回结果</Data>

DEMO下载