エンドポイント
注意: レスポンスキーは変更される可能性があり、追加のキーが追加される場合があります。エンドポイントを使用する場合は、これらの可能性に対応できるようにコードを設定してください。
POST | https://api.iglobalstores.com/v2/orderDetail
HTTPS リクエスト
フィールド | ノート |
---|---|
HTTP メソッド | POST |
エンドポイント | https://api.iglobalstores.com/v2/orderDetail |
プロトコル | HTTPS |
メッセージ形式 | JSON |
Accept HTTP ヘッダー | Accept: application/json |
Content-Type HTTP ヘッダー | Content-Type: application/json |
リクエストボディ内の JSON キー/値ペア
フィールド | ノート |
---|---|
orderId オプション、referenceId パラメータを渡す場合 | Zonos 注文 Id は、ストア Id とハイフンを含めることなく渡すことができます(例: 123-45678 または 45678)。注意: 注文の完了と支払い後、顧客はあなたのドメインにホストされた注文完了 / 注文ありがとうページにリダイレクトされます。URL には、この値を含むクエリ文字列パラメータ “orderId” が含まれます。integer / string |
referenceId オプション、orderId パラメータを渡す場合 | このパラメータは、createTempCart API サービスエンドポイントで渡されたユニークな referenceId によって注文のデータを検索するために使用されます。このパラメータは、orderId パラメータに基づいて注文の詳細を検索する場合は省略するか、null にする必要があります。string |
secret 必須 | Zonos によって提供された API シークレット GUIDstring |
storeId 必須 | Zonos によって提供されたストア ID。integer |
エラー HTTP レスポンス
エラーコード | メッセージ | 意味 |
---|---|---|
415 | サポートされていないメディアタイプ | HTML エンティティ。HTTP “Content-Type” ヘッダーが無効です。 |
406 | 受け入れ不可 | HTML エンティティ。HTTP “Accept” ヘッダーが無効です。 |
400 | 不正なリクエスト | “error”:”orderId: 999-99999 は有効な orderId ではありません”“error”:”orderId: 999-99999 の注文が見つかりませんでした”“error”:”無効なセキュリティ資格情報”“error”:”無効なポストボディ”“error”:”orderId または referenceId パラメータが必要です”“error”:”orderId と referenceId の両方のパラメータを指定することはできません”“error”:”orderId: 999-99999 の注文が見つかりませんでした”“error”:”store パラメータが必要です”“error”:”storeId: 999 の referenceId: 999999 の注文が見つかりませんでした”“error”:”storeId: 999 の referenceId: 999999 が重複しています”“error”:”referenceId: 999999 で注文を取得できませんでした” |
500 | 内部サーバーエラー | “error”:”注文の詳細を処理できませんでした” |
レスポンス JSON 定義
フィールド | ノート |
---|---|
error | このパラメータはエラーが発生した場合のみ存在し、エラーの説明を含みます。string |
order | 注文の詳細のマップです。JSON string |
order.billingZip | 注文の請求先住所 - 値はZonos Checkoutに入力されました。string |
orderboxCount | このフィールドは、注文を発送するために使用されるボックスの数を説明しますcreateTempCart リクエストに渡されます。string |
order.carrierAccountNumber | 訪問者自身の配送業者アカウント番号; 訪問者の配送業者アカウントが有効な場合に使用されます。string |
order.carrierAccountShippingMethod | 訪問者自身の配送業者アカウントで選択された配送方法; 訪問者の配送業者アカウントが有効な場合に使用されます。string |
order.cslListMatch | 統合スクリーニングリスト (CSL) の一致。顧客情報が米国の統合スクリーニングリストで一致した場合にレビューが必要であることを示すブール値です。boolean |
order.customerSelectedShippingName | Zonos Checkout内の配送オプションの表示名。string |
order.dutyTaxesBreakdown | 税金/関税の内訳のマップ。注 - 該当する場合、IPF (国際処理手数料) は含まれません。JSON string |
order.dutyTaxesBreakdown.brokerageFee | USDでの仲介手数料の金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesBreakdown.dispursementFee | USDでの支払い手数料の金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesBreakdown.duty | USDでの関税の金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesBreakdown.prepaymentFee | USDでの前払い手数料の金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesBreakdown.vatOnDispursementFee | USDでの支払い手数料に対するVAT/税金の金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesBreakdown.vatTax | USDでのVAT/税金の金額; 支払い手数料に対するVAT/税金は含まれません; 正の浮動小数点数、2桁の小数点以下。integer |
order.dutyTaxesTotal | USDでの関税および税金の合計; 正の浮動小数点数、2桁の小数点以下。integer |
order.foreignCurrencyCode | 注文の支払いが決済された通貨コード。string |
remittance_amount | 特定の国(例:英国のVAT)に送金する必要がある金額。decimal |
order.grandTotal | USDでの合計金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.grandTotalForeign | 決済通貨での合計金額; 正の浮動小数点数、2桁の小数点以下。integer |
order.items | アイテムのマップのリスト。アイテムマップには、Zonos Checkoutの一時カート作成時に渡されたアイテムの詳細が含まれています。アイテムプロパティの詳細についてはcreateTempCart APIドキュメントを参照してください。JSON string |
order.itemsCount | 注文のラインアイテムのカウント。integer |
order.itemsTotal | USDでのアイテム/製品の合計; 正の浮動小数点数、2桁の小数点以下。integer |
order.itemsTotalForeign | 決済通貨でのアイテム/製品の合計; 正の浮動小数点数、2桁の小数点以下。integer |
order.items[index].height | 正の浮動小数点数、2桁の小数点以下。integer |
order.items[index].itemNonShippable | boolean |
order.items[index].length | 正の浮動小数点数、2桁の小数点以下。integer |
order.items[index].quantity | integer |
order.items[index].weight | 正の浮動小数点数、少数点以下2桁integer |
order.items[index].width | 正の浮動小数点数、少数点以下2桁integer |
order.items[index].unitPrice | 正の浮動小数点数、少数点以下2桁integer |
order.merchantOrderId | 注文に関連付けられたMerchantOrderId はupdateMerchantOrderId APIサービスエンドポイントを通じて取得されます。string |
order.misc1 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.misc2 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.misc3 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.misc4 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.misc5 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.misc6 | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた追加の値。string |
order.nationalIdentifier | 必要に応じて、注文のための追加の国際請求先住所情報。値はZonos Checkoutに入力されました。string |
order.notes | 注文ノートに関する詳細を含むノートマップのリスト。JSON string |
order.notes[index].createdByUser | string |
order.notes[index].customerNote | 注文、配送などに関する顧客作成のノートであるかどうかを示すブール値。boolean |
order.notes[index].dateCreated | millis |
order.notes[index].dateCreatedString | string |
order.notes[index].flagged | このノートが重要としてフラグ付けされたかどうかを示すboolean |
order.notes[index].note | ノートの内容string |
order.optInEmail | 顧客がZonos Checkout内の「ニュースレターにサインアップする」ためのチェックボックスを選択したことを示します。このチェックボックスをcheckoutページに表示することを選択した場合にのみ適用されます。boolean |
order.orderId | Zonosシステム内の注文の識別番号string |
order.orderDate | UTC/GMTでの注文作成タイムスタンプミリ秒。millis |
order.orderDateString | UTC/GMTでの注文作成タイムスタンプ文字列。string |
order.orderStatus | Zonosシステム内の注文の状態/ステータス。orderStatus の使用に関する詳細はここで注文を取得するを確認してください。注文ステータスに関する追加情報はここで注文を更新するを参照してください。string |
order.orderStatusDate | Zonosシステム内の最も最近のorderStatus 変更のUTC/GMTでのタイムスタンプミリ秒。millis |
order.orderStatusDateString | Zonosシステム内の最も最近のorderStatus 変更のUTC/GMTでのタイムスタンプ文字列。string |
order.paymentProcessing | paymentProcessing の詳細のマップ。一部のパラメータはアカウントに適用されない場合があり、レスポンスから除外されます。JSON string |
order.paymentProcessing.captureDate | 利用可能な場合、ミリ秒単位の支払いキャプチャの日付。Zonosが支払いを処理している場合、このノードはレスポンスから除外されます。millis |
order.paymentProcessing.captureDateString | 利用可能な場合、文字列としての支払いキャプチャの日付。Zonosが支払いを処理している場合、このノードはレスポンスから除外されます。string |
order.paymentProcessing.cardType | クレジットカードブランド。Zonosが支払いを処理している場合、このノードはレスポンスから除外されます。string |
order.paymentProcessing.lastFour | 請求書のクレジットカード番号の最後の4桁。Zonos が支払いを処理している場合、このノードはレスポンスから除外されます。string |
order.paymentProcessing.paymentGateway | 支払いゲートウェイ名。Zonos が支払いを処理している場合、「iGlobal_CC」または「iGlobal_PayPal」と表示されます。string |
order.paymentProcessing.transactionType | 取引の種類を示します。「AUTH_CAPTURE」または「AUTH_ONLY」。Zonos が支払いを処理している場合、このノードはレスポンスから除外されます。string |
order.poNumber | Zonos Checkout 内で指定された注文の購入注文番号。購入注文が有効になっている場合に使用されます。string |
order.quotedDutyTaxes | Zonos Checkout で引用された関税および税金、USDで表示されます。正の浮動小数点、2桁の小数点。integer |
order.quotedDutyTaxesForeign | Zonos Checkout で引用された関税および税金。決済通貨で表示されます。正の浮動小数点、2桁の小数点。integer |
order.referenceId | createTempCart APIサービスエンドポイントを通じて注文に関連付けられた一意の referenceId 。string |
order.shipComplete | 注文が複数の部分で出荷されるべきかどうかを示します。boolean |
order.shippingCarrierServiceLevel | 選択された配送オプションのキャリアおよびサービスレベル識別子。string |
order.shippingInstructions | 配送サービスレベルのカスタマイズ可能な指示。string |
order.shippingTotal | USDでの配送合計。正の浮動小数点、2桁の小数点。integer |
order.shippingTotalForeign | 決済通貨での配送合計。正の浮動小数点、2桁の小数点。integer |
order.testOrder | 注文がテスト注文であるかどうかを示します。boolean |
order.trackingNumber | 出荷のために生成された追跡番号(該当する場合)。string |
order.zip | 注文の宛先/配送先住所 - 値はZonos Checkout に入力されたか、Zonos Checkout へのリダイレクトを通じて注文に渡されました。string |
追加データ型:
order.address1
order.address2
order.address3
order.altPhone
order.billingAddress1
order.billingAddress2
order.billingAddress3
order.billingAltPhone
order.billingCity
order.birthDate
order.billingCompany
order.billingCountryCode
order.billingCountryName
order.billingEmail
order.billingName
order.billingPhone
order.billingState
order.city
order.company
order.countryCode
order.countryName
order.email
order.items[index].countryOfOrigin
order.items[index].description
order.items[index].imageURL
order.items[index].itemBrand
order.items[index].itemCategory
order.items[index].itemColor
order.items[index].itemCustomization
order.items[index].itemDescriptionDetailed
order.items[index].itemDescriptionLong
order.items[index].itemFabricContent
order.items[index].itemHSCode
order.items[index].itemLtlClass
order.items[index].itemMaterial
order.items[index].itemURL
order.items[index].productId
order.items[index].sku
order.items[index].productId
order.items[index].weightUnits
order.name
order.phone
order.state
注文の詳細
注文の詳細エンドポイントの動作を学びましょう。orderDetail
エンドポイントは、Zonos Checkout を介して完了した注文の詳細とステータスを安全に取得するために使用されます。