关于eDIS Open API新增CPSC相关接口及字段更新的通知
发布时间:2026-07-01
一直以来,eBay致力于为卖家提供稳定高效的平台化运营服务。为支持大中华地区SpeedPAK服务的CPSC(美国消费品安全委员会)监管商品合规信息管理,eDIS已更新其Open API,新增CPSC_profile接口,并更新[POST]/package、[GET]/package接口以支持CPSC相关信息及豁免类型,请各位开发者及时按照以下更新调整系统逻辑。
(1)API文档更新时间及注意事项
API文档将于近期上线,请及时关注。
注意:CPSC 进口监管新规将于 2026年7月8日 正式施行,请合理规划对接及上线排期。
(2)本次接口改动整体说明
改动接口范围:本次共涉及3个接口变更,新增1个/CPSC_profile接口,更新[POST]/package、[GET]/package 2个原有接口。
1. 新增 /CPSC_profile 接口
获取账号下所有CPSC资质信息列表。本接口返回的 cpscProfileId 可在创建包裹时关联对应SKU的CPSC资质。
请求示例:
GET https://api.ebay.com/sell/edelivery_international_shipping/v1/cpsc_profiles?offset=0&limit=20
请求参数:
// 页码偏移量,默认值:0 offset: integer; // 分页大小,默认值:20,最大值200 limit: integer;
响应示例:
{
"href": "https://api.ebay.com/sell/edelivery_international_shipping/v1/cpsc_profiles?offset=0&limit=20",
"next": "",
"prev": "",
"limit": 20,
"offset": 0,
"total": 2,
"profiles": [
{
"cpscProfileId": "CPSC_001",
"name": "Children Toy Safety Profile",
"type": "REF_PGA"
},
{
"cpscProfileId": "CPSC_002",
"name": "Electronic Product Full Profile",
"type": "FULL_PGA"
}
]
}
响应参数:
application/json
{
// 当前请求页跳转地址
href: string,
// 下一页跳转地址
next: string,
// 上一页跳转地址
prev: string,
// 当前分页大小
limit: integer,
// 页码偏移量
offset: integer,
// CPSC资质总数
total: integer,
// CPSC资质列表
profiles: {
// CPSC Id
cpscProfileId: string,
// CPSC名称
name: string,
// CPSC资质类型:REF_PGA - Reference PGA;FULL_PGA - Full PGA
type: string
}[]
}
2. [POST]/package 更新
SKU下新增两个字段:CPSC profile ID(cpscProfileId)和豁免类型(exemptionType),二者二选一,不可同时填写:
- 传cpscProfileId则关联已创建的CPSC信息;
- 传exemptionType则需选择对应豁免枚举值(参考附表1 豁免类型枚举值说明)。
重要提示:若商品属于CPSC Category且两个字段都不传,系统会报错,无法生成跟踪号和面单。
请求示例:
POST https://api.ebay.com/sell/edelivery_international_shipping/v1/package { "packageInfo": { "……" }, "items": […… "sku": { …… "skuNumber": "string", "tariffCode": "string", "weight": "number", "width": "number" "cpscProfileId": "CPSC_001", }, …… }, } }
请求参数:
{
// package information
……
// item information
……
// SKU information
sku: {
……
// SKU编号(SKU中有未传的必填字段时,会使用该预设SKU的信息)
skuNumber: string
// 关税代码
tariffCode: string
//※ 重量(单位:g)
weight: number
// 宽度(cm)
width: number
// 是否带锂电池(1.0版本)
isLiBattery: boolean
// CPSC Id(cpscProfileId 与 exemptionType 二选一,不可同时填写)
cpscProfileId: string
// CPSC豁免类型(cpscProfileId 与 exemptionType 二选一,不可同时填写)请参考ExemptionTypeEnum枚举值说明
exemptionType: enum[TOY_VINTAGE, TOY_ANTIQUE, TOY_AGE_LMT……]
}
}
响应示例:
{
"createPackageResult": {
"estimateCost": {
"currency": "CNY",
"value": "19.8748"
},
"packageId": "1666770281817702476",
"trackingNumber": "ES1002853394192000100000000N"
}
}
响应参数:
{
// 包裹信息
createPackageResult: {
// 预估运费金额
estimateCost: {
// 货币符号:CNY,HKD,TWD
currency: string;
// price金额
value: string;
}
// 尾程单号,仅特快服务返回
lastMileTrackingNumber: string;
// 包裹ID
packageId: string;
// 支付金额,仅特快服务返回
paymentCost: {
// 货币符号:CNY,HKD,TWD
currency: string;
// price金额
value: string;
}
// 包裹跟踪号
trackingNumber: string;
}
}
3. [GET]/package 更新
调用该接口通过包裹ID查询详情时,会返回该包裹对应的CPSC ID或豁免信息。
请求示例:
GET https://api.ebay.com/sell/edelivery_international_shipping/v1/package/{package_id}
请求参数:
{package_id}:此路径参数指定正在检索的包的唯一标识符。当通过createppackage方法创建包时返回此ID值。
响应示例:
{
"packageDetail": {
……},
"items": [……
"sku": {
……
"skuNumber": "",
"tariffCode": "",
"weight": 50.0,
"width": 50.0,
"isLiBattery": false
"cpscProfileId": "CPSC_001",
……
}
}
响应参数:
{
// package information
……
// item information
items: {
……
// SKU information
sku: {
……
// SKU编号
skuNumber: string
// 关税代码
tariffCode: string
// 重量(单位:g)
weight: number
// 宽度(cm)
width: number
// 是否带锂电池(1.0版本)
isLiBattery: boolean
// CPSC Id
cpscProfileId: string
// CPSC豁免类型 请参考ExemptionTypeEnum枚举值说明
exemptionType: enum[TOY_VINTAGE, TOY_ANTIQUE, TOY_AGE_LMT……]
}
……
(3)ExemptionType豁免类型枚举值说明
附表:豁免类型枚举值明细
| 枚举值 | 分类 | 中文描述 | 英文描述 |
|---|---|---|---|
| TOY_VINTAGE | 玩具类 | 复古 | Exemption option for vintage toy |
| TOY_ANTIQUE | 玩具类 | 古董 | Exemption option for antique toy |
| TOY_AGE_LMT | 玩具类 | 年龄 > 13 | Exemption option for toy intended for users over certain age |
| ADULT_PRODUCT_USED | 成人产品 | 二手 | Exemption option for used adult product |
| ADULT_APPAREL_SYNTHETIC_OR_WOOL | 成人服装 | 材料包括腈纶、改性腈纶、尼龙、聚酰胺、烯烃、聚丙烯、羊毛、羊绒或聚酯纤维 | Exemption option for adult apparel with material includes acrylic, modacrylic, nylon, polyamide, olefin, polypropylene, polyester, wool, cashmere, OR polyester |
| ADULT_APPAREL_COTTON_100 | 成人服装 | 棉(100%) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Cotton (100%) |
| ADULT_APPAREL_COTTON_BLENDS | 成人服装 | 棉混纺(任何棉混纺) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Cotton Blends (any cotton mix) |
| ADULT_APPAREL_RAYON_VISCOSE_100 | 成人服装 | 人造丝/粘胶(100%) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Rayon/Viscose (100%) |
| ADULT_APPAREL_MODAL | 成人服装 | 莫代尔 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Modal |
| ADULT_APPAREL_BAMBOO | 成人服装 | 竹纤维(人造丝型) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Bamboo (rayon type) |
| ADULT_APPAREL_LINEN_FLAX | 成人服装 | 亚麻/亚麻布 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Linen/Flax |
| ADULT_APPAREL_SILK | 成人服装 | 丝绸(所有形式, 100%丝绸) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Silk (all forms, 100% silk) |
| ADULT_APPAREL_ACETATE | 成人服装 | 醋酸纤维 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Acetate |
| ADULT_APPAREL_SPANDEX_ELASTANE | 成人服装 | 氨纶/弹性纤维(单独) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Spandex/Elastane (alone) |
| ADULT_APPAREL_NYLON_SPANDEX_BLENDS | 成人服装 | 尼龙/氨纶混纺 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Nylon/Spandex blends |
| ADULT_APPAREL_POLYESTER_SPANDEX_BLENDS | 成人服装 | 聚酯/氨纶混纺 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Polyester/Spandex blends |
| ADULT_APPAREL_POLYESTER_RAYON_BLENDS | 成人服装 | 涤纶/人造丝混纺 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Polyester/Rayon blends |
| ADULT_APPAREL_WOOL_BLENDS | 成人服装 | 羊毛混纺(含非豁免纤维) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Wool blends (with non-exempt fiber) |
| ADULT_APPAREL_CASHMERE_BLENDS | 成人服装 | 羊绒混纺(含非豁免纤维) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Cashmere blends (with non-exempt fiber) |
| ADULT_APPAREL_LINEN_BLENDS | 成人服装 | 亚麻混纺 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Linen blends |
| ADULT_APPAREL_MODAL_BLENDS | 成人服装 | 莫代尔混纺 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Modal blends |
| ADULT_APPAREL_SATIN | 成人服装 | 缎面(纤维未知) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Satin (fiber unknown) |
| ADULT_APPAREL_CHIFFON | 成人服装 | 雪纺(纤维未知) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Chiffon (fiber unknown) |
| ADULT_APPAREL_LACE | 成人服装 | 蕾丝(纤维未知) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Lace (fiber unknown) |
| ADULT_APPAREL_TULLE | 成人服装 | 薄纱(纤维未知) | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Tulle (fiber unknown) |
| ADULT_APPAREL_VOILE | 成人服装 | 巴里纱 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Voile |
| ADULT_APPAREL_ORGANZA | 成人服装 | 欧根纱 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Organza |
| ADULT_APPAREL_GEORGETTE | 成人服装 | 乔其纱 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Georgette |
| ADULT_APPAREL_CREPE | 成人服装 | 绉纱 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Crepe |
| ADULT_APPAREL_TWILL | 成人服装 | 斜纹 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Twill |
| ADULT_APPAREL_JERSEY | 成人服装 | 针织物 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Jersey |
| ADULT_APPAREL_OXFORD_CLOTH | 成人服装 | 牛津布 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Oxford Cloth |
| ADULT_APPAREL_MESH_NET | 成人服装 | 网状/网 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Mesh/Net |
| ADULT_APPAREL_GAUZE | 成人服装 | 纱布 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Gauze |
| ADULT_APPAREL_CANVAS | 成人服装 | 帆布 | Exemption option for adult apparel with fabric weight ≥ 2.6oz/yard AND fabric type is Canvas |
| OTHER_ADULT_PRODUCT | 其他 | 其他成人产品 | Exemption option for other Adult Product |
(4)API文档链接
• 接口文档(英文版):https://developer.ebay.com/api-docs/sell/edelivery_international_shipping/overview.html
• 接口文档(中文版):https://edis.ebay.com/new-api-document-detail
如有其他问题,可联系 dl-ebay-edis-api@ebay.com
2026年6月30日








