このページでは、CSVファイルを使ったユーザー管理のアカウント新規作成・編集方法についてご説明します。

カラム名	意味	新規作成時	編集時	入力例
id	ユーザーID	空欄にする	必須（既存のIDを入力）	550e8400-e29b-41d4-a716-446655440000
last_name	姓	必須	必須	田中
first_name	名	必須	必須	太郎
last_name_kana	姓ふりがな	任意	任意	たなか
first_name_kana	名ふりがな	任意	任意	たろう
role	アカウント権限	必須	必須	ユーザー
status	在籍状況	必須	必須	在籍
departments	所属部署	任意	任意	営業部/東京支店
email_address	メールアドレス	必須	必須	tanaka@example.com
employee_id	従業員番号	任意	任意	EMP001
place	受取場所（標準の保管場所）	任意	任意	1F受付
phone_number	電話番号	任意	任意	03-1234-5678

権限（role）の入力値

以下のいずれかを日本語で入力してください。

入力値	説明
オーナー	すべての操作・設定変更が可能
管理者	アカウント管理・荷物管理・企業情報の編集が可能
ユーザー	自身に関する情報の閲覧・編集が可能
ゲスト	自分宛の荷物情報の閲覧のみ可能（ログイン不可）

在籍状況（status）の入力値

以下のいずれかを日本語で入力してください。

入力値	説明
在籍	通常の利用状態
休職	ログイン不可（アカウントは保持）
退職	ログイン不可

注意：退職にしたい場合は、権限を「ゲスト」に変更してください。アカウント権限が「ゲスト」以外（オーナー・管理者・ユーザー）で設定されている場合、在籍状況を「退職」に設定することはできません。

部署（departments）の入力ルール

階層構造の指定：スラッシュ（ / ）で区切ります。
例：営業部/東京支店/第一課
複数部署への所属：セミコロン（ ; ）で区切ります。
例：営業部/東京支店;開発部
※最初に記載した部署が本務部署、それ以降が兼務部署となります。
上限：所属できる部署は最大5部署まで、部署の階層は最大10階層までです。
CSVに入力された部署がトドケールに登録されていない場合、自動的に新規作成されます。

アカウントをCSVで新規作成する

ユーザー管理にアカウントをCSVで一括登録する方法です。

手順

１. 共通管理画面から「ユーザー管理」にアクセスします。

２. 画面右上の「＋」ボタンをクリックし、「CSVインポート」を選択します。

３. CSVテンプレートをダウンロードし、登録したいユーザー情報を入力します。

４. 作成したCSVファイルをアップロードします。

５. 処理の進行状況は、ベルマークの「お知らせアイコン」から確認できます。

ポイント

「id」列は必ず空欄にしてください。「id」が空の行は新規ユーザーとして作成されます。
権限が「ゲスト」以外のユーザーには、登録後にメールアドレス宛に初回ログイン用の仮パスワードが発行されます。
- 管理者、オーナー権限のアカウントは、仮パスワードの再発行を行うことができます。
- 詳細は「仮パスワードの発行/再発行を行う」をご参照ください。
必須項目（last_name、first_name、role、status、email_address）が未入力の場合、エラーになります。
既にトドケールに登録済みのメールアドレスを入力した場合、エラーになります。

登録済みアカウントをCSVで編集する

既存のユーザー管理データをCSVで一括編集する方法です。

手順

１. 共通管理画面から「ユーザー管理」にアクセスします。

２. 画面右上の「ダウンロード」ボタンをクリックし、現在のユーザー一覧データをCSVでエクスポートします。

３. ダウンロードしたCSVファイルを開き、変更したいアカウントの情報を編集します。

※新規アカウントを追加したい場合は、行を追加して「id」列を空欄にしてください。

４. 編集したCSVファイルを「CSVインポート」からアップロードします。

５. 処理の進行状況は、ベルマークの「お知らせアイコン」から確認できます。

編集で変更できる項目

既存アカウントの「id」を指定した行では、以下の項目を変更できます。

