商品ライブラリのインポートに関するトラブルシューティング
商品マスタをインポートできない場合、Excel（.xlsx）またはコンマ区切り値（.csv）スプレッドシートの書式設定または構文に不具合が生じている可能性があります。
この記事では、商品マスタのインポートに関する詳細なトラブルシューティングについて説明します。多くの場合、以下のトラブルシューティング手順で不具合を解消できます。
はじめる前に
トラブルシューティングの手順は、不具合に応じて、Square データまたは商品ライブラリのスプレッドシートから直接行えます。
アップロードを試みている商品マスタのサイズによっては、インポートスプレッドシートのエラーを修正するのに時間がかかる場合があります。商品ライブラリのインポートは、営業時間外、または業務への影響が最も少ない時間帯に行うことをお勧めします。
以下の手順は、所要時間が少ないものから昇順に並んでいます。最初の手順で不具合が解消した場合、トラブルシューティングを続ける必要はありません。解消しない場合は、順番どおりに次の手順に進んでください。
ステップ1. 一般的な商品インポートに関するトラブルシューティング
以下の手順は、商品マスタをインポートする際の一般的な不具合に対するトラブルシューティングのガイドラインです。
一般的なファイル書式設定に関する不具合を解消するには、以下のトラブルシューティングをお試しください。
- Square データから最新のテンプレートを使っていることをご確認ください。商品ライブラリからアクセスするには、[アクション] > [商品ライブラリをエクスポート] > [エクスポート] の順にクリック します。
- ファイルは必ず.xlsxまたは.csv形式で保存してください。商品インポートツールは、.xls、.xlsm、またはその他のファイル形式では機能しません。
- ダウンロードしたテンプレートのファイル名を変更しないでください。
- ファイルに追加したテキストからカンマを削除します（商品ライブラリにインポートした後で、商品名、説明、オプション、またはカスタマイズにカンマを再度追加できます）。
- テンプレートを編集する際に、以下のことを行わないでください。
- トークン列にある情報の変更
- 任意の列の並べ替え
- 空白の列の削除
- すべての商品に固有の名前があることを再確認します。
- 商品とそのバリエーションには、同一のカテゴリと説明が必要です。
Squareアカウント間で商品ライブラリを移動する場合、または初めて商品ライブラリを作成する場合は、新しいライブラリの税率とカスタマイズ項目を手動で作成してください。
ステップ2. 特定の商品インポートエラーのトラブルシューティング
スプレッドシートに誤りがあった場合、商品インポートツールがその旨を通知し、修正の手順を案内します。商品をインポートする前に、すべての不具合を解消してください。よく見られるシナリオは次のとおりです。
画像は、商品インポートツールからはアップロードできません。詳しくは、商品画像をアップロード・管理する方法をご覧ください。
スプレッドシートに単純なエラーが含まれている場合、インポートツールには、エラーを自動解決してインポートを完了するオプションが表示されます。簡単なエラーには、商品とバリエーションの説明が異なる、GTINの長さが正しくない、スプレッドシートの列がSquareの属性と一致しないなどがあります。エラー自動解決のタイプごとに、承認または却下のオプションを選択できます。
ステップ3. SKU（商品番号）エラーを修正する
商品番号エラーが表示された場合は、CSVファイルの商品番号の列に指数表記（例：2.68435E+17）がないかインポートファイルを確認します。
表記があった場合は、次の手順を行います。
- 商品インポート用のCSVファイルを開き、商品番号列全体を選択してハイライト表示します。
- 選択した列上で右クリックし、[セルの書式設定] を選択します。
- [数値] を選択し、小数点以下の桁数を0に変更し、[OK] をクリックします。
- [ファイル] > [名前をつけて保存] の順にクリックし、ファイル形式をカンマ区切り値（CSV）として保存します。
- [保存] をクリックします。
- 新しく保存されたファイルをSquare データにインポートします。
以下は、Excel（.xlsx）ではなく、CSVファイルをインポートした場合に該当します。
CSVデータをスプレッドシートにインポートすることはできますが、商品ライブラリに商品番号が含まれている場合は、CSVファイルを直接開かないでください。スプレッドシートエディタ（Excel、Numbersなど）によっては、予期しない方法で商品番号が変更されることがあります。たとえば、スプレッドシートエディタでは、先頭の0が削除（例：0012345→12345）されたり、商品番号が指数表記に変更（例：12345678999→1.2346E+10）されたりすることがあります。
商品番号の先頭には0をつけないようにしてください。よく発生する形式変換を解決するには、次のヒントをお読みください。
- Microsoft Excelでスプレッドシートを新規作成します。
- メインメニューで、[ファイル] > [インポート] の順に選択します。
- [CSVファイル] を選択し、[インポート] をクリックします。
- 商品ライブラリからエクスポートしたCSVファイルを選択し、[データを取得] をクリックします。インポートウィザードのポップアップが表示されます。
- [次へ] をクリックし、[カンマ区切り] のみが選択されていることを確認してからもう一度 [次へ] をクリックします。
- 商品番号列（クリックして商品番号列を選択）までスクロールして列のデータ形式を [文字列] に変更し、[完了] をクリックします。
- [新規シート] を選択し、[OK] を選択してインポートを完了します。