尾程派送：追踪守护服务

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

字段	入参	说明
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	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	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支持的增值服务，如有其他增值需要，请详询客服

增值服务	增值含义	字段	入参
贴超重标签	针对超出15KG的包裹补贴超重标签	serviceCode	OSF8V1295
Last Mile Sign	最后一公里签收	serviceCode	OSF8V1439
打托后拍照	拍照节点：打托完成后拍照标准：将该订单的托盘集中拍照，全景照1张，单托拍照1张，托盘标签1张，托盘清单（若有）1张拍照数量：至少 3~4 张	serviceCode	OSF8V1582
交货时拍照	拍照节点：交货时/货物装车后拍照标准：将货物集中放置供应商车上（需要拍到车牌号）的全景照1张，供应商交货证明文件（若有）1张拍照数量：至少 1~2 张	serviceCode	OSF8V1583

"VASList": [
           {
                "serviceCode":"OSF8V1439"
            },{
                "serviceCode":"OSF8V1295"
            },{
                "serviceCode":"OSF8V1582"
            },{
                "serviceCode":"OSF8V1583"
            }
        ],

注意

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

贴欧代标签

贴商业发票

关键词