API

增值服务参数说明

更新时间： 2025-06-05 17:30:50 访问次数：4446

尾程派送：追踪守护服务

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF777778	增值产品，固定入参
attrCode	ISA	增值传参字段，固定入参
attrValue	投保金额	RMB，货币单位默认CNY，1-10000之间注：不同产品渠道可投保金额不一致，可查询通过接口queryDeliveryWay查询出参中的minValue和maxValue

"VASList": [
             {
                "serviceCode":"OSF777778",
                "attrList":[
                    {
                        "attrCode":"ISA",
                        "attrValue":"100"
                    }
                ]
            }
        ],

尾程保险：物流保险

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1464	增值产品，固定入参
attrCode	LPIA	物流商投保金额属性编码，固定入参
attrValue	物流商投保金额	货币单位默认发货仓所在国家币种

 "VASList":[
            {
                "serviceCode":"OSF8V1464",
                "attrList":[
                    {
                        "attrCode":"LPIA",
                        "attrValue":"1234"
                    }
                ]
            }
        ]

尾程保险：UPS Capital

由UPS Capital提供的尾程保险服务，如货物在运输途中发生丢失或破损支持按标准向UPS Capital索赔。

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1498	增值产品，固定入参
attrCode	ISA	增值传参字段，固定入参
attrValue	投保金额	USD ，货币单位默认USD，投保金额>99.99 并且小于等于5000

"VASList": [
             {
                "serviceCode":"OSF8V1498",
                "attrList":[
                    {
                        "attrCode":"ISA",
                        "attrValue":"100"
                    }
                ]
            }
        ],

订单出库加包装

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF24WW008	增值产品，固定入参
attrCode	PACKAGE_MODE	增值传参字段，固定入参
attrValue	出库加包装 PACKAGING_WINIT：WINIT标准包装 PACKAGING_CUSTOMER：客制包装
attrCode	PACKAGE_TYPE_MATERIAL	增值传参字段，固定入参
attrValue	包材类型 COURIER_SATCHEL：快递袋 PADDED_ENVELOPE：气泡袋 CARTON_BOX：纸箱
attrCode	PACKAGE_MERCHANDISE_CODE	增值传参字段，固定入参
attrValue	包材商品编码，仅支持客制包装时指定

"VASList":[
        {
            "serviceCode":"OSF24WW008",
            "attrList":[
                {
                    "attrCode":"PACKAGE_MODE",
                    "attrValue":"PACKAGING_WINIT"
                },
                {
                    "attrCode":"PACKAGE_TYPE_MATERIAL",
                    "attrValue":"CARTON_BOX"
                }
            ]
        }
    ]

"VASList":[
        {
            "serviceCode":"OSF24WW008",
            "attrList":[
                {
                    "attrCode":"PACKAGE_MODE",
                    "attrValue":"PACKAGING_CUSTOMER"
                },
                {
                    "attrCode":"PACKAGE_TYPE_MATERIAL",
                    "attrValue":"CARTON_BOX"
                },
                {
                    "attrCode":"PACKAGE_MERCHANDISE_CODE",
                    "attrValue":"test01"
                }
            ]
        }
    ]

订单出库加卡片

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1670	增值产品，固定入参
attrCode	增值服务属性编码	CARD_INFO_LIST：卡片信息 CARD_CODE：卡片在WINIT注册的商品编码 CARD_QTY：出库的卡片数量
attrValue	增值服务属性值	当属性编码为CARD_INFO_LIST，attrValue为数组，存在多个数组，数组里含2个对象，对象字段值为attrCode,attrValue，见入参示例。当属性编码为CARD_CODE，填相应的商品编码当属性编码为CARD_QTY，填相应的商品数量

"VASList": [
            {
                "serviceCode": "OSF8V1670",//增值服务编码 
                "attrList": [
                    {
                        "attrCode": "CARD_INFO_LIST",//卡片信息
                        "attrValue": [
                            [
                                {
                                    "attrCode": "CARD_CODE",
                                    "attrValue": "CARD001"//卡片编码
                                },
                                {
                                    "attrCode": "CARD_QTY",
                                    "attrValue": "10" //卡片数量
                                }
                            ],
                            [
                                {
                                    "attrCode": "CARD_CODE",
                                    "attrValue": "CARD002"//卡片编码
                                },
                                {
                                    "attrCode": "CARD_QTY",
                                    "attrValue": "10"//卡片数量
                                }
                            ]
                        ]
                    }
                ]
            }
        ]

订单指定日期出库

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSFV0002	增值产品，固定入参
attrCode	EVENT04	增值传参字段，固定入参
attrValue	指定日期

