eBay 怎么通过 API 上传产品？新手先做哪一步最省事？

你把 Excel 里的货号表翻到第三页，手指停在一个 Active 那一列上。表头改了名，模板还是老的，导入框弹出的报错你一个都不认识。屏幕上的红字闪了一下就没了。你把文件另存了一份，打算从头再导一遍。eBay 有几种上传方式，新手最容易选错，选对路径这活儿能从两天缩到两小时，第一步该点哪里？

一、eBay 如何通过 API 上传产品？

标准路径是走 Seller Hub 里的 File Upload，也就是用模板批量导入，这是绝大多数卖家说的 API 上传，也叫 Bulk Listing Tool。

真-API 是另一条路，用 GetItem、SetItem、AddFixedPriceItem 这些接口，把商品数据用 JSON 发给 eBay。这条路需要开发能力，签名、OAuth 令牌、错误码处理都要自己写。

中间还有 File Exchange，需要开通 eBay 的开发者账号才有权限，能把文件当成消息队列投递，适合数据量特别大的场景。

还有第三条路是第三方刊登工具，比如有专门的软件可以让你在界面上填表然后一键推送到eBay。它比写代码简单，比官方模板灵活，代价是每月上传量有上限，量大了还得转回官方渠道。

二、新手先做哪一步最省事？

第一次导入选 Add items only，不要勾选 revise。Add 是新增，Revise 是按已有 ItemID 覆盖，新号没 ItemID 选错这一项会整批失败。先下载官方模板，不要自己造表头。模板里的 ItemID、Title、Condition、Price、Quantity、Category 这些列的位置和命名都有严格要求，改名就报错。

导入前先做两步自查。类目 ID 用 eBay 的类目查找工具查，不要凭感觉填；标题里不能带电话、邮箱、外部链接，这三个是电商最常见的拒收原因。

ItemID这一列最容易被忽略。老品有ID的填上就是更新新品，没ID的留空才是新增。这个规则搞反，整批货会变成在改一个不存在的商品。

选好路径之后，先拿五到十条商品跑一遍完整的流程，确认类目、属性、运费都填对了，再动全量。这五分钟能省掉后面几小时的返工。

三、一次导入几百条失败了，怎么定位？

报错集中在几类：ITEM_NOT_FOUND 是 ItemID 不存在或写错；MISSING_ITEM_SPECIFIC 是必填属性没填；ENDPOINT_FAILURE 一般是格式问题，不是内容问题。先看上传结果文件。下载失败的那份，里面每一行都会写明错误代码和原因，比后台提示详细得多。

群友郗遥做露营灯串，第一次导入 300 条只成功 41 条，逐条看下来八成是漏填的品牌和灯泡型号这两个属性，补齐之后 280 条一次过，剩下的 20 条是类目给错了。

批量的做法是分批导入，每批 50 条。出了错你知道是哪一批，出对了也心里有底，不用每次都把全部数据重跑一遍。

价格列有三种模式：固定价、拍卖、或者刊登多个SKU共用一个ItemID。同一款不同颜色不同尺寸，正确做法是共用一个ItemID、拆成多个SKU，不要拆成多个独立商品。

四、什么时候该花钱上真正的 API？

一个硬指标：一周更新一次以上的商品，用模板导入就够用了，人工点两下比写代码快。

需要写接口的情况有三个：商品数量过万且每天改价、库存要跟 ERP 实时同步、要做的报表平台后台给不了。

真上 API 的时候，先只做一个动作，比如改价或者查订单，接口跑通了再往上加。一次写五个接口，出问题排查成本比写代码本身还高。

运费字段要填完整，包括运送到买家所在地的实际费用。运费没填或者填成零，买家结账时看到总价比他预期高，转化就掉在最后一步。

五、批量导入之后，怎么保证前台显示正常？

导入成功只是数据进库，前台展示还要经过审核和同步。少量刊登一般几分钟到几小时生效，大量刊登可能要一两天。

同步之后要做抽查。挑五个不同类目的商品，从买家视角打开看一遍，包括价格、运费、库存和变体选项。这一步花十分钟，能挡掉九成的低级错误。

另外确认店铺的物流方案和退货政策已经设置好。这两项缺失时，前台商品会因为缺少配送信息被隐藏，你这边看着是上架成功的。

群友阿望做手工香皂，批量导入了 200 条之后忘了填运费，前台整批商品两天都没露出来，第三天才发现，改完当天就全部上线。