亞馬遜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-工作流代碼