官方标签的tag_type为1, 只支持预定义好的tag_name, 每个标签的tag_value必须符合格式要求, tag_name和tag_value均不能自定义.
收货地址变更, 电子发票, 赠品, 预售, 指定快递, 换货, 恶意下单, 恶意退款, 虚拟订单, 全渠道分账, 全渠道O2O门店抢单, 全渠道菜鸟当日达, 门店发货, 发货时间承诺, 商品材质承诺, 商品破损承诺, 商品错漏发承诺共17个标签.
tag_value统一为JSON格式.
每个tag具体格式如下:
tag_value:
{
"giftList":[
{
"name":"xxx",
"num":1,
"remark":"xxx",
"outCode":"xxx"
},
{
"name":"xxx",
"num":1,
"remark":"xxx",
"outCode":"xxx"
}
]
}
JSON字段说明:
name:必传,礼品名称 num:必传,数量 remark:可选,备注 outCode:可选,外部商家编号
tag_value:
{
"eInvoiceList":[
{
"query":"xxx"
}
]
}
JSON字段说明:
query:必传,电子发票的查询方法说明
tag_value:
{
"receiverName": "xxx",
"receiverPhone": "123456789",
"receiverMobile": "13600000000",
"receiverState": "浙江",
"receiverCity": "杭州",
"receiverDistrict": "西湖区",
"receiverAddress": "xx路xx号",
"receiverZip": "310001",
"remark": "收货地址变更备注"
}
tag_value:
{
"list": [
{
"estimateDate": "2015-03-01",
oids: "12345,12346"
}
]
}
JSON字段说明:
estimateDate:必传,预售日期 oids:可选,子订单id列表,用逗号分隔
tag_value:
{
"company": "xxx"
}
JSON字段说明:
company:必传,快递公司名称
tag_value:
{
"swapGoods": [
{
"oid": 12345678,
"oldNum": 1,
"newItemId": 12345678,
"newSkuId": 12345678,
"newNum": 1,
"remark": "xxx"
}
]
}
JSON字段说明:
oid:必传,子订单id oldNum:必传,原商品数量 newItemId:必传,新商品Id newSkuId:当商品有Sku时,必传,否则,不能传 newNum:必传,新商品数量 remark:可选,备注
tag_value:
{
"remark": "xxx"
}
JSON字段说明:
remark:必传,说明备注
tag_value:
{
"refundId": 1234,
"remark": "xxx"
}
JSON字段说明:
refundId:必传,退款编号 remark:必传,说明备注
tag_value:
{
"oids": 1234,
"remark": "xxx"
}
JSON字段说明:
oids:可选,子订单id列表。如果没有子订单,则不用填 remark:可选,备注
tag_value:
{
"allocatePayment": 0
}
JSON字段说明:
allocatePayment: 必选, 值为0或1
tag_value:
{
"O2OShipFreeze": 0
}
JSON字段说明:
O2OShipFreeze: 必选, 值为0或1
tag_value:
{
"oneDayDelivery": 0
}
JSON字段说明:
oneDayDelivery: 必选, 值为0或1
tag_value:
{}//这个官方标签是没有内容的,因为tag_value是必填的,又必须是json格式的,所以空标签的tag_value必须为"{}"
tag_value:
{
"oidList": [
{
"oid": 111111,
"fromDate": "2016-02-28",
"toDate": "2016-02-29"
},
{
"oid": 222222,
"fromDate": "2016-02-29",
"toDate": "2016-03-01"
}
]
}
JSON字段说明:
oidList: 每个节点表示针对该子订单的商品做出的发货时间承诺,其中: oid: 子订单ID,非空 fromDate: 最早发货时间,非空,格式为yyyy-MM-dd toDate: 最晚发货时间,非空,格式为yyyy-MM-dd,如果fromDate和toDate相同,就是时间点,否则就是时间段,fromDate和toDate之间的时间间隔不得大于3天
tag_value:
{
"oidList": [
{
"oid": 111111,
"parts": [
{
"part": "桌面",
"material": "钢化玻璃"
},
{
"part": "桌腿",
"material": "金属"
}
]
},
{
"oid": 222222,
"parts": [
{
"part": "支架",
"material": "不锈钢"
}
]
}
]
}
JSON字段说明:
oidList: 每个节点表示针对该子订单的商品的每个部分的材质做出承诺,其中: oid: 子订单ID,非空 part: 商品的部位名称,非空 material: 部位材质的说明,非空
tag_value:
{
"oidList": [
{
"oid": 111111,
"effectiveDays": 3,
"compensation": "免费上门维修"
},
{
"oid": 222222,
"effectiveDays": 15,
"compensation": "包换"
}
]
}
JSON字段说明:
oidList: 每个节点表示针对该子订单的商品做出破损承诺,其中: oid: 子订单ID,非空 effectiveDays: 非空,整数,单位为天 compensation: 非空,表示商品出现破损之后的补偿措施
tag_value:
{
"oidList": [
{
"oid": 111111,
"effectiveDays": 3,
"accessories": "附属品列表",
"compensation": "免费补发"
},
{
"oid": 222222,
"effectiveDays": 3,
"accessories": "附属品列表",
"compensation": "免费换货"
}
]
}
JSON字段说明:
oidList: 每个节点表示针对该子订单的商品做出错漏发的承诺,其中: oid: 子订单ID,非空 effectiveDays: 非空,整数,单位为天 accessories: 为附属品列表,可选 compensation: 非空,表示商品出现错漏发之后的补偿措施
自定义的tag_type为2, 也是默认type.
每个标签的tag_value是JSON格式, tag_name和tag_value均可自定义.