V兔API开放平台

变量名称	变量命名	变量类型	是否必填	示例	说明
订单编号	o	long	否	12345678	一次一个订单信息。支持包裹编号和父订单编号。如果输入的是包裹编号，则只需返回包裹订单信息（列表中的所有项都显示内容）；如果输入的是父订单编号，则只返回父订单信息。
外部订单编号	outerOrderID	string	否	AT9-023902	外部订单编号，可以填写字母/数字/汉字。支持包裹和父订单的“外部订单编号”。如果输入的是包裹的“外部订单编号”，则只需返回包裹订单信息（列表中的所有项都显示内容）；如果输入的是父订单的“外部订单编号”，则只返回父订单信息。
版本	vvtype	int	是	普通版 1，不传默认 1，增强版 2，增强版的需要传参 2

请求示例

{
    
}

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

响应参数

变量名称	变量命名	变量类型	是否必填	示例	描述

1、订单编号	orderID	long	是
订单状态	orderState	int	是	100 等待到款 101 等待发货（商家后台页面中显示为“等待配货”状态的订单也会返为“等待发货”） 300 已发货 400 已送达 1000 交易成功 -100 取消 1100 交易失败 260 部分发货 50 等待审核
订单实际状态	orderStatus	int	是	0 等待到款 50 等待审核 100 等待配货 200 等待发货 300 已发货 400 已送达 1000 交易成功 -100 取消 260 部分发货 1100 交易失败
4、父订单号	parentOrderID	long	是	父订单号（目前暂无拆单业务，此节点均为空）
5、外部订单号	outerOrderID	String	是	外部订单号
6、是否已打单	isCourierReceiptDetail	int	是
7、留言	message	string	是	买家留言
8、备注	remark	string	是	备注
9、标记	label	int	是	5类固定标记： 1 红色 2 黄色 3 绿色 4 蓝色 5 紫色
10、最后修改时间	lastModifyTime	string	是
11、付款时间	paymentDate	string	是	格式： YYYY-MM-DD hh:mm:ss
12、订单类型	orderMode	int	是	1 自发 2 代发
13、发货日期	sendDate	int	是	格式： YYYY-MM-DD hh:mm:ss
14、是否为预售订单	isPresale	int	是	0 不是 1 是
15、原订单号	originalOrderId	long	是	如果该单为换货生成新订单，则为原始订单号。否则为空
16、订单总税金	taxFee	float	是	订单总税金
17、消费税	consumptionDutyAmount	float	是	消费税
18、关税	tariffAmount	float	是	关税
19、增值税	addedValueTaxAmount	float	是	增值税
20、身份证号	identityNum	string	是	身份证号
21、发票地址	einvoiceAddress	string	是	电子发票地址此节点挪动参看：receiptInfo.eReceiptAddress
22、来源仓id	warehouseID	int	是
23、是否节能补贴订单	isSubsidyOrder	int	是	0 否 1 是
24、节能补贴金额	subsidyAmount	float	是
25、礼品卡手续费	giftCardCharge	float	是	有礼品卡才会有礼品卡手续费
26、缺货部分礼品卡手续费	lackGiftCardCharge	float	是
27、发货部分礼品卡手续费	sendGiftCardCharge	float	是
28、订单结款金额	orderBalance	float	是	订单结款金额
29、礼券ID	couponId	String	是	礼券ID
30、礼券发放	couponProvider	int	是
31、商家承担百分比	couponRate	int	是
32、订单操作列表信息	OrderOperateList	-	是	订单操作列表信息含多条订单操作信息，操作信息见OperateInfo节点
32.1、操作信息	OperateInfo	-	是
32.1.1、操作角色	operateRole	string	是	4种类型:顾客、商家、系统、当当
32.1.2、操作时间	operateTime	string	是	操作时间，格式:YYYY-MM-DD hh:mm:ss
32.1.3、操作	operateDetails	string	是	订单的历史操作信息，如：顾客下单、商家或者系统审核通过
33、买家信息	buyerInfo	string	是
33.1、买家付款方式	buyerPayMode	string	是	目前有以下几种:货到付款、网上支付、银行汇款、邮局汇款
33.2、买家支付货款	goodsMoney	float	是	本订单商家应收金额
33.3、买家已支付金额	realPaidAmount	float	是	网银支付金额+礼品卡支付金额+当当账户余额支付金额
33.4、网银支付满额减优惠金额	deductAmount	float	是	网银支付满额减优惠金额
33.5、促销优惠金额	promoDeductAmount	float	是
33.6、顾客需为订单支付现金	totalBarginPrice	float	是	顾客需为订单支付现金
33.7、买家支付邮费	postage	float	是	买家支付的邮费，格式：小数点后两位的正数
33.8、买家支付礼券金额	giftCertMoney	float	是	买家支付的礼券金额，格式：小数点后两位的正数
33.9、买家支付礼品卡金额	giftCardMoney	float	是	买家支付礼品卡的金额，格式：小数点后两位的正数
33.10、买家支付账户余额	accountBalance	float	是	买家支付账户余额，格式：小数点后两位的正数
33.11、移动端优惠金额	activityDeductAmount	float	是	移动端优惠金额，格式：小数点后两位的正数
33.12、买家使用积分数	custPointUsed	float	是	买家使用积分数
33.13、买家使用积分抵扣金额	pointDeductionAmount	float	是	买家使用积分抵扣金额，格式：小数点后两位的正数
33.14、买家使用红包金额	redPacket	float	是	买家使用红包金额，格式：小数点后两位的正数
33.15、当当价总和	totalDangDangPrice	float	是	当当价*数量 2021-06-01 发布
33.16、集合级促销总和	gatherSalesPromoDeductAmount	float	是	集合级促销总和 2021-06-01 发布
34、送货信息	sendGoodsInfo	-	是
34.1、顾客当当网帐号的标志符	dangdangAccountID	long	是	顾客当当网帐号的标志符
34.2、收货人姓名	consigneeName	string	是	收货人姓名
34.3、收货地址	consigneeAddr	string	是	含国家、省、市、区、详细地址
34.4、收货国家	consigneeAddr_State	string	是	收货国家，如：中国
34.5、收货省份	consigneeAddr_Province	string	是	收货省份，如：北京
34.6、收货市	consigneeAddr_City	string	是	收货市，如：北京市
34.7、收货区	consigneeAddr_Area	string	是	收货区，如：朝阳区
34.8、收货地址邮编	consigneePostcode	string	是	邮编
34.9、收货人固定电话	consigneeTel	string	是	示例：010-57993xxx
34.10、收货人移动电话	consigneeMobileTel	string	是	示例：13819732xxx
34.11、送货方式	sendGoodsMode	string	是
34.12、物流公司	sendCompany	string	是	物流公司名称（因订单可能出现多个包裹，所以此字段不再适用，请查看dangdang.order.details.package.get文档中的包件物流信息）
34.13、送货单编号	sendOrderID	string	是	物流公司送货单编号（因订单可能出现多个包裹，所以此字段不再适用，请查看dangdang.order.details.package.get文档中的包件物流信息）
34.14、把包裹发到当当仓库地址	DangdangWarehouseAddr	string	是	商家需要把包裹发到当当仓库地址
35、商品清单	ItemsList	-	是	商品清单含若干商品信息
35.1、商品信息	ItemInfo	-	是
35.1.1、商品标识符	itemID	long	是	商品标识符
35.1.2、企业商品标志符	outerItemID	string	是	企业商品标识符
35.1.3、商品名称	itemName	string	是	商品名称
35.1.4、商品类型	itemType	int	是	0 商品 1 赠品
35.1.5、分色分码	specialAttribute	string	是	发布前：使用“自定义属性名称”，例子如下：颜色>>军绿;鞋码 >>38 发布后：军绿,38 2021-06-01 发布
35.1.6、市场价	marketPrice	float	是	市场价，格式：小数点后两位的正数
35.1.7、是否节能补贴商品	is_energySubsidy	float	是
35.1.8、节能补贴金额	subsidyPrice	float	是	节能补贴金额，格式：小数点后两位的正数
35.1.9、成交价	unitPrice	float	是	成交价，格式：小数点后两位的正数
35.1.10、订购数量	orderCount	int	是	订购数量，整型
35.1.11、发货数量	sendGoodsCount	int	是	当订单状态为“已发货”，才返回此项，表示实际发货数量 2021-06-01 发布
35.1.12、所属商品集合促销编号	belongProductsPromoID	int	是	商品所属商品集合促销编号
35.1.13、商品明细编号	productItemId	int	是	代表这个商品在这个促销的唯一标示id
35.1.14、序列号	serialNumbers	string	是	供应商订单才有
35.1.15、商品主图地址	productImg	string	是	商品主图url
35.1.16、商品版本	productVersion	string	是	商品版本信息
35.1.17、品级已支付金额	itemRealPaidAmount	float	是
36、促销列表	PromoList	-	是	促销列表含若干促销信息
36.1、促销信息	promoItem	-	是
36.1.1、促销编号	promotionID	int	是	促销的id
36.1.2、促销名称	promotionName	string	是	促销名称
36.1.3、促销类型	promotionType	int	是	促销的类型编号
36.1.4、单个促销的优惠金额	promoDicount	float	是	单个促销的优惠金额
36.1.5、促销在订单中的订购数量	promoAmount	int	是	该促销的订购数量
37、发票信息	receiptInfo		-	发票信息含： 1、发票抬头 2、发票内容 3、发票金额 4、是否由当当代开发票 5、电话 6、发票类型如果买家要求提供发票，那么发票信息3项必全部返回
37.1、发票抬头	receiptName	string	是	发票抬头
37.2、发票内容	receiptDetails	string	是	发票内容
37.3、发票金额	receiptMoney	float	是	发票金额，格式：小数点后两位的正数
37.4、是否由当当代开发票	Is_DangdangReceipt	int	是
37.5、电话	receiptTel	string	是	开电子发票时所需的电话
37.6、发票类型	receiptType	int	是
37.7、电子发票地址	eReceiptAddress	string	是	电子发票地址（只有电子发票时有数据，即receiptType=2时）
37.8、纳税人识别号	taxpayerId	string	是	纳税人识别号/社会统一信用代码
38、处理结果	Result	string	是
38.1、操作码	operCode	int	是	35,500
38.2、操作结果信息	operation	string	是
39、订单级金额信息集合	DetailPromotionInfoList	list	是	子集节点：DetailPromotionInfo 枚举值： bank(1,"银行满减"), giftCard(2,"礼品卡"), giftCardCharge(18,"礼品卡手续费"), ddVCard(22, "当当V卡"), ddVCardCharge(23, "当当V卡手续费"), redPackat(24, "红包"), accountBalance(3,"余额"), coupon(4,"礼券"), points(5,"当当积分金额"), pointsCount(6,"当当积分数量"), telphone(7,"手机直减"), promotionNumber(8,"优惠码"), orderSalesPromotion(10,"订单级促销"), gatherSalesPromotion(9,"集合级促销"), takeGoodsNumber(116, "提货码"), deposit(110, "拍卖：保证金"), clockInAmount(118,"打卡金"), tax(106,"税费"), advancePayment(19,"订金预售订单:订金"), restPayment(20,"订金预售订单:尾款"), cash(100,"现金"), totalAmount(102,"总货款"),//不包含运费 total(1000,"总货款+运费"), shippingFee(103,"运费"); 2021-06-01 发布
39.1、金额类型	promotionType	int	是	2021-06-01 发布
39.2、具体金额	promotionAmount	float	是	2021-06-01 发布
39.3、金额名称	promotionOperation	String	是	2021-06-01 发布
39.4、金额统称	jointName	String	是	2021-06-01 发布
39.4、金额详情描述	detailDesc	String	是	2021-06-01 发布
39.4、促销满额减的品itemsId	itemIdList	List	是	如果是促销优惠，如满2件减10元，此字段显示本订单中参加此优惠的品id 2021-06-01 发布

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "withholding_money":1,
    "data": {
      
          }
      
  }

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权