"VASList": [
             {
                "serviceCode": "OSFV0002",
                 "attrList": [
                    {
                        "attrCode": "EVENT04",
                        "attrValue": "2023-01-18"
                    }
                ]
            }
        ],

订单出库组套

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1284	增值产品，固定入参
attrCode	GROUP_REL	增值传参字段，固定入参
attrValue	组套编码

"VASList": [
             {
                "serviceCode":"OSF8V1284",
                "attrList":[
                    {
                        "attrCode":"GROUP_REL",
                        "attrValue":"GS00000369"
                    }
                ]
            }
        ],

加快派送

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1473	增值产品，固定入参
attrCode	SPECIFIED_TIME	增值传参字段，固定入参
attrValue	指定派送时间	MORNING：上午 NOON：中午 NO_LIMIT：不限

"VASList": [
             {
                "serviceCode":"OSF8V1473",
                "attrList":[
                    {
                        "attrCode":"SPECIFIED_TIME",
                        "attrValue":"MORNING"
                    }
                ]
            }
        ],

代理出口清关

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1555	增值产品，固定入参
attrCode	增值服务属性编码	TRADE_METHOD：贸易方式 SENDER_VAT_NO：发件人VAT RECEIVER_VAT_NO：收件人VAT
attrValue	增值服务属性值	当属性编码为 “TRADE_METHOD”时属性值填写： FOB/CIF/EXW/DDP/DAP/CFR 当属性编码为”SENDER_VAT_NO “时属性值填写：发件人的VAT号当属性编码为”RECEIVER_VAT_NO “时属性值填写：收件人的VAT号

"VASList": [
             {
                "serviceCode": "OSF8V1555",
                "attrList": [
                    {
                        "attrCode": "TRADE_METHOD",
                        "attrValue": "FOB"
                    },
                    {
                        "attrCode": "SENDER_VAT_NO",
                        "attrValue": "vat1"
                    },
                    {
                        "attrCode": "RECEIVER_VAT_NO",
                        "attrValue": "vat2"
                    }
                ]
            }
        ],

贴商品标签

入参需要增加以下字段，详情参考示例。

注：增值服务对应的附件需通过出库上传附件的接口上传，查看接口文档

字段	入参	说明
serviceCode	OSF8V1294	增值产品，固定入参
attrCode	增值服务属性编码	OPERATE_METHOD：操作方式 SIZE_SPECIFICATION：尺寸规格 MERCHANDISE_LABEL_LIST：商品标签清单
attrValue	增值服务属性值	1. 当”attrCode”为”OPERATE_METHOD”时，按如下规则填写： 6,9,15：贴标/覆盖原标签/1个标签（默认传值） 2. 当”attrCode”为”SIZE_SPECIFICATION”时，按如下规则填写： 103,105：热敏纸/10cm6cm 103,106：热敏纸/5cm2.5cm 3. 当”attrCode”为”MERCHANDISE_LABEL_LIST”时，按如下规则填写： attrValue为数组，数组存在多个数组，数组里含三个对象，对象字段值为attrCode,attrValue 商品编码attrCode固定传”MERCHANDISE_CODE”，规格attrCode固定传”SPECIFICATION”，商品标签文件名attrCode固定传”FILE_NAME”（仅支持一个标签一个文件），该名称请与上传附件接口中保持一致

{
        "VASList": [
                {
                        "serviceCode": "OSF8V1294",
                        "attrList": [
                                {
                                        "attrCode": "OPERATE_METHOD",
                                        "attrValue": "6,9,15"
                                },
                                {
                                        "attrCode": "SIZE_SPECIFICATION",
                                        "attrValue": "103,105"
                                },
                                {
                                        "attrCode": "MERCHANDISE_LABEL_LIST",
                                        "attrValue": [
                                                [
                                                        {
                                                                "attrCode": "MERCHANDISE_CODE",
                                                                "attrValue": "Blobby1"
                                                        },
                                                        {
                                                                "attrCode": "SPECIFICATION",
                                                                "attrValue": "A"
                                                        },
                                                        {
                                                                "attrCode": "FILE_NAME",
                                                                "attrValue": "merchdiseLabel_001"
                                                        }
                                                ]
                                        ]
                                }
                        ]
                }
        ]
}

贴包裹标签

入参需要增加以下字段，详情参考示例。

字段	入参	说明
serviceCode	OSF8V1303	增值产品，固定入参
attrCode	增值服务属性编码	PACKAGE_LABEL_CODE：包裹标签号
attrValue	增值服务属性值	当”attrCode”为”PACKAGE_LABEL_CODE”时，填写对应的包裹标签号

