卖家中心API上传商品操作指引

沃尔玛美国站API上传商品操作指引

创建API集成

沃尔玛电商平台API帮助卖家生成应用程序，用于管理他们在沃尔玛平台上的商品、订单、价格、促销、库存和报告。请访问沃尔玛开发者中心，来了解API集成所需的所有信息。

沃尔玛电商平台API包含两个组合：

Item API：用于提交、更新和下架商品

Transaction API：用于更新价格、库存和管理订单

API被设计采用REST标准，旨在生成面向资源的可预测URL，并使用HTTP响应代码来指示API错误。

1.API概览

API流程一览

（1）阅读沃尔玛开发者中心的API文档

（2）在卖家中心上生成您的凭证（Consumer ID and Private Key）

（3）创建和测试您的代码，让您的认证和交易代码（包括错误处理）发挥作用

（4）确保您的代码与您的系统集成良好

（5）认证您的代码，并使其开始运行

语言

我们的API规范是语言中立的。我们同时还支持使用Java集成的卖家。如果您使用其他语言，可能无法就此获得支持。

XML验证

如API文档中所述，您应使用沃尔玛XSD的XML验证器来验证您的XML。对于格式不正确的XML（或XML中的无效值），从WMP返回的信息可能不像您从XML验证程序获得的信息那样具有描述性。

凭证

点击卖家中心页面顶部的齿轮图标，生成您的凭证。然后从“General Settings”菜单中选择“Consumer IDs & Secret Keys”。

注：复制和粘贴凭证时要注意! 如果加入了任何额外的字符（包括空格），凭证将无法使用。如果您已经有凭证，生成一组新的凭证会使您现有的凭证无效。

测试值

这些字段在XSD中定义为必填、建议填写或选填。请务必创建包含适当标题、详细和简短描述及税码的真实商品记录（即使是测试商品）。

2.API创建

如果您想使用我们的REST API来管理您的业务，您需要 Client ID 和 Client Secret 来访问API。您可以在Developer Portal生成这些API凭证。您还需要 Channel Type 的标头值来向API发送信息。

（1）在Seller Center右上角的Settings选择API下的API Key Management（API密钥管理），访问Seller Center 的Developer Portal。

注：管理员应该会看到这整个菜单。如果您没有看到API这个部分，可能是因为您没有管理员权限

（2）使用Seller Center凭证，自动登录到Developer Portal。您还可以选择Quick Links（快速链接）标题下的链接，访问各种文档。或者您可以直接访问Developer Portal，并登录系统。

（3）如想再次查看您的密钥，需要点击“Regenerate Key”按钮以重新生成。

3.在Developer Portal上生成凭证

（1）在Developer Portal上点击右上角 My Account（我的账户）， Login Type（登录类型）选择 Marketplace (US & Mexico) （平台（美国和墨西哥）)。 

您的登录详情与Seller Center凭证相同。

（2）在接下来出现的页面中，您可生成您的API凭证（Client ID和Client Secret）。 

（3）请使用上一步中获取的密钥，并利用TOKEN API（令牌API）获得短期令牌。该令牌的生命期有效期为15分钟，超时后须重新生成。

（4）使用API文档中所列的标题，验证您的API调用。所有API调用都须设置标题，以验证和授权合作伙伴。 

注：API可能需要设置额外的标题 

4.代理访问权限——服务商授权

Walmart Developer Center提供代理委派访问权限授权功能，您可以通过此功能为每个服务商创建单独的代理委派访问权限。通过代理访问权限，您可以管理您的API密钥，并向服务商提供特定服务（内容、商品设置、订单管理等）的访问权限。

代理访问权限可帮助卖家： 

（1）确定各提供商服务商可访问的功能。

（2）轻松查看所有服务商的访问权限级别。

（3）根据服务商的角色，撤销或调整其访问权限。

（4）重置服务商的客户端密码。重置客户端密码只会对有关用户有影响。

（5）服务商并无Developer Portal的登录访问权限，且需向相关卖家获取API凭证据。 

只有已经与平台卖家签署合同的沃尔玛认可服务商才有资格获得代理访问权限。若您的服务商不在 Delegated Access （代理访问权限）列表中，则其应先申请成为沃尔玛的服务商。

注：沃尔玛平台现已发布Order API的更新版本，为我们所有已完成集成的合作伙伴提供更好的体验。

5.V3新版本Order Management APIs提供以下优势

（1）必填改为选填：有卖家反馈沃尔玛要求卖家提供过多不必要的属性。以下属性现已改为选填，以帮助卖家更简单快捷地进行集成：

     ·  退款过程中的税务信息：提交退款后，税款现已改为可选。 

    ·  退款ID：提交退款时，无须再填写退款ID 

    ·  退款备注：提交退款时，无须再填写备注。 

（2）附加属性：沃尔玛API添加了一些附加属性，以帮助卖家准确交付并进行适当的卖家记分卡报告。下列属性已添加至Order API： 

     ·  预计发货日期：预计卖家发出商品的日期。 

    ·  取消原因代码：您现在可以提交取消原因，例如“由合作伙伴取消”或“由顾客发起的取消”。这将帮助我们更好地了解订单取消的原因。