ご注文 API
ご注文の取得
正式運用エンドポイント:
https://transact.ti.com/v2/store/orders/
注文検索取得型 API を使用して、貴社のご注文に関する情報を検索取得します。
できることについて:
- 最近のご注文のリストを表示します (デフォルトは過去 30 日間)。
- 注文番号で特定の注文に関する詳細情報を取得します。
ステップ:
- 認証:API を使用して認証を受けるには、貴社の割り当て済みAPI キーとシークレットが必要です。
- API 要求:ご注文 API にリクエストを送り、ご注文のステータスと追加の詳細を取得します。
- API の応答:ステータス コード (200 OK) と、注文の詳細を含む JSON 形式の応答を受信します。
- 日付で注文をフィルタリング (オプション):
- 日付範囲を指定するには、リクエストにクエリ パラメータ「startDate」(開始日) と「endDate」(終了日) を含めます。
- 例:https://transact.ti.com/v2/store/orders?startDate=2021-05-01&endDate=2025-05-31
- 特定の注文に関する詳細の検索取得:
- 特定の注文に関する詳細情報を取得するには、注文 API に対して注文番号を問い合わせます。
- 例:"https://transact.ti.com/v2/store/orders/T999999999"
注文番号を使用した問い合わせの例:
curl --request GET \
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}'
--header 'Authorization: Bearer {access_token}' \
Example response:
{
"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"
}
],
"customerOrderAttributes": [
{
"attribute": "string"
}
],
"orderPlacedTime": "string",
"paymentType": "string",
"currencyISO": "string",
"totalTax": 0,
"checkoutProfileIdentifier": "string",
"totalDeliveryCost": 0,
"totalDiscount": 0,
"couponCodes": "string"
}