API

增值服务参数说明

更新时间： 2025-10-30 18:20:09 访问次数：5155

尾程派送：追踪守护服务

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

字段	入参	说明
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_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将依据供应商账单线下补收
serviceCode	OSF8V1552	非标增值	客户如果需要额外提线下增值勾选此选项后，出库单将保持为“出库确认中”状态，等待客户在万邑联提交额外的非标增值订单才会将任务下发给仓库进行拣选操作

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

注意

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

贴欧代标签

贴商业发票

关键词