{
        "VASList": [
                {
                        "serviceCode": "OSF8V1303",
                        "attrList": [
                                {
                                        "attrCode": "PACKAGE_LABEL_CODE",
                                        "attrValue": "xxxx"// 包裹标签号
                                }
                        ]
                }
        ]
}

其他包裹标签或文件

入参需要增加以下字段，详情参考示例。

注：增值服务对应的附件需通过出库上传附件的接口上传，查看接口文档

字段	入参	说明
serviceCode	OSF8V1549	增值产品，固定入参
attrCode	增值服务属性编码	OPERATE_METHOD：操作方式 SIZE_SPECIFICATION：尺寸规格 FILE_TYPE：文件类型
groupSeq	分组标识	增值和增值之间，需要保持唯一增值内，属性+文件维度保持唯一
attrValue	增值服务属性值	当”attrCode”为”FILE_TYPE”时，按如下规则填写：默认填写”OTHER_LABEL_ALL_SAME” （释义：标签文件全部相同）当”attrCode”为”SIZE_SPECIFICATION”时，按如下规则填写： 110,111 ：热敏纸/10cm6cm 110,112 ：热敏纸/10cm15cm 117,118 ：普通打印纸/A4(黑白) 当”attrCode”为”OPERATE_METHOD”时，按如下规则填写： 23,24,30：贴标/贴最大面/1个标签 23,25,31 ：贴标/贴最小面/1个标签 23,29,39 ：贴标/不同面,底部不贴/5个标签 40,41,42 ：放置货物内/放置包裹内/一个标签


{
        "VASList": [
                {
                        "serviceCode": "OSF8V1549",
                        "attrList": [
                                {
                                        "attrCode": "OPERATE_METHOD",
                                        "attrValue": "23,24,30",
                                        "groupSeq": "OSF8V1549_1"
                                },
                                {
                                        "attrCode": "SIZE_SPECIFICATION",
                                        "attrValue": "110,112",
                                        "groupSeq": "OSF8V1549_1"
                                },
                                {
                                        "attrCode": "FILE_TYPE",
                                        "attrValue": "OTHER_LABEL_ALL_SAME",
                                        "groupSeq": "OSF8V1549_1"
                                },
                                {
                                        "attrCode": "OPERATE_METHOD",
                                        "attrValue": "23,24,30",
                                        "groupSeq": "OSF8V1549_2"
                                },
                                {
                                        "attrCode": "SIZE_SPECIFICATION",
                                        "attrValue": "110,112",
                                        "groupSeq": "OSF8V1549_2"
                                },
                                {
                                        "attrCode": "FILE_TYPE",
                                        "attrValue": "OTHER_LABEL_ALL_SAME",
                                        "groupSeq": "OSF8V1549_2"
                                }
                        ]
                }
        ]
}

其他增值

以下列举部分API支持的增值服务，如有其他增值需要，请详询客服

字段	入参	增值服务产品	说明
serviceCode	OSF8V1295	贴超重标签	针对超出15KG的包裹补贴超重标签
serviceCode	OSF8V1439	Last Mile Sign	最后一公里签收
serviceCode	OSF8V1582	打托后拍照	拍照节点：打托完成后拍照标准：将该订单的托盘集中拍照，全景照1张，单托拍照1张，托盘标签1张，托盘清单（若有）1张拍照数量：至少 3~4 张
serviceCode	OSF8V1583	交货时拍照	拍照节点：交货时/货物装车后拍照标准：将货物集中放置供应商车上（需要拍到车牌号）的全景照1张，供应商交货证明文件（若有）1张拍照数量：至少 1~2 张
serviceCode	OSF8V1684	时效保Lite
serviceCode	OSF8V1683	时效宝Premium
serviceCode	OSF8V1682	标准时效保障
serviceCode	OSF8V1459	垫付关税	发件人垫付关税，由此产生的关税和垫付关税手续费，Winit将依据供应商账单线下补收

"VASList": [
           {
                "serviceCode":"OSF8V1439"
            },{
                "serviceCode":"OSF8V1295"
            },{
                "serviceCode":"OSF8V1582"
            },{
                "serviceCode":"OSF8V1583"
            },{
                "serviceCode":"OSF8V1684"
            },{
                "serviceCode":"OSF8V1683"
            },{
                "serviceCode":"OSF8V1682"
            },{
                "serviceCode":"OSF8V1459"
            }
        ],

注意

以下增值暂不支持API对接，如有需要请在万邑联下单，谢谢配合

贴欧代标签

贴商业发票

关键词