文档中心 > 订单打标服务

订单打标说明

更新时间:2016/03/13 访问次数:9856

官方标签

概述

官方标签的tag_type为1, 只支持预定义好的tag_name, 每个标签的tag_value必须符合格式要求, tag_name和tag_value均不能自定义.

目前预定义好的官方标签

目前支持

收货地址变更, 电子发票, 赠品, 预售, 指定快递, 换货, 恶意下单, 恶意退款, 虚拟订单, 全渠道分账, 全渠道O2O门店抢单, 全渠道菜鸟当日达, 门店发货, 发货时间承诺, 商品材质承诺, 商品破损承诺, 商品错漏发承诺共17个标签.

标签格式

tag_value统一为JSON格式.

格式描述

每个tag具体格式如下:

tag_name: 赠品

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_name: 电子发票

tag_value:

{
    "eInvoiceList":[
        {
            "query":"xxx"
        }
    ]
}

JSON字段说明:

query:必传,电子发票的查询方法说明

tag_name: 收货地址变更

tag_value:

{
    "receiverName": "xxx",
    "receiverPhone": "123456789",
    "receiverMobile": "13600000000",
    "receiverState": "浙江",
    "receiverCity": "杭州",
    "receiverDistrict": "西湖区",
    "receiverAddress": "xx路xx号",
    "receiverZip": "310001",
    "remark": "收货地址变更备注"
}

tag_name: 预售

tag_value:

{
    "list": [
        {
            "estimateDate": "2015-03-01",
            oids: "12345,12346"
        }
    ]
}

JSON字段说明:

estimateDate:必传,预售日期 

  oids:可选,子订单id列表,用逗号分隔

tag_name: 指定快递

tag_value:

{
    "company": "xxx"
}

JSON字段说明:

company:必传,快递公司名称

tag_name: 换货

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_name: 恶意下单

tag_value:

{
    "remark": "xxx"
}

JSON字段说明:

remark:必传,说明备注

tag_name: 恶意退款

tag_value:

{
    "refundId": 1234,
    "remark": "xxx"
}

JSON字段说明:

refundId:必传,退款编号

  remark:必传,说明备注

tag_name: 虚拟订单

tag_value:

{
    "oids": 1234,
    "remark": "xxx"
}

JSON字段说明:

oids:可选,子订单id列表。如果没有子订单,则不用填

  remark:可选,备注

tag_name: 全渠道分账

tag_value:

{
    "allocatePayment": 0
}

JSON字段说明:

allocatePayment: 必选, 值为0或1

tag_name: 全渠道O2O门店抢单

tag_value:

{
    "O2OShipFreeze": 0
}

JSON字段说明:

O2OShipFreeze: 必选, 值为0或1

tag_name: 全渠道菜鸟当日达

tag_value:

{
    "oneDayDelivery": 0
}

JSON字段说明:

oneDayDelivery: 必选, 值为0或1

tag_name: 门店发货

tag_value:

{}//这个官方标签是没有内容的,因为tag_value是必填的,又必须是json格式的,所以空标签的tag_value必须为"{}"

tag_name: 发货时间承诺

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_name: 商品材质承诺

tag_value:

{
    "oidList": [
        {
            "oid": 111111,
            "parts": [
                {
                    "part": "桌面",
                    "material": "钢化玻璃"
                },
                {
                    "part": "桌腿",
                    "material": "金属"
                }
            ]
        },
        {
            "oid": 222222,
            "parts": [
                {
                    "part": "支架",
                    "material": "不锈钢"
                }
            ]
        }
    ]
}

JSON字段说明:

oidList: 每个节点表示针对该子订单的商品的每个部分的材质做出承诺,其中:
oid: 子订单ID,非空
part: 商品的部位名称,非空
material: 部位材质的说明,非空

tag_name: 商品破损承诺

tag_value:

{
    "oidList": [
        {
            "oid": 111111,
            "effectiveDays": 3,
            "compensation": "免费上门维修"
        },
        {
            "oid": 222222,
            "effectiveDays": 15,
            "compensation": "包换"
        }
    ]
}

JSON字段说明:

oidList: 每个节点表示针对该子订单的商品做出破损承诺,其中:
oid: 子订单ID,非空
effectiveDays: 非空,整数,单位为天
compensation: 非空,表示商品出现破损之后的补偿措施

tag_name: 商品错漏发承诺

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均可自定义.

FAQ

关于此文档暂时还没有FAQ
返回
顶部