开放平台

文档中心 > API类目 > 快件API

AddB2Corder (添加订单)

请求地址

环境 HTTP请求地址
接口地址 请联系业务人员

请求参数

名称 类型 是否必须 示例值 更多限制 描述
OrderCode String（255） Y 唯一 订单编号
CustomerNo String（255） 报关单号
WayBillNo String（255） 提货单号
SmallTicketNo String（255） Y 附件和小票号二选一 小票号或交易号
SmallTicketFile String 内件小票jpg图片附件, BASE64编码字节串(图片限制于500K左右)
BagNo String(255) 托盘号(卡板号)
Sender String(255) Y 发件人
SendCity String(255) Y 英文发件人城市
SendCityCH String(255) Y 中文发件人城市
SendAddress String(255) Y 发件人地址
SendPhone String(255) Y 发件人电话
Receiver String(255) Y 收件人
ReceiveCardNo String(255) 身份证附件上传以后身份证号必填 收件人身份证
CardFile String 身份证附件上传以后身份证号必填 身份证jpg图片附件,BASE64编码字节串(图片限制于500K左右)
OppositeFile String（255） 身份证反面(同上)
ReceivePhone String Y 收件人电话
ReceiveAddress String Y 收件人地址
ReceiveProvince String Y 收件人省份
ReceiveCity String Y 收件人城市
ReceiveZip String Y 收件人邮编
BuyerNickname String 买家昵称
AlipayAccount String 支付帐号
PaidTime DateTime Y 支付日期
TotalPrice Decimal（18,4） Y 必须等于明细里数量*单价的总和 订单总金额
BagName String（255） Y 内件名称(根据行邮税所包含的物件名称,以、作为分隔,例如：饮料、其他食品)
BagCount Decimal（18,4） Y 内件总数量(订单明细中的数量总和)
BagWeight Decimal（18,4） Y 大于0 重量(KG订单包裹的总重量)
CountryCode String(255) Y 必须正确 国家简称(原寄地对应的国家简称两位大写字母)
ExpressNo String(255) 运单号(如果需要再跨境易中打单则不填反之必填)
ShopName String(50) 店铺名称
ShopId String 口岸编号
Items B2COrderItem[] Y 必须有一个订单明细 订单明细
└ ProductName String（255） Y 商品名称
└ ProductNameEn String（255） Y 商品名称
└ SalesCity String（255） Y 产销城市（例如：NewYork）
└ ProductBrand String（255） 商品品牌
└ ProductCount String（10） Y 大于0 商品数量
└ TotalWeight Decimal（10） Y 大于0 物品总净重
└ GrossWeight Decimal（10） 大于物品总净重 物品总毛重
└ Specification String（30） 商品规格
└ Unit String(255) Y 单位
└ Price Decimal(10,2) Y 大于0 商品单价
└ Currency String(255) Y 币别,默认美元USD
└ PostTaxNum String(50) 行邮税号
└ Status String(255) 状态
ExpressCompanyCode String(255) Y 快递公司代码（只能填：E 邮政快递）
userName String（255） Y B2C电商用户名
password String（255） Y B2C电商用户密码
key String（50） Y 校验KEY
POLPort String（20） 指运港（装货港）

响应参数

名称 类型 关联数据结构 描述
ServiceResult ServiceResult ServiceResult 系统返回对象

请求示例

  • .NET
  • JAVA
 
                B2COrder order = new B2COrder();
                order.AlipayAccount = "";
                order.OrderCode = "201407310019test";
                order.SmallTicketNo = "2";
                order.BagCount = 2;
                order.BagName = "奶粉";
                order.BagWeight = 300;
                order.ReceiveAddress = "广东省深圳市南山区as12";
                order.ReceiveCardNo = "110101200504284312";
                order.ReceiveCity = "西安";
                order.ReceiveProvince = "湖北";
                order.ReceivePhone = "13115898711";
                order.ReceiveZip = "135800";
                order.Receiver = "万军e1e";
                order.SendAddress = "Xenonstra1a1250";
                order.SendPhone = "13113005165";
                order.Sender = "kxm";
                order.TotalPrice = 111;
                order.BagNo = "test123";
                order.CountryCode = "NL";
                order.PaidTime = DateTime.Now;
                order.SendCity = "NewYork";
                order.SendCityCH = "纽约";
                //读取图片流
                Encoding encoding = Encoding.GetEncoding(28591);
                StreamReader sr = new StreamReader(Assembly.GetExecutingAssembly().Location + "\\demo.jpg", encoding);
                string strTemp = sr.ReadToEnd();
                sr.Close();
                //转换成base64串
                byte[] bytes = encoding.GetBytes(strTemp);
                string strBase64 = Convert.ToBase64String(bytes);
                order.CardFile = strBase64;
                order.SmallTicketFile = strBase64;
                //订单明细
                B2COrderItem[] orderItems = new B2COrderItem[] { new B2COrderItem() {
                   Currency = "CNY",
                   PostTaxNum = "01010700",
                   Price = 11,
                   ProductBrand = "奶粉",
                   ProductCount = 1,
                   ProductName = "爱他美2段 800g/罐",
                   ShortName="爱他美",
                   ProductCode="Test",
                   Unit = "罐",
                   Specification="箱",
                   TotalWeight=100
                } ,
                   new B2COrderItem(){
                   PostTaxNum="3024225493",
                   Price=100,
                   ProductBrand="test",
                   ProductCount=1,
                   ProductName="尿不湿",
                   Unit="包",
                   Specification="盒",
                   TotalWeight=200
                   }
                };
                order.Items = orderItems;
                var client = new B2COrderServiceClient();
                var result = client.AddB2COrder(order, "user*****", "pwd*****", "key*****");

响应示例

  • XML示例
     <Data>返回的数据</Data>                           
     <IsSuccess>是否成功</IsSuccess>
     <Message>返回的消息</Message>

DEMO下载

.NET下载 JAVA下载