財務文件擷取 API
測試端點:
https://transact.ti.com/v2/store/orders/T10999999/financial-documents/5999999999/test
生產端點:
https://transact.ti.com/v2/store/orders/{Order Number}/financial-documents/{Invoice Number}
財務文件擷取 API 可提供非 Apruve 付款的發票資訊,並可讓您下載發票的 PDF 複本。發票會在 TI 處理及運送訂單後提供。若要使用財務擷取 API 來擷取發票,必須為要求提供訂單號碼和財務文件號碼。您可在訂單擷取回應的「發票」區段下,找到財務文件號碼 (get /store/orders/{orderNumber} https://api-portal.ti.com/store-order-api)。若要擷取 PDF,請參閱下方規格以了解配置選項。在推播或擷取實作中,可使用此 API 可。推播 API 會即時向您的系統傳送 Webhook,以通知您的財務文件已備妥,且可用於觸發自動化流程。請參閱推播通知設定以了解更多資訊。
若發票使用 Apruve 作為付款方式,請瀏覽 Apruve 入口網站以直接取得發票。
財務文件擷取流程
- 在產生財務文件後,請進行認證,方法為使用指派給您的 API 金鑰和秘密。
- 收到您的存取權杖後,請傳送內含訂單號碼與文件號碼的要求。只要權杖尚未過期,就可以在同一個工作階段中使用存取權杖進行多個要求。
- API 將會回覆狀態代碼 200 OK,以及包含文件資訊的 JSON 字串。
- 如果要求 PDF,則會以 base64 編碼字串的形式將其納入 JSON 中。
提供 API 的測試版本。回應中的數據會傳回標準化的測試範例數據。如需測試,應一律以「5999999999」傳送「financialDocumentNumber」。
請求範例: