주문 API

주문 생성

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

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

주문 API를 통해 주문을 생성하고 자세한 주문 정보를 검색할 수 있습니다. 주문을 생성하기 전에 재고 및 가격 API를 사용해 개별 품목의 재고 보유 여부를 확인해야 합니다.   

주문(테스트 또는 생산)을 하려면 회사 계정에 API 적격 결제 프로필이 저장되어 있어야 합니다. 회사 계정 생성 및 결제 프로필에 관한 자세한 사항은 시작하기를 참조하세요. 주문에 참조할 결제 프로필을 선택하려면 결제 프로필 API를 사용하십시오. API 적격 결제 프로필만 응답으로 반환됩니다. 결제 프로필이 누락된 경우 결제 프로필이 완료되고 승인된 결제 방법이 추가되었는지 확인하십시오. 자세한 내용은 결제 정보를 참조하십시오.

테스트 엔드포인트에서 반환된 데이터는 생산 주문에서 반환된 정보를 시뮬레이션합니다(데이터는 예시용으로만 사용되며 처리된 데이터를 나타내지 않음). 생산 주문을 발주할 준비가 되면 요청 페이로드에서 보내려는 모든 매개 변수를 검토하고 생산 엔드포인트에 HTTP "post" 동사를 사용하십시오.


참고: customerOrderComments 및 customerItemComments 필드는 주문 검색 응답으로 반환되는 전달 텍스트 배열입니다. 이 데이터는 고객만 사용할 수 있으며 TI에서 검증하지 않습니다. 아래 예에서 ​​​​​​​customerOrderComments 배열은 작업 번호와 주문하는 사람의 이름을 지정하기 위해 파이프로 구분된 문자열의 배열을 전달하는 데 사용됩니다.

예시:

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

 

주문 생성 흐름

  1. 할당된 API 키와 비밀을 사용하여 인증합니다.
  2. 재고 및 가격 API에 쿼리를 보내 제품 재고 보유 여부 및 현재 가격을 검색합니다. 
  3. API는 상태 코드, 200 OK 및 요청된 제품 데이터가 포함된 JSON(JavaScript Object Notation) 응답으로 회신합니다.
  4. 재고 및 가격 API를 통해 재고 보유 여부를 확인한 후 원하는 페이로드로 주문을 작성하고 주문 API에 게시합니다.
  5. API는 상태 코드, 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 @- <<DATA { "Orders" : { "checkoutProfileId" : "COP_ID-1234", "customerPurchaseOrderNumber" : "PGR - 04202021", "purchaseOrderDate" : "2020-12-31T13:56:00Z", "endCustomerCompanyName" : "TI Electronics Inc", "expediteShipping" : true, "customerOrderComments" : [ { "message" : "PO: 234723" }, { "message" : "my Test order" } ], "lineItems" : [ { "customerLineItemNumber" : 1, "tiPartNumber" : "ISO1042", "customerPartNumber" : "CUS-SN74LS00N", "customReelIndicator" : false, "quantity" : 10000, "customerItemComments" : [ { "message" : "For BOM2 - aquired " } ] }, { "customerLineItemNumber" : 2, "tiPartNumber" : "OPA33AIDR", "quantity" : 10000 } ] } }


응답 예:

{ "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" }