주문 API

주문 생성

테스트 엔드포인트: 
https://transact.ti.com/v2/store/orders/test

생산 엔드포인트:
https://transact.ti.com/v2/store/orders/

주문 API를 사용하여 시스템을 통해 직접 주문을 생성하고 관리할 수 있습니다. 자세한 주문 정보를 검색하여 추적 및 관리를 개선합니다.

 

시작하기 전에:

  • 재고 및 가격 확인: 주문을 생성하기 전에 재고 및 가격 API를 사용하여 개별 품목의 가용성 및 가격을 확인합니다.
  • API 결제 프로필 활성화: 회사 계정에 API 적격 결제 프로필이 설정되어 있어야 합니다. 계정 및 프로필 생성에 대한 자세한 내용은 "시작하기" 가이드를 참조하십시오.
  • 결제 프로필이 누락된 경우: 결제 프로필이 완료되고 승인된 결제 방법이 추가되었는지 확인합니다. 자세한 내용은 결제 정보를 참조하십시오.


테스트:

테스트 엔드포인트(https://transact.ti.com/v2/store/orders/test)를 사용하여 주문 생성 프로세스 및 응답을 시뮬레이션합니다. 이 데이터는 데모용으로만 사용됩니다.

주문 설명:

  • "customerOrderComments" 및 "customerItemComments" 필드를 사용하여 주문에 추가 정보를 전달할 수 있습니다.
  • 이 데이터는 고객만 사용할 수 있으며 TI에서 검증하지 않습니다.
  • 아래 예에서 "customerOrderComments" 배열은 작업 번호와 주문하는 사람의 이름을 지정하기 위해 파이프로 구분된 문자열의 배열을 전달하는 데 사용됩니다.

예:

    "customerOrderComments": [
      {
        "message": "jobNumber|54851-50"
      },
      {
        "message": "orderedBy|John Smith"
      } 
 ]    

주문 생성 흐름:

  1. 할당된 API 키와 암호를 사용하여 인증합니다.
  2. 재고 및 가격 API를 사용해 제품 가용성 및 현재 가격을 확인합니다.
  3. 상태 코드(200 OK)를 포함한 응답과 요청된 제품 데이터를 포함하는 JSON 응답을 받습니다.
  4. 재고 및 가격 API를 통해 재고 보유 여부를 확인한 후 원하는 페이로드로 주문을 작성하고 주문 API에 게시합니다.
  5. 상태 코드(201 OK)와 주문에 대한 JSON 확인이 있는 응답을 받게 됩니다. 

 

#!/bin/bash
curl --request POST \
--url 'https://transact.ti.com/v2/store/orders/test' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <


응답 예:

{
  "orderNumber": 0,
  "orderStatus": "string",
  "customerPurchaseOrderNumber": "string",
  "subTotal": 0,
  "totalPrice": 0,
  "lineItems": [
    {
      "tiPartNumber": "string",
      "tiPartDescription": "string",
      "quantity": "string",
      "status": "string",
      "unitPrice": 0,
      "customReelIndicator": true
    }
  ],
  "shippingAddress": [
    {
      "addressType": "string",
      "firstName": "string",
      "lastName": "string",
      "company": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "town": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string",
      "email": "string",
      "phoneNumber": "string",
      "companyURL": "string"
    }
  ],
  "billingAddress": [
    {
      "addressType": "string",
      "firstName": "string",
      "lastName": "string",
      "company": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "town": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string",
      "email": "string",
      "phoneNumber": "string",
      "companyURL": "string"
    }
  ],
  "orderMessages": [
    {
      "code": "string",
      "type": "string",
      "Message": "string"
    }
  ],
  "customerOrderComments": [
    {
      "message": "string"
    }
  ],
  "orderPlacedTime": "string",
  "paymentType": "string",
  "currencyISO": "string",
  "totalTax": 0,
  "checkoutProfileIdentifier": "string",
  "totalDeliveryCost": 0,
  "totalDiscount": 0,
  "couponCodes": "string"
}