Japan-Ready BASE Product CSV to Shopify Draft Converter

Convert a Japanese BASE product CSV into a Shopify CSV for new draft products. Supports UTF-8 / Shift_JIS, basic one-axis variants, JAN / GTIN, leading zeros, and product-level validation / quarantine. This prepares files for human review; it does not connect to BASE or Shopify.

BASE「CSV商品管理 App」の既存通常商品CSVを、Shopifyの新規・下書き商品CSVへ整形・検査します。JPY・単一在庫ロケーション・手動配送の通常商品を前提とします。画像移行、Shopify自動登録、既存商品更新、複雑な複数軸バリエーションは対象外です。

Try the fictional CSV sample

1. Click “Try for free.” Copy the fictional CSV below and paste it into “CSV text (UTF-8)” (csvText). Leave “CSV bytes in base64” (csvBase64) empty. Set “Input encoding” to auto or utf-8. Use only one of the two CSV input fields.
2. For this fictional sample, enable “JPY store,” “Single inventory location,” and “Physical goods with manual fulfillment.” When using your own data, enable each setting only if it matches your actual store and products.
3. Run the Actor, then review shopify_import.csv, quarantine.csv, errors.json, warnings.json, and summary.json. Before importing into Shopify, check draft status, prices, inventory, SKUs, warnings, and quarantine reasons.

To provide an original Shift_JIS file without changing its bytes, encode the file as Base64 and enter it in csvBase64. Leave csvText empty and set “Input encoding” to shift_jis. Do not paste Shift_JIS file bytes directly into csvText.

商品ID,商品名,価格,在庫数,種類ID,種類コード,JAN/GTIN,種類名,種類在庫数,画像1
0001,完全架空サンプルＡ,1000,3,,,,,,fictional-a.jpg
0002,完全架空サンプルＢ,1200,,01,00001,01234565,小,2,
0002,完全架空サンプルＢ,1200,,02,00002,0000000000000,大,4,
0003,完全架空エラー確認用,要相談,1,,,,,,

バーコードはチェックデジット計算用の架空値です。正式な発行や商品への割当てを示さず、実商品の登録に使わないでください。サンプルは種類なし1行、基本1軸種類2行、不正価格による隔離確認1行で構成されています。

設計上の期待結果: 入力4行、draft出力3行、隔離1行。SKU 00001 / 00002 とGTINの先頭ゼロを保持し、不正価格は商品単位で隔離します。画像は移行せず警告します。警告付きの正常出力行もあるため、件数だけでなく5ファイルを確認してください。

Encoding and input limits

UTF-8（BOM可）とShift_JISを厳密にデコードします。autoで異なる解釈が成立する場合は停止し、文字コードの明示を求めます。CP932固有の拡張文字は対象外です。テキスト貼り付けだけでは元ファイルのShift_JISバイト列を検査できません。入力上限は14,000,000 bytesです。表計算ソフトでSKUやJANを数値化しないでください。

出力

ファイル	内容
shopify_import.csv	現行Shopify商品CSVの列名。UTF-8、改行LF、全行draftかつオンライン非公開
quarantine.csv	隔離された元商品グループの行。元データとデータレコード番号付き。Shopifyへ投入しない
errors.json	商品ID、レコード番号、対象欄、エラーコード。元の長い文字列は入れない
warnings.json	画像別移行、JAN不正、税設定確認、SKU空欄等
summary.json	件数、ヘッダー、文字コード、対象外列、未確認条件

5ファイルはRunのOutputまたはStorage → Key-value storeから取得できます。default Datasetには件数・文字コード・draft状態などの安全な集計1件だけを保存します。商品名、説明、商品ID、SKU、JAN、入力CSV本文はDatasetへ複製しません。

範囲と列の扱い

