재무 문서 검색 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를 사용하여 송장을 검색하려면 요청에 주문 번호 및 재무 문서 번호가 필요합니다. 주문 검색 응답의 "송장" 섹션에서 재무 문서 번호를 찾을 수 있습니다(/store/orders/{orderNumber} https://api-portal.ti.com/store-order-api). PDF를 검색하려면 구성 옵션에 대한 아래 사양을 참조하십시오. 이 API는 푸시 또는 검색 구현에서 사용할 수 있습니다. 푸시 API는 실시간으로 시스템에 웹후크를 전송하여 재무 문서가 준비되었으며 자동화 흐름을 트리거하는 데 사용할 수 있음을 알립니다. 자세한 내용은 푸시 알림 설정을 참조하십시오.

Apruve를 결제 방법으로 사용하는 송장의 경우 Apruve 포털로 이동하여 직접 송장을 얻습니다.
 

재무 문서 검색 흐름

  1. 재무 문서가 생성된 후 할당된 API 키와 비밀을 사용하여 인증합니다.
  2. 액세스 토큰을 받은 후 주문 번호와 문서 번호가 포함된 요청을 보냅니다. 토큰이 만료되지 않은 한 액세스 토큰을 사용하여 동일한 세션에서 여러 요청을 수행할 수 있습니다.  
  3. API는 상태 코드 200 OK와 문서 정보가 포함된 JSON 문자열로 응답합니다.
  4. PDF가 요청된 경우 JSON에 base64로 인코딩된 문자열로 포함됩니다.

API 테스트 버전을 사용할 수 있습니다. 응답의 데이터는 표준화된 테스트 예제 데이터를 반환합니다. 테스트의 경우, 재무 문서 번호는 항상 5999999999로 전달되어야 합니다.

https://transact.ti.com/v2/store/orders/T10999999/financial-documents/5999999999/test?requestPDF=true

요청 예: