关于eDIS Open API新增CPSC相关接口及字段更新的通知

一直以来,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玩具类年龄 > 13Exemption 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日