eDIS OpenAPI 接口更新通知

发布时间:2026-10-16

 

为满足欧盟法规对产品标识符（Product Identifier，PID）信息的要求，并符合 API 接口合规规范，eDIS Open API 将于 2026年10 月 28 日正式上线欧盟商品标识 PID 字段，同时根据合规要求更新了相关字段的枚举值，具体如下。如有任何问题，请联系 eDIS 技术支持：DL-eBay-EDISSupportGroup@ebay.com。

接口文档请登录eDIS开发者平台查看：https://edis.ebay.com/openapi-doc/new-api-document-detail.html

 

1.  新增欧盟PID相关字段additionalSkuInfo: 

为满足欧盟新规对商品产品标识符（Product Identifier，PID）的申报要求，本次 eDIS Open API 更新将针对欧盟路向商品新增以下三个属性，请相关对接方尽快完成接口调整。

 

属性名称 是否必填 中文释义 英文释义
MPID 否 商家产品标识符 Merchant Product Identifier
NSPID 否 非标准化制造商产品标识符 Non-Standardized Product Identifier
SPID 否 标准化制造商产品标识符 Standardized Product Identifier

 

示例： 

sku:
{additionalSkuInfo：
[{"name":"MPID","value":"20260929001001"}, 
 {"name":"NSPID","value":"MODEL-2026-V3"}, 
 {"name":"SPID","value":"8901234567890"}]
}

注：若此三个字段留空，OC将使用刊登商品中所包含的相关商品属性值进行申报。

 

2.  接口字段枚举值更新：

本次更新将对包裹状态/ 交运方式/ 申诉类型/ 带电类型/贸易条款(Incoterms Type)/ 地址类型/揽收时间段接口枚举值进行调整，相关更新内容汇总如下，具体字段说明请参考接口文档。

 

No 枚举中文名 枚举英文名 涉及接口 枚举值数量 主要变更说明
1 包裹状态 PackageStatus GET /package/{order_line_item_id}/item 17个 接口与SDK命名统一，如旧接口 DECLARED_FAILED → 新 PREDECLARATION_FAILED
GET /package/{package_id}
2 交运方式 ConsignType GET /consign_preference 7个 枚举名保持一致，接口与SDK已统一，无命名差异
POST /consign_preference
3 申诉类型 ComplaintType POST /complaint 2个 旧接口 ABNORMAL_COLLECTION_COMPLAINT → 新 ABNORMAL_PICKUP_COMPLAINT
4 带电类型 LiBatteryType GET /battery_qualifications 7个 旧SDK DRY_PACKED_WITH_EQUIPMENT → 新 DRY_BATTERY_PACKED_WITH_EQUIPMENT
POST /package
GET /package/{package_id}
5 贸易条款 IncotermsType POST /package 2个 DDP（卖家承担关税）/ DDU（买家承担关税），接口与SDK统一
GET /package/{package_id}
6 地址类型 AddressType GET /address_preference 2个 枚举名接口与SDK已统一，无命名差异
POST /address_preference
7 揽收时间段 PickUpTimeType GET /consign_preference 2个 TIME_14_16 / TIME_16_18，接口与SDK已统一
POST /consign_preference

适配说明如下：

● POST 接口：继续兼容旧枚举值，现有调用方式不受影响；

● GET 接口：返回值已切换为新枚举值，请相关对接方尽快完成适配。