订单 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": [
      {
        "消息"："jobNumber|54851-50"
      },
      {
        "消息"："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"
}