CSV インポート

CSV インポートは、会社・取引・コンタクトをまとめて登録・更新するための機能です。既存データの移行や、他システムからの一括取り込みに使えます。 出力用途は CSV エクスポート を参照してください。

​

始める前に

• インポートの実行は編集者以上のロールが必要です。
• 対応オブジェクト: 会社・取引・コンタクト
• カスタムプロパティ列も同時に取り込めます。カスタム列の追加は プロパティ を参照してください。

​

CSV ファイルの制約

インポートする CSV ファイルは次の条件を満たす必要があります。

• 文字コード: UTF-8 / Shift_JIS / EUC-JP / CP932 (アップロード時に自動判定)
• ファイルサイズ: 10 MB 以下
• 行数: ヘッダー行を除き 10,000 行以下
• 日付列の形式: YYYY-MM-DD (例: 2026-07-13)。YYYY/MM/DD はエラーになります
• 必須列: 会社は 会社名、取引は 取引名、コンタクトは 姓・名・メールアドレス のうち少なくとも 1 つ

​

CSV でインポートする

1. インポートしたい対象 (会社・取引・コンタクト) の一覧画面を開きます。
2. 右上のメニューから CSVインポート を選びます。

3. ファイルをアップロード から CSV を選択します。
4. 表示された CSV の各列を、Stockwork のプロパティに対応付けます。列名がプロパティの表示名または API 名と一致する場合は自動でマッピング候補が選ばれます。
5. プレビューでバリデーションエラーの有無を確認します。必須列の抜け、日付形式の不一致、参照先が見つからない行などがここで検出されます。
6. 問題なければ インポート開始 をクリックします。
7. インポート完了後、履歴画面で作成件数・更新件数・警告件数・エラー件数を確認します。エラー行は行番号付きで CSV としてダウンロードできます。

​

既存データの更新条件

インポート時に既存レコードを更新するかどうかは、CSV でマッピングした列によって決まります。

• レコード ID 列をマッピングした場合: レコード ID のみで照合します。ID が一致するレコードは更新、ID が空欄や不一致の行は新規レコードとして作成されます。メールアドレスによる照合は行われません。
• レコード ID 列をマッピングしていない場合 (コンタクトのみ): メールアドレスで組織内を照合します (大文字小文字は無視、前後の空白はトリム)。一致するレコードがあれば更新、なければ新規作成されます。
• 上記のいずれにも当てはまらない場合: すべての行が新規レコードとして作成されます。会社 CSV は、同名の会社が既にあっても常に新規レコードとして登録される点に注意してください。

​

会社と取引・コンタクトを紐づける

取引やコンタクトのインポートで会社と紐づけたい場合、CSV に会社の情報を含めます。

• 会社レコード ID: 確実に会社を指定したい場合はこの列を使用します。ID が見つからない行は「会社を関連付けずに取り込みました」の警告になります。
• 会社名: 会社名が組織内で一意に一致した場合のみ紐付きます。同名の会社が複数ある場合は「複数の会社が一致しました」というエラーになります。

​

カスタムプロパティを扱う

プロパティ で追加したカスタム列も、CSV のマッピング候補として選べます。CSV のヘッダー名がプロパティの表示名または API 名と一致すれば自動でマッピング候補に入ります。

​

トラブルシューティング

• 「日付形式が不正です」で行が弾かれる: YYYY-MM-DD のみが有効です。2026/7/13 のようなスラッシュ区切りや 2026年7月13日 はエラーになります。CSV の日付列を修正して再インポートしてください。
• 「ファイルサイズが上限を超えています」と表示される: 10 MB を超えるファイルはインポートできません。会社・取引・コンタクトなどの対象ごとにファイルを分割してください。
• 文字化けした状態でプレビューが表示される: 文字コード検出に失敗したケースです。CSV を UTF-8 で保存し直してから再アップロードしてください。
• 「会社が見つかりません」で警告になる: 取引・コンタクトの CSV に指定した会社レコード ID または会社名が組織内に存在しないケースです。ID や表記の揺れ (株式会社 と (株) など) を確認してください。

​

関連ページ

• CSV エクスポート
• 会社
• 取引
• コンタクト
• プロパティ