재무 문서 검색 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 사본을 다운로드할 수 있습니다.

어떤 송장에 액세스할 수 있나요?

  • 이 API는 TI가 처리하고 배송한 주문에 대한 송장을 검색합니다(Apruve 결제 제외).
  • TI가 주문을 처리하고 배송하면 송장을 사용할 수 있게 됩니다.

송장을 검색하는 방법:

  1. 정보 수집: 주문 번호와 재무 문서 번호가 모두 필요합니다.
    • 주문 확인 이메일에서 또는 응답을 사용하여(get /store/orders/{orderNumber} https://api-portal.ti.com/store-order-api) 주문 번호를 찾습니다.
    • 주문 검색 응답의 '송장' 섹션에서 재무 문서 번호를 찾습니다.
  2. 인증: 할당된 API 키와 암호를 사용하여 액세스 토큰을 받습니다.
  3. 요청 보내기: API에 주문 번호, 재무 문서 번호 및 액세스 토큰을 포함하여 요청을 합니다.
  4. 송장 수신:
    • API는 상태 코드(200 OK)와 송장 정보가 포함된 JSON으로 응답합니다.
    • PDF 사본을 요청한 경우 base64로 인코딩된 문자열로 포함됩니다.

API 테스트:

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

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

추가 참고:

  • Apruve 결제를 위한 송장은 Apruve 포털을 통해 직접 액세스할 수 있습니다.
  • API는 푸시 또는 검색 구현으로 사용할 수 있습니다. 자세한 내용은 푸시 알림 설정을 참조하십시오.