注文
注文とは、顧客がチェックアウトした後に得られるものです。
DataEaseを使用すると、次のことができます:
- 数百の注文にわたって価格、数量、タグを修正します。
- トラッキング番号を追加し、請求書を送信し、または一括でラインを返金します。
- レポートや会計のために完全な注文履歴をエクスポートします。
Shopify注文ガイド。
2. エクスポート
Section titled “2. エクスポート”- CSV(非常に大きなファイルに最適)またはExcelを選択します。
- 注文を選択します。
- 必要な列を選択します - name, financialStatus, lineItemQuantityなど。
- タスクを実行し、ファイルをダウンロードします。
詳細: エクスポートガイド
3. インポート
Section titled “3. インポート”注文行 command → CREATE, UPDATE, REPLACE, DELETE, IGNORE
ライン行 itemCommand → CREATE, UPDATE, MERGE, DELETE, IGNORE
他のラインタイプも同様のパターンに従います。
特別なaction列(インポート専用):
COMPLETE, CANCEL, SEND_CONFIRMATION, FULFILL, REFUND
ヒント:
CREATEの場合、少なくともemailまたはphone(または既存のcustomerId)を指定する必要があります。
トライアルまたは開発ストアで注文を作成する場合、制限があります:1分あたり最大5件の新規注文。
返金は二重に送信されません。 このインポート内の同じ返金の以前の試行が失敗していた場合、Shopifyはそれを繰り返すことを拒否します(
IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED)。DataEaseは新しいリクエストで再試行しません(二重返金になる可能性があるため):返金行には*“Refund was not applied…”*というエラーが表示されます。行を確認して、インポートを再度実行してください。
手順
- サンプルファイルを取得します:Order-import-sample.xlsx
- ヘッダー行を編集します(LineType =
ORDER)、その後、LINE_ITEM、SHIPPING_LINEなどの追加行を追加します。 - DataEaseで列をマッピングし、アップロードして開始します。
完全な手順: インポートガイド
4. フィールドリファレンス
Section titled “4. フィールドリファレンス”以下は最も使用される列の短縮リストです。
エクスポートのグレーの行はエクスポート専用(インポートで変更できません)。
注文レベル (LineType = ORDER)
Section titled “注文レベル (LineType = ORDER)”-
id— 注文ID。UPDATE、REPLACE、DELETEに必要です。 -
command— 行のアクション:CREATE|UPDATE|REPLACE|DELETE|IGNORE。 -
currencyCode— 注文が行われたときのショップの通貨。ストアのデフォルトを使用するには空白のままにします。 -
presentmentCurrencyCode— ショッパーが支払った通貨(マルチ通貨ショップ)。 -
email— 領収書用の顧客のメールアドレス。 -
phone— 顧客の電話番号。 -
tags— カンマ区切りのタグ。タグガイドを参照してください。 -
tagsCommand— 注文のタグをADD、REMOVE、またはREPLACEします。 -
buyerAcceptsMarketing— 購入者がマーケティングにオプトインした場合はtrue。 -
poNumber— 購入注文番号。 -
taxesIncluded— アイテムの価格にすでに税金が含まれている場合はtrue。 -
displayFinancialStatus—AUTHORIZED、PAID、REFUNDEDなど。(エクスポート専用) -
displayFulfillmentStatus—FULFILLED、PARTIALLY_FULFILLEDなど。(エクスポート専用)
ラインアイテム (LineType = LINE_ITEM)
Section titled “ラインアイテム (LineType = LINE_ITEM)”-
lineItemVariantId— 追加/更新するバリアントID。カスタムアイテムの場合は空白のままにします。 -
lineItemQuantity— 注文された数量。 -
lineItemSku— SKU(variantIdが空白の場合、バリアントを見つけるために使用)。 -
lineItemOriginalUnitPrice— 割引前の価格(ショップ通貨)。 -
lineItemAppliedDiscountValue— このラインに適用された割引値。 -
lineItemAppliedDiscountValueType—FIXED_AMOUNTまたはPERCENTAGE。
配送料 (LineType = SHIPPING_LINE)
Section titled “配送料 (LineType = SHIPPING_LINE)”-
shippingLineTitle— 配送サービスの名前。 -
shippingLinePrice— ショップ通貨での価格。 -
shippingLinePresentmentPrice— ショッパー通貨での価格。
フルフィルメント (LineType = FULFILLMENT)
Section titled “フルフィルメント (LineType = FULFILLMENT)”-
fulfillmentTrackingCompany— トラッキングキャリア(Shopifyリストからの正確な名前)。 -
fulfillmentTrackingNumbers— トラッキング番号(複数の場合はカンマ区切り)。 -
fulfillmentLocationId— 在庫を差し引く場所のID。 -
fulfillmentNotifyCustomer— 配送確認をメールで送信する場合はtrue。
取引と返金 (LineType = TRANSACTION or REFUND)
Section titled “取引と返金 (LineType = TRANSACTION or REFUND)”-
transactionKind—AUTHORIZATION|CAPTURE|REFUND|SALE|VOID。 -
transactionAmount— ショップ通貨での金額。 -
refundLineItemRestockType— アイテムを再入荷する際のRETURNまたはCANCEL。
メタフィールド
Section titled “メタフィールド”metafields— 追加データ用のカスタム列。メタフィールドガイドを参照してください。
エクスポート専用フィールド
Section titled “エクスポート専用フィールド”以下は、DataEaseが注文のためにエクスポートするすべての追加の「グレーのみ」の列です。
これらは読み取り専用で、インポートで変更することはできませんが、レポート、不正チェック、マーケティング、サポートに便利です。
注文の合計と価格
Section titled “注文の合計と価格”totalPrice— ショップ通貨での注文の総合計(税金 + 配送 + 割引を含む)。totalShippingPrice— 割引や返金前の配送コスト。totalWeight— すべてのアイテムの総重量(グラム)。totalTax— 注文に課された総税額。subtotalPrice— アイテムレベルの割引後、税金と配送前の小計。currentSubtotalPrice— 返品または編集後の小計。totalShopCurrencyDiscount— 作成時のショップ通貨でのすべての割引(注文 + アイテム)。totalPresentmentCurrencyDiscount— ショッパー通貨での現在の注文レベルの割引。currentTotalDuties— 返品後に発生する関税(使用されていない場合はnull)。currentTotalAdditionalFees— 返品後の追加料金(ギフトラップ、リサイクルなど)。originalTotalAdditionalFeesSet— 注文が作成された時点での追加料金。totalOutstandingSet— 注文の未払い残高(+)または返金(–)。currentTotalPriceSet— 編集または返品後の最終総合計。
注文のステータスとメタデータ
Section titled “注文のステータスとメタデータ”publicationSource— 注文を作成した販売チャネル(オンラインストア、POSなど)。statusPageUrl— 顧客の「注文ステータス」ページリンク。displayFulfillmentStatus— フレンドリーなフルフィルメント状態(FULFILLED、PARTIALLY_FULFILLED…)。clientIp— 注文を行ったIPアドレス。canNotifyCustomer— 通知用のメールアドレスが存在する場合はtrue。daysToConversion— 初回ショップ訪問から購入までの日数。cancellationNote— 注文がキャンセルされたときに記録されたスタッフノート。riskRecommendation— 不正リスクのアドバイス:ACCEPT、INVESTIGATE、またはCANCEL。createdAt— 注文が作成された日時。updatedAt— 注文に何かが変更された最後の時間。cancelledAt— 注文がキャンセルされた時(キャンセルされていない場合はnull)。
マーケティング/訪問トラッキング
Section titled “マーケティング/訪問トラッキング”lastVisitLandingPage— 購入セッションでバイヤーが最初に訪れたページ。lastVisitSource— マーケティングソース(Google、Email、Directなど)。lastVisitSourceType— マーケティング戦術タイプ(広告、ソーシャル、リファラル…)。lastVisitUtmCampaign— UTMキャンペーン名。lastVisitUtmContent— UTMコンテンツタグ。lastVisitUtmMedium— UTMメディア(バナー、メール、cpc…)。lastVisitUtmSource— UTMソース(google、ニュースレター…)。lastVisitUtmTerm— UTM検索用語。
顧客スナップショット(エクスポート専用フィールド)
Section titled “顧客スナップショット(エクスポート専用フィールド)”customerCreatedAt— 顧客レコードが最初に作成された時。customerLocale— バイヤーの優先言語。customerNumberOfOrders— この顧客の生涯注文数。customerState— アカウント状態 –INVITED、ENABLED、DISABLED、またはDECLINED。customerAmountSpentAmount— 生涯支出額。customerAmountSpentCurrencyCode— 生涯支出の通貨。customerTags— 顧客プロファイルに既にあるタグ。customerSmsMarketingConsent— 最後のSMSマーケティング同意更新時間。customerEmailMarketingConsent— 最後のメールマーケティング同意更新時間。customerCompanyName— B2B会社名(ある場合)。customerCompanyId— 注文にリンクされた会社ID。customerCompanyExternalId— 外部ERP/CRM会社ID。customerLocationId— 会社の場所ID。customerLocationExternalId— 会社の場所の外部ID。customerLocationName— 会社の場所のフレンドリーネーム。
追加の配送と住所情報
Section titled “追加の配送と住所情報”shippingCity— 配送先住所の都市部分。shippingCountry— 配送先住所の国名。shippingProvince— 配送先住所の州/県名。
ラインアイテム分析
Section titled “ラインアイテム分析”lineItemName— 販売時のバリアントタイトルを含む製品タイトル。lineItemOriginalTotal— 割引前のラインアイテムの合計。lineItemTotalPresentmentCurrencyDiscount— このラインに適用された割引(ショッパー通貨)。lineItemVariantSku— 注文時にキャプチャされたバリアントSKU。lineItemVariantProductTags— このバリアントの製品タグ(スナップショット)。lineItemVariantInventoryQuantity— エクスポート時のバリアントの在庫。lineItemOriginalUnitPrice— 注文作成時の単価(ショップ通貨)。lineItemVariantProductHandle— 販売時に記録された製品ハンドル。lineItemDiscountAllocations— このアイテムの割引分割のJSONブロブ。lineItemDiscountPerItem— ショップ通貨での単位あたりの割引合計。lineItemVariantProductType— 製品タイプのスナップショット。lineItemVariantWeightUnit— 重量単位(g、kg、oz、lb)。lineItemVariantWeight— 重量値。lineItemVariantCost— 単位あたりのコスト(「製品コストの表示」権限が必要)。lineItemVariantCountryCodeOfOrigin— 原産国コード。lineItemVariantHSCode— 調和関税コード(6〜13桁)。lineItemVariantProvinceCodeOfOrigin— 原産地の州/県コード。
フルフィルメント監査
Section titled “フルフィルメント監査”fulfillmentStatus— フルフィルメント状態(SUCCESS、FAILUREなど)。fulfillmentName— 参照名(例:「F-1001」)。fulfillmentCreatedAt— フルフィルメントレコードが作成された時。fulfillmentUpdatedAt— フルフィルメントレコードに最後に変更があった時。fulfillmentDeliveredAt— パッケージが配達された日(キャリアが更新した場合)。fulfillmentEstimatedDeliveryAt— 推定配達日。fulfillmentInTransitAt— キャリアが荷物を「輸送中」とマークした時。fulfillmentRequiresShipping— このフルフィルメント内のいずれかのラインが配送を必要とする場合はtrue。fulfillmentTotalQuantity— このフルフィルメント内のすべてのラインアイテムの数量の合計。fulfillmentDisplayStatus— フレンドリーステータス(IN_TRANSIT、DELIVERED…)。fulfillmentCountry— フルフィルメント場所の国名。
shippingLineSource— レートの出所(手動、アプリ、キャリア)。shippingLineDiscountedPrice— 割引後の配送価格(ショップ通貨)。shippingLineDiscountedPresentmentPrice— 割引後の配送価格(ショッパー通貨)。
transactionPaymentId— ゲートウェイの支払い参照ID。transactionCreatedAt— 取引レコードが作成された時。transactionErrorCode— 支払いが失敗した場合のゲートウェイエラーコード。transactionAuthorizationExpiresAt— 認証が期限切れになる時(Plusのみ)。transactionFormattedGateway— フレンドリーなゲートウェイ名(例:「Stripe」)。transactionManuallyCapturable— 支払いを後で手動でキャプチャできる場合はtrue。transactionMaximumRefundableAmount— 残りの返金可能金額(推奨返金用)。transactionMultiCapturable— 複数のキャプチャが許可されている場合はtrue。transactionProcessedAt— 取引処理のタイムスタンプ。
支払いカード詳細(マスク済み)
Section titled “支払いカード詳細(マスク済み)”paymentDetailsAvsResultCode— ゲートウェイからの住所確認コード。paymentDetailsBin— カードの最初の6桁(BIN/IIN)。paymentDetailsNumber— マスクされたカード番号(XXXX-XXXX-1234)。paymentDetailsName— カード所有者名。paymentDetailsExpirationYear— カードの有効期限年。paymentDetailsExpirationMonth— カードの有効期限月。paymentDetailsCvvResultCode— CVV一致結果。paymentDetailsCompany— カードブランド(Visa、MasterCard…)。paymentDetailsPaymentMethodName— ゲートウェイ固有の方法(例:「visa_debit」)。paymentDetailsWallet— 使用されたデジタルウォレット(APPLE_PAY、GOOGLE_PAY…)。
refundId— 返金レコードID。refundCreatedAt— 返金が行われた時。refundedAmount— 返金された総額(ショップ通貨)。refundedPresentmentAmount— 返金された総額(ショッパー通貨)。refundLineItemLocationId— 在庫が返された場所。refundLineItemRestocked— 在庫が再入荷された場合はtrue。refundLineItemRefundedAmount— そのラインの返金額(ショップ通貨)。refundLineItemRefundedPresentmentAmount— そのラインの返金額(ショッパー通貨)。
5. フィルター
Section titled “5. フィルター”エクスポート時に結果セットを絞り込むために使用します:
Id— 正確な注文ID。Name— Shopify注文番号(例:#1001)。CreatedAt— 作成日/範囲。ProcessedAt— 支払い処理日/範囲。UpdatedAt— 最後の変更日/範囲。ClosedAt— 注文がクローズされた日/範囲。CancelledAt— キャンセル日/範囲。CancelReason— キャンセルの理由(CUSTOMER、INVENTORY、…)。FinancialStatus—PENDING、PAID、PARTIALLY_PAID、REFUNDED、…DisplayFinancialStatus— UI用の集約された財務ステータス。FulfillmentStatus—UNFULFILLED、PARTIALLY_FULFILLED、FULFILLED、…DisplayFulfillmentStatus— UI用の集約されたフルフィルメントステータス。OrderFulfillmentStatus— 出荷ステータスフィルター(scheduled、in_progress、…)。ReturnStatus—NONE、PARTIALLY_RETURNED、RETURNED。RiskLevel—LOW、MEDIUM、HIGHの不正リスク。RiskRecommendation—ACCEPT、INVESTIGATE、CANCEL。ChargebackStatus—NONE、UNDER_REVIEW、WON、LOST。Gateway— 支払いゲートウェイ名(PayPal、Shopify Payments、…)。PaymentId— 特定の支払い識別子。PaymentProviderId— プロバイダー側の支払いID。CreditCardLast4— カードの最後の4桁。TransactionKind—AUTHORIZATION、CAPTURE、REFUND、…TransactionStatus—SUCCESS、FAILURE、PENDING。Test—true/false- テスト注文のみ。Channel— POS、オンラインストア、ドラフトなど。ChannelId— 内部販売チャネルID。SalesChannel— 人間が読めるチャネル名(Shop App、IG Shop、…)。SourceName— ソースタグ(web、pos、api、draft_order)。SourceIdentifier— 外部POS/サードパーティの注文ID。CheckoutToken— チェックアウトセッショントークン。CartToken— 注文に結びつけられたカートID。DeliveryMethod—SHIPPING、LOCAL_PICKUP、LOCAL_DELIVERY。FulfillmentLocationId— 注文をフルフィルメントした場所。ReferenceLocationId— POS/起源の場所参照。LocationId— 注文が作成された店舗の場所。PoNumber— 購入注文参照番号。ConfirmationNumber— 外部確認/領収書番号。Sku— 特定のSKUを含む注文。SubtotalLineItemsQuantity— 合計アイテム数量(範囲をサポート)。DiscountCode— 特定の割引コードを使用した注文。Tag— 特定のタグでタグ付けされた注文。Email— 顧客のメールアドレスの一致。Phone— 顧客の電話番号の一致。CustomerId— 1人の顧客のすべての注文。CustomerState—ENABLED、INVITED、DECLINED、DISABLED。CompanyId— B2B会社ID。FraudProtectionLevel—NOT_PROTECTEDまたはPROTECTED。Status—OPEN、CLOSED、CANCELLED。CartToken— 元のカートトークンでフィルター。ChargebackStatus— 注文のチャージバック状態。lastVisitUtmMedium— 購入時にキャプチャされたUTMメディア。
お困りですか?サポートチームが24時間以内にお答えします。
追加フィールド
Section titled “追加フィールド”このエンティティに対してDataEaseがサポートするその他の列:
discountCodes— 注文に適用された割引コード。note— 注文に関する内部ノート。customAttributes— JSON形式での注文のカスタム属性。retailLocationId— 注文に関連付けられた小売場所のID。isTest— 注文がテスト注文であることを示します。refundOnCancellation— キャンセル時に注文を返金するかどうか。storeCreditRefundExpiration— ストアクレジット返金の有効期限。restockOnCancellation— 注文キャンセル時にアイテムを再入荷するかどうか。sourceUrl— 注文が発生したURL。lastVisitReferrerUrl— 注文が行われる前の最後のリファラーのURL。inventoryBehaviour— 注文の在庫動作。sendFulfillmentReceipt— 顧客にフルフィルメントレシートを送信するかどうか。sendReceipt— 顧客に注文レシートを送信するかどうか。notifyCustomerOnUpdate— 注文が更新されたときに顧客に通知します。updateOrderStaffNote— 注文に更新するスタッフノート。freeShippingDiscountCode— 無料配送の割引コード。fixedDiscountShopAmount— ショップ通貨での固定割引額。fixedDiscountPresentmentAmount— プレゼンテーション通貨での固定割引額。fixedDiscountCode— 固定額割引の割引コード。percentageDiscountCode— 割引率の割引コード。percentageDiscountCodePercentage— 割引コードの割合値。orderFulfillmentLocationId— 注文フルフィルメントの場所ID。orderFulfillmentShipmentStatus— 注文フルフィルメントの出荷ステータス。orderFulfillmentNotifyCustomer— 注文フルフィルメントについて顧客に通知します。orderFulfillmentTrackingCompany— 注文フルフィルメントのトラッキング会社。orderFulfillmentTrackingNumber— 注文フルフィルメントのトラッキング番号。customerEmail— 顧客のメールアドレス。customerFirstName— 顧客の名。customerLastName— 顧客の姓。customerNote— 顧客からのノート。customerPhone— 顧客の電話番号。customerTaxExempt— 顧客が税金免除であることを示します。billingFirstName— 請求先の名。billingLastName— 請求先の姓。billingName— 請求先のフルネーム。billingCompany— 請求先の会社名。billingPhone— 請求先の電話番号。billingAddress1— 請求先住所の1行目。billingAddress2— 請求先住所の2行目。billingCity— 請求先の都市。billingCountry— 請求先の国。billingCountryCode— 請求先の国コード。billingZip— 請求先の郵便番号。billingProvince— 請求先の州/県。billingProvinceCode— 請求先の州/県コード。shippingFirstName— 配送先の名。shippingLastName— 配送先の姓。shippingName— 配送先のフルネーム。shippingCompany— 配送先の会社名。shippingPhone— 配送先の電話番号。shippingAddress1— 配送先住所の1行目。shippingAddress2— 配送先住所の2行目。shippingCountryCode— 配送先の国コード。shippingZip— 配送先の郵便番号。shippingProvinceCode— 配送先の州/県コード。lineItemId— ラインアイテムのID。lineItemTaxable— ラインアイテムが課税対象であることを示します。lineItemTitle— ラインアイテムのタイトル。lineItemVariantBarcode— ラインアイテムバリアントのバーコード。lineItemVariantTitle— ラインアイテムバリアントのタイトル。lineItemVendor— ラインアイテムのベンダー。lineItemUnitPrice— ラインアイテムの単価。lineItemUnitPresentmentPrice— ラインアイテム単位のプレゼンテーション価格。lineItemIsGiftCard— ラインアイテムがギフトカードであることを示します。lineItemRequiresShipping— ラインアイテムが配送を必要とすることを示します。lineItemProductId— ラインアイテムの製品ID。lineItemCustomAttributes— JSON形式でのラインアイテムのカスタム属性。lineItemLocationId— ラインアイテムの場所ID。LineItemQuantityRestock— ラインアイテムの再入荷数量。LineItemAllowDuplicates— 重複するラインアイテムを許可します。fulfillmentId— フルフィルメントのID。fulfillmentTrackingUrls— フルフィルメントのトラッキングURL。fulfillmentAddress1— フルフィルメント住所の1行目。fulfillmentAddress2— フルフィルメント住所の2行目。fulfillmentCity— フルフィルメントの都市。fulfillmentCountryCode— フルフィルメントの国コード。fulfillmentProvince— フルフィルメントの州/県。fulfillmentProvinceCode— フルフィルメントの州/県コード。fulfillmentZip— フルフィルメントの郵便番号。fulfillmentMessage— フルフィルメントのメッセージ。shippingLineId— 配送ラインのID。shippingLineCode— 配送ラインのコード。transactionId— 取引のID。transactionPresentmentAmount— 取引のプレゼンテーション金額。transactionAuthorizationCode— 取引の認証コード。transactionGateway— 取引の支払いゲートウェイ。transactionTest— 取引がテストであることを示します。transactionParentTransactionId— 親取引ID。transactionGiftCardId— 取引で使用されたギフトカードID。transactionReceiptJson— JSON形式での取引レシート。refundNote— 返金のノート。refundDiscrepancyReason— 返金の不一致理由。refundNotifyCustomer— 返金について顧客に通知します。refundFullShippingAmount— 配送料全額を返金します。refundShippingPresentmentAmount— 配送料返金のプレゼンテーション金額。lineType— ラインアイテムのタイプ。taxLines— 注文に関連付けられた税ライン。