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

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权限需要提交更多的资料(资料填写要慎重，目前申请比较难)。

3.解析

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

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-工作流代码