この記事では、CSVファイルを使って注文を効率よくインポートするための総合ガイドを紹介します。手入力をなくし、まとめて注文を取り込んで、注文管理をすっきりシンプルに。
インポート用にCSVファイルを準備する
インポートを始める前に、CSVファイルの構成が正しいか確認しよう。正確なデータ形式にするため、CSVテンプレートをダウンロードして使ってね。CSVの各行は1つの明細行を表し、1件の注文が複数行にまたがってもOK。明細行を対応する注文に結びつけるには、"orderReferenceId" 列を使おう。
注: ExcelでCSVを開いたときに列ヘッダーが1つの列にまとまって表示される場合は、次の回避策を試してください。
Googleスプレッドシートを使う：列が分かれた状態でCSVファイルを正しく開けます。
Excelで手動調整：各ヘッダーを別々の列に配置して、正しい形式に変換します。
各行には、注文の基本情報を入れてください。
注文参照ID
配送の詳細
商品詳細
各印刷領域のURL
CSVファイルで必要な項目の詳細な説明については、APIドキュメントの「Create order」ページを参照してください。インポートデータを効果的に構成するための有益なヒントが詰まった総合的なリソースです。 Create order
注文のインポート：ステップ・バイ・ステップガイド
注文をスムーズに取り込むには、次の手順に従ってください。
注文ページにアクセスし、"Import" ボタンをクリックしてください。
インポートする注文の指定ストアを選んでください。これらの注文は、選択したストアからの注文として表示されます。手動注文としてインポートすることもできます。
インポートしたい注文を含むCSVファイルをアップロードしてください。このページから新しいCSVテンプレートをダウンロードすることもできます。
正しい配送先ストアとインポートファイルを選んでいるか、もう一度確認してください。準備が整ったら、"Import" をクリックしてインポートを開始しましょう。
インポート処理の開始が確認されたことを知らせる通知が届きます。
インポートが完了したら、メールでお知らせします。メールには、次の内容を含むインポートの概要が記載されています。
インポートファイル内の注文の合計件数。
正常に取り込まれた注文数。
インポートに失敗した注文の数。
さらに、メールには詳細なインポート結果を含むCSVファイルが添付されます。ファイルには次の3列が含まれます。
注文参照ID
結果（各注文の「成功」または「失敗」を示します）
エラー（インポートが失敗した具体的な理由を提供）
インポート用CSVファイルの必須パラメータを理解する
以下に、必要なパラメーターの内訳と、それぞれに対応するドキュメントの参照先をまとめました。スプレッドシートを正確に完成させるために役立ててください。
この方法は、API 連携の前にプラットフォームをテストしている人や、スポットの注文を出す人が主に使います。
注文の基本情報
orderReferenceId – Gelatoのダッシュボードで注文番号を表示します。例：
G-250202201217。customerReferenceId – 内部の顧客ID参照。
orderType –
draftに設定できますが、デフォルトはorderです。shipmentMethodUid – 配送方法を指定します:
normal、standard、またはexpress。通貨 – 支払いに使用される通貨。
retailShippingPriceInclVat、retailCurrency、item.retailPriceInclVat – 分析や、税関フォームを含むプラットフォームのさまざまな領域で使用されます。
配送先住所の詳細
これらのパラメータは、標準的なチェックアウトの住所フィールドに対応します。
shippingAddress.firstName
shippingAddress.lastName
shippingAddress.addressLine1
shippingAddress.addressLine2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName
税務・コンプライアンスの詳細
shippingAddress.federalTaxId – 受取人の連邦納税者番号。ブラジルの受取人に対して CPF/CNPJ を提供するために使用します。ブラジルでは必須です。CPF の代わりに CNPJ を提供するには、
isBusinessをtrueに設定してください。shippingAddress.stateTaxId – 受取人の州税識別番号。ブラジルの受取人に対して IE を提供するために使用します。受取人が企業の場合、ブラジルでは必須です。この項目を入力するには、
isBusinessをtrueに設定してください。shippingAddress.registrationState – 受取企業が登録されている州（または各国で同等の地域）を示す米国の州コード、または他国の同等コード。受取人が企業の場合、ブラジルでは必須です。 この項目を送るには、
isBusinessをtrueに設定してください。
製品情報
item.itemReferenceId – 注文内の
Item Reference IDに対応します。ECプラットフォームの注文では自動的に割り当てられます。手動で作成する注文では、設定が必要です。item.productUid – Gelato の標準に合わせるため、製品 UID に関するガイドと製品のマッピング方法に従ってください。
item.storeProductVariantId – ストアのURLからバリアントIDを指定してください。例：
https://dashboard.gelato.com/stores/e92a3ee9-e494-41bf-a031-ca80e2fa3558/products/edit/04076663-f5a3-4701-af66-be932c676697。item.quantity – 注文された数量を指定します。
item.pageCount – 複数ページの製品（例：パンフレット）に必須です。
刺繍専用のパラメーター
刺繍デザインには、追加のパラメータが必要です。詳細は、Embroidery Guideを参照してください。
item.adjustProductUidByFileTypes
item.file1.id、item.file1.type、item.file1.url、item.file1.threadColors、item.file1.fitMethod、item.file1.fillMethod
item.file2.id、item.file2.type、item.file2.url、item.file2.threadColors、item.file2.fitMethod、item.file2.fillMethod
CSVベースの注文送信は、スプレッドシートの継続的な管理と印刷用ファイルの準備が必要になるため、API連携による、より効率的なフルフィルメントオプションの活用をおすすめします。こうした方法なら、作業効率を最適化し、手作業を減らせます。詳しくは、Gelato API ドキュメントをご覧ください。