訂單 API
訂單創(chuàng)建
測試終點(diǎn)：
https://transact.ti.com/v2/store/orders/test
生產(chǎn)端點(diǎn)：
https://transact.ti.com/v2/store/orders/
訂單 API 使您能夠創(chuàng)建訂單和檢索詳細(xì)的訂單信息。在創(chuàng)建訂單之前，您必須使用庫存和價(jià)格 API 來驗(yàn)證各個(gè)器件的供貨情況。
要下訂單（測試或量產(chǎn)），您必須在公司帳戶中保存符合 API 條件的結(jié)算信息。有關(guān)更多信息，請參閱“入門”，以了解有關(guān)創(chuàng)建公司帳戶和結(jié)算信息的更多信息。要選擇將隨訂單引用的結(jié)算信息，請使用結(jié)算信息 API。響應(yīng)中將僅返回符合 API 條件的結(jié)算信息。當(dāng)結(jié)算信息缺失時(shí)，請驗(yàn)證結(jié)算信息是否完整以及是否添加了批準(zhǔn)的付款方式（有關(guān)詳情，請參閱付款信息）。
測試終點(diǎn)返回的數(shù)據(jù)模擬了量產(chǎn)訂單返回的信息（數(shù)據(jù)僅用于演示目的，不表示經(jīng)過處理的數(shù)據(jù)）。當(dāng)您準(zhǔn)備好下量產(chǎn)訂單時(shí)，請查看您希望在請求有效載荷中發(fā)送的所有參數(shù)，并使用 HTTP "post" 動詞發(fā)送到生產(chǎn)終點(diǎn)。
注意：字段 customerOrderComments 和 customerItemComments 是按照檢索響應(yīng)順序返回的直通文本數(shù)組。該數(shù)據(jù)僅供客戶使用，未經(jīng) TI 驗(yàn)證。在下面的示例中，???????customerOrderComments 數(shù)組用于傳遞以管道分隔的字符串?dāng)?shù)組，以指定下單人員的職位編號和姓名。
示例：
? ? "customerOrderComments": [
? ? ? {
? ? ? ? "message": "jobNumber|54851-50"
? ? ? },
? ? ? {
? ? ? ? "message": "orderedBy|John Smith"
? ? ? }?
?]? ??
?
訂單創(chuàng)建流程
- 使用為您分配的 API 密鑰和密碼進(jìn)行身份驗(yàn)證。
- 向庫存和價(jià)格 API 發(fā)送查詢以檢索產(chǎn)品供貨情況和當(dāng)前價(jià)格。
- API 將使用狀態(tài)代碼“200 OK”和包含所請求產(chǎn)品數(shù)據(jù)的 JavaScript 對象表示法 (JSON) 響應(yīng)進(jìn)行回復(fù)。
- 使用庫存和價(jià)格 API 確認(rèn)供貨情況后，使用您所需的有效載荷構(gòu)建您的訂單，并發(fā)布到訂單 API。
- API 將使用狀態(tài)代碼“201 OK”和包含訂單確認(rèn)的 JSON 進(jìn)行回復(fù)。
#!/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 } ] } }
示例響應(yīng)：
{ "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" }