ASN(사전 발송 통지서) 검색 API

테스트 엔드포인트:
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test

생산 엔드포인트:
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/{Waybill Number}

주문을 포장하고 배송할 준비가 되면 TI에서 배송 추적 정보를 생성합니다. ASN(사전 발송 통지서) API를 사용하여 추적 번호, 운송업체 세부 정보, 상업 송장을 포함하여 배송된 주문에 대한 자세한 정보를 검색할 수 있습니다.

ASN API는 다음을 제공합니다.

  • 실시간 업데이트: 푸시 API는 주문이 배송될 준비가 되었고 자동화 흐름을 트리거하는 데 사용할 수 있음을 시스템에 웹 후크를 전송하여 알립니다.
  • 자세한 배송 정보: 추적 번호, 운송업체 정보, 상업 송장을 가져옵니다.
  • 유연한 검색 옵션: 주문 번호로 전체 주문에 대한 정보를 검색하거나 운송장 번호로 특정 배송에 대한 정보를 검색합니다.

ASN API 사용 단계:

  1. 인증: API로 인증하려면 할당된 API 키와 암호가 필요합니다.
  2. 배송 정보 검색:
    • 전체 주문: 요청에 주문 번호를 입력합니다.
    • 특정 배송: myTI 주문 내역에서 이전에 받았거나 찾은 운송장 번호를 포함합니다.
  3. API 응답: 상태 코드(200 OK)를 포함한 응답과 배송 세부 정보가 포함된 JSON을 수신합니다.
  4. 특정 주문 세부 정보 검색:
    • 특정 주문에 대한 자세한 정보를 보려면 주문 API에 주문 번호를 쿼리합니다.
    • 예: "https://transact.ti.com/v2/store/orders/T999999999"

API 테스트:

라이브 데이터로 API를 사용하기 전에 테스트 환경에서 API를 실험해 볼 수 있습니다. 테스트 시:

  • 제공된 테스트 엔드포인트 URL을 사용합니다
  • 주문 ID는 항상 T10999999로 전달되어야 하며 운송장 번호는 항상 0499999999로 전달되어야 합니다.

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true 

또는

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true

추가 참고:

  • 액세스 토큰은 세션이 유효하다면 그 내부에서 여러 요청을 허용합니다.
  • API는 푸시 또는 검색 구현으로 사용할 수 있습니다. 자세한 내용은 푸시 알림 설정을 참조하십시오.

 

검색 요청 예:

curl --request GET \
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}'
--header 'Authorization: Bearer {access_token}' \