亚马逊SPAPI的PII权限的使用指南

原创已于 2024-10-31 20:12:42 修改

· 5.9k 阅读

2 ·

版权

文章标签：

#spapi #amazon #PII

于 2021-08-30 17:58:32 首次发布

SP-API 专栏收录该内容

3 篇文章

订阅专栏

本文介绍了亚马逊SP-API中的PII权限申请、解析及其调用方式。申请PII权限需提供额外数据使用和安全控制信息，涉及的API调用需使用Restricted Data Token (RDT)。详细阐述了Orders、Shipping、Merchant Fulfillment和Reports等API在PII权限下的操作，并提供了相关文档和代码示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.前言

Amazon于2020年10月推出了新的AGS（Amazon Global Selling）的api管理方案叫Selling Partner API，简称SP-API，用于替代MWS API方案。在业务API中，有些API所涉及的数据关系到卖家及买家的个人身份隐私数据，Amazon为了符合各国的数据安全保护规定以及 Acceptable Use Policy and Data Protection Policy的规定，所以将涉及隐私数据的API的权限归类为PII(Personally Identifiable Information)权限，此权限的申请审核以及相关的API的调用方式都于其他API不太一样，下面做个详细的说明。

2.申请

申请的位置，在My Developer Profile填写开发者资料时，在选择Roles时，有段红色的Note: Restricted roles contain Personally Identifiable Information (PII) about Amazon Buyers, and you will be required to provide additional information about your data use and security controls.以及下面highlight了(Restricted)的三个权限即为PII权限，申请PII权限需要提交更多的资料(资料填写要慎重，目前申请比较难)。
developer roles

3.解析

PII权限的解释请看这里，里面解释了三个PII权限的意思及涉及的API
PIIRole

3.调用方式

1.PII权限相关的API调用需要使用到Restricted Data Token (RDT)
2.以下是获取RDT的文档及Use-Case文档
Tokens API Reference - This is a new reference for the Tokens API and includes the operations for the new access protocol (RDT).
Tokens API Model – This swagger model describes the operations you can use in the Tokens API.
Tokens API Use Case Guide - This is a new guide describing the new access protocol for the Direct-to-Consumer Fulfillment, Tax, Shipping, and Reports use cases.
3.需要使用RDT的API
- Orders
  - getOrderBuyerInfo
  - getOrderAddress
  - getOrderItemsBuyerInfo
- Shipping
  - getShipment
- Merchant Fulfillment (MFN)
  - getShipment
  - cancelShipment
  - cancelShipmentOld
  - createShipment
- Reports
  - getReportDocument (for specified report types)
- The SP-API report types that will require the Restricted Data Token (RDT) are:
  - GET_AMAZON_FULFILLED_SHIPMENTS_DATA_INVOICING
  - GET_AMAZON_FULFILLED_SHIPMENTS_DATA_TAX
  - GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_SHIPPING
  - GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING
  - GET_FLAT_FILE_ORDER_REPORT_DATA_INVOICING
  - GET_FLAT_FILE_ORDER_REPORT_DATA_TAX
  - GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_SHIPPING
  - GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_INVOICING
  - GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_TAX
  - GET_ORDER_REPORT_DATA_SHIPPING
  - GET_ORDER_REPORT_DATA_INVOICING
  - GET_ORDER_REPORT_DATA_TAX
  - GET_EASYSHIP_DOCUMENTS
  - GET_GST_MTR_B2B_CUSTOM
  - GET_VAT_TRANSACTION_DATA
  - SC_VAT_TAX_REPORT
1. 案例代码 tokens-api-postman接口集合和
  restricted-data-token-工作流代码