• 商品ID はBASE内の商品キー。文字列として保持し、base-<商品ID> のURL handleを決定的に生成します。既存Shopifyストアとのhandle衝突はオフラインでは確認できません。
• 同じ商品IDの行を一商品として扱います。商品名・価格等が矛盾した場合は商品グループ全体を隔離します。種類IDは商品IDと混同しません。
• 種類なしは 在庫数、種類ありは各行の 種類在庫数 を使用。種類コードをSKU候補とし、種類なしでは商品コードを候補とします。SKUが空欄なら警告、重複なら隔離です。
• 種類名は1軸の Option1 name=種類、各値を Option1 value へ。種類なしは Default Title。複数種類で種類ID／種類名が欠落・重複したら隔離します。
• BASEの JAN/GTIN は任意の英数字を含み得ます。数字8/12/13/14桁とチェックディジットに合格した値のみ Barcodes=gtin:<値> へ。先頭ゼロを保持。不正値は空欄と警告です。
• 商品名は表示内容を尊重します。説明はHTMLをエスケープして改行を <br> として保持。価格は50円以上の半角整数、在庫は0〜10,000の半角整数だけを受け付けます。空欄は0にしません。
• 画像列はファイル名であり、Shopifyの公開画像URLではありません。URL生成も画像取得もせず、警告のみ。税率、BASEの公開状態、表示順、未知列は自動対応しません。
• Status=draft、Published on online store=false、Inventory tracker=shopify、Continue selling when out of stock=deny、Fulfillment service=manual、Requires shipping=true を対象条件の下で出力します。

取込前確認

1. CSVをShopifyへ入れる前に、既存handleと重複しないこと、既存商品を上書きしない取込設定、下書き／非公開のプレビューを確認してください。
2. ShopifyストアがJPY・単一在庫ロケーション・手動配送の通常商品であることを確認してください。BASEの価格は税込として登録される一方、Shopifyの税設定は店ごとに異なります。本ツールは税設定を移しません。
3. 画像を別途用意してください。BASE公式は登録済み画像の一括ダウンロードに対応していません。Shopify CSVの画像欄には公開アクセスできるURLが必要です。
4. セール適用中のBASE編集用CSVは割引後価格の場合があります。通常価格と誤認しないよう取込前に確認してください。

Storage, permissions and scope

処理、入力保存、5出力ファイルの保存はApify上で行います。商品データを外部LLMや別の商品データサービスへ送信しません。BASE / Shopifyへの接続、ログイン情報、OAuthは不要です。ActorはLimited permissionsを使用します。

ファイル全体の問題（入力方式、文字コード、必須ヘッダー、前提条件）は実行エラーで停止します。一部商品を隔離した場合は5ファイルを保存して正常終了します。正常終了は全商品が取り込み可能という意味ではありません。

Validation and limitations

2026-09-29の非公開クラウドQAではUTF-8 / Shift_JIS、種類なし・基本1軸、先頭ゼロ、不正GTINの警告、不正価格・在庫の隔離、画像警告、CSV引用符・セル内改行、5出力ファイルを確認しました。1 / 10 / 500 / 1,000行の架空データ実行を確認済みです。Shopify実ストアへのインポートは未検証です。

不正GTINは出力バーコードを空欄にして警告します。必ずしも商品隔離にはなりません。価格・在庫等の商品エラーは同じ商品IDのグループ全体を隔離します。Shopify上の既存handleとの衝突は確認しないため、取込プレビューを利用者が確認してください。

Pricing — Pay per event

$0.001 per successfully exported input row = $1.00 / 1,000 successfully exported rows.

正常にShopify用draft CSVへ出力された入力行だけ、exported-row（Exported row）として課金します。隔離行、エラー行、ファイル全体エラー、Actor start、summary、Dataset summaryへの追加イベント課金はありません。Store pricing discountsはOFFです。Apifyの通常プラットフォーム使用料はこのイベント価格に含まれます。

同一Runの完了後の再開では課金イベントを再送しません。課金結果が不確実な中断状態の再開は、二重課金を避けるため停止します。別の新規Runは別の処理です。利用者のRun支出上限が不足する場合は処理を停止します。

Official references

• BASE CSV商品管理 App
• BASE 複数種類の商品行
• Shopify 商品CSV仕様