項目	変更内容の例
last_name / first_name	氏名の変更
last_name_kana / first_name_kana	ふりがなの変更
role	権限の変更（例：ユーザー → 管理者）
status	在籍状況の変更（例：在籍 → 休職）
departments	所属部署の変更・追加
email_address	メールアドレスの変更
employee_id	従業員番号の変更
place	受取場所の変更
phone_number	電話番号の変更

CSVに記載されていないユーザーの扱いについて

CSVファイルをアップロードすると、処理方法を選択する画面が表示されます。ここで「CSVファイルに記載されていないユーザーの扱い」を設定できます。

チェックボックスの操作方法

チェックなし（初期状態）
CSVに記載されたアカウントのみ追加・更新します。CSVに含まれない既存アカウントには一切影響しません。一部のアカウント情報だけを変更したい場合はこちらを選択してください。
「在籍状況を『退職』にする」にチェックを入れた場合
CSVに記載されたアカウントの追加・更新に加え、CSVに含まれない既存アカウントの在籍状況が「退職」に変更されます。ユーザー管理を最新の状態に一括更新したい場合に使用します。

注意：「在籍状況を『退職』にする」にチェックを入れると、CSVに含まれないアカウントは権限が「ゲスト」に上書きされ、システムにログインできなくなります。チェックを入れる際には確認ダイアログが表示されますので、内容を確認のうえ「OK」をクリックしてください。インポート前に、必ず現在のユーザー管理データをダウンロードしてバックアップを取ることを推奨します。

注意事項

全般

CSVインポートを実行できるのは、管理者またはオーナー権限を持つアカウントのみです。
CSV内に同じメールアドレスが複数行存在する場合、エラーになります。
1行目のヘッダー行は変更しないでください。ヘッダーが正しくない場合、ファイルのアップロード時にエラーが発生します。
CSVの文字コードはUTF-8で保存してください。

権限変更に伴うアカウントの自動処理

CSVインポートでは、権限と在籍状況の変更に応じて、ログインアカウントの作成・削除が自動的に行われます。

変更内容	自動処理
ゲスト → ユーザー以上（在籍/休職）	ログインアカウントが自動作成され、仮パスワードがメール送信されます
ユーザー以上 → ゲスト	ログインアカウントが自動削除されます
在籍 → 退職（ゲスト権限の場合のみ）	ログインアカウントが自動削除されます

部署に関する注意

CSVに入力された部署名がトドケールに未登録の場合、部署が自動的に新規作成されます。
部署のツリー構造は、スラッシュ（ / ）で区切って表現します。
例：「総務部」の下に「総務課」を配置したい場合 → 総務部/総務課

受取場所に関する注意

CSVに入力された受取場所がトドケールに未登録の場合、受取場所が自動的に新規作成されます。

エラーが発生した場合

ファイルアップロード時のエラー

原因	対処法
ファイル形式が CSV UTF-8 でない	ファイルの文字コードを UTF-8 に変更して再度アップロードしてください
1行目のヘッダーがテンプレートと異なる	テンプレートのヘッダー行をそのまま使用してください

インポート実行時のエラー

原因	対処法
CSV内にメールアドレスの重複がある	重複しているメールアドレスのいずれかを削除してください
権限と在籍状況の組み合わせが不正	退職にしたい場合は権限を「ゲスト」に変更してください
必須項目が未入力	last_name、first_name、role、status、email_address を確認してください
メールアドレスの形式が不正	正しいメールアドレス形式で入力してください
所属部署が5部署を超えている	所属部署を5つ以内に減らしてください
部署の階層が10階層を超えている	部署の階層を10階層以内に収めてください

インポート実行後のエラー

処理完了後にエラーが表示された場合、「問題のある箇所を確認」をクリックするとエラー内容が記載されたCSVファイルをダウンロードできます。該当箇所を修正し、再度インポートしてください。

上記に当てはまらない条件でエラーが発生する場合は、画面右下のチャットボットよりお問合せください。

CSVを使ったアカウントの新規作成・編集方法

目次

CSVファイルの仕様

カラム定義