zzxworld

Amazon SP-API 卖家接口对接指北

工作需求,最近开始折腾亚马逊的新卖家接口。亚马逊老的卖家接口叫 MWS(Marketplace Web Service),基于 XML 格式,已经确定要在 2024 年终止服务。替换它的是使用 JSON 格式的新接口 SP(Selling Partner)-API。

几年前对接亚马逊的 MWS 老接口时非常简单,直接用卖家账号登录后台,复制接口需要的密钥就可以开始调用接口。但如今这个 SP 新接口变得麻烦了许多。

同样还是用卖家账号登录后台,但首先需要通过开发人员信息审核。在填写审核申请时,需要根据需求选择接口类型。这里面比较麻烦的点是亚马逊把部分接口做了限制,对于涉及到隐私信息的接口,定为了 「PII」类型。申请这类接口需要填写二十多项系统安全方面的报告,以供审阅。内容涉及对接系统的架构安全,数据安全和加密保障;组织结构和流程机制的安全防范等。这些东西对于不想使用第三方管理软件,只是想对接到自己 ERP 系统的中小卖家来说,非常不贴合实际。如果完全按那些提问中的要求来改造系统,那得成立一支专门的 IT 团队。

退而求次的办法是不申请哪些 PII 级别的接口。这对于一些业务处理来说会比较麻烦,比如自发货订单。自发货订单需要从订单接口获取客户的收货信息。很不幸,这涉及到客户隐私,需要通过 PII 级别的审核。这就逼的你只能选择使用亚马逊的 FBA 仓库来发货。或者订单量不大的情况下使用人力复制粘贴的方式来解决。或者更进一步,做一个浏览器插件,让这个复制粘贴的效率更高一点。

搞定了开发人员资格后,接下来需要去注册一个海外版的 AWS 账号。说起来是毫无门槛的免费注册,但事实上需要一张双币信用卡才行,会扣 1 美元左右来完成账号注册。完成注册后,在 AWS 上的流程分为以下几步:

  1. 创建 IAM 用户。
  2. 创建 IAM 安全策略。
  3. 创建 IAM 角色。
  4. 创建 IAM 用户的密钥和访问令牌,以供后续接口调用。

这一系列创建 IAM 信息的操作都只是用来作为调用 SP 接口的外围入口凭证。安全是安全了,但不得不说,过程真是麻烦。关于在 AWS 上的操作可以参考这篇中文版本的官方博客文章:如何对接亚马逊电商 Selling Partner API

完成 AWS 上的操作后,最后就是回到亚马逊卖家中心,在开发中心页面创建一个应用,然后给对应的店铺授权并拿到相应的刷新令牌(Refresh token)和应用 ID 等信息即可。这里唯一要注意的是创建应用时,会需要提供 IAM ARN 信息,这个信息来自上面创建 AWS 的过程。它有两种:用户类型和角色类型的,在 AWS 上创建的用户或角色信息中可以找到,复制过来即可。理论上来说是可以直接用用户的 ARN,这样在接口调用时少一次 STS 鉴权的调用。但我下载的一个 SDK 默认会使用 STS 接口,所以只能选择使用角色的 ARN。如果你也准备在后续业务中使用 SDK 来调用 SP 接口,那就直接使用角色的 ARN 吧。

以上算是完成了亚马逊 SP 接口的准备工作,一切正常的话,就可以开始使用 SP 接口来处理业务了。目前我正在了解亚马逊产品上架的流程和接口,折腾成功了再来分享一篇相关的文章。经历了这次亚马逊的流程,感觉还是 eBay 的接口用起来更方便。

6 条评论

  1. wu先生
    就算是技术文,我也要评论一下。哈哈。
    • zzxworld
      就算评论和内容无关,也让我感受到文章有人看的鼓舞。😊
  2. 小飞
    朋友你有联系方式吗?想请教你关于亚马逊api的问题
    • zzxworld
      可以直接评论留下你的问题,我看到了会回复。或者翻到第一篇文章,有我的微信二维码。不过不保证能解答你的问题,我也只对接了一些常用接口。
  3. 隔壁老王
    学到了,感谢感谢
    • zzxworld
      客气了,有帮助就好。