A-04 管理画面法人の新規登録¶

業務の流れ：01 契約・初期設定の 1 法人を登録する

画面¶

A-04 法人の新規登録

説明文は ReDPL を利用する法人(テナント) を登録します です。

法人番号（13 桁）を入れて入力欄から離れると、国税庁のデータベースに問い合わせて、法人名・カナ・住所・郵便番号を自動で入れます。 手で打ち直す手間と、打ち間違いを無くすためです。

自動で入った項目は書き換えられない状態になります。公的なデータと食い違う値が入らないようにするためです。

結果	メッセージ
取得できた	`国税庁から法人情報を取得しました`
見つからない	`該当する法人番号が見つかりませんでした`
混んでいる	`国税庁 API が混雑しています。時間を空けて再試行してください`
つながらない	`国税庁 API に接続できません`
その他	`法人番号の照会で予期しないエラーが発生しました`

フォームの幅は 760px で中央に寄せます。画面いっぱいに広げると 1 行が長くなりすぎて、どのラベルの入力欄か目で追えなくなるためです。保存のボタンは 画面下に固定します。項目が多いと画面外に出てしまい、「どこで保存するのか」を探すことになるためです。

必須の項目は最初のカードにまとめて開いた状態で出し、任意の項目はブロックごとに畳んでおきます。 全部見せると「どこまで埋めれば登録できるか」が分かりません。畳んだ見出しには中に入っている項目名を小さく並べます。

畳んだブロックの中に入力の誤りがあると、そのブロックは自動で開き、見出しに 入力を確認してください が出ます。閉じたまま「登録できません」とだけ出ると、どこが悪いのか分からないためです。

ラベル	必須	形式	上限	初期値	入力例の表示	エラーメッセージ
法人番号	必須	13 桁の数字（検査用数字つき）	13	空	—	形式が違う／検査に通らないときのエラー
法人名	必須	自由入力	200	自動入力	—	`法人名は必須です` ／ `法人名は200文字以内で入力してください`
法人名カナ	任意	全角カタカナ	200	自動入力	—	`カタカナで入力してください` ／ `法人名カナは200文字以内で入力してください`
テナントスラッグ	必須	英小文字・数字・ハイフン	63	空	—	`tenant_slug は必須です` ／ `tenant_slug は63文字以内で入力してください` ／ `tenant_slug は英小文字・数字・ハイフンのみ使用でき、先頭末尾はハイフン不可です` ／ `予約語のため使用できません`
プラン	必須	`フリー` / `スタンダード` / `従量課金`	—	未選択	`プランを選択`	`プランを選択してください`
代表者名	任意	自由入力	100	空	—	`代表者名は100文字以内で入力してください`
電話番号	任意	10 桁または 11 桁の数字	—	空	—	`電話番号は10桁または11桁の数字で入力してください`
郵便番号	任意	7 桁の数字	8	自動入力	`例）123-4567`	`郵便番号は7桁の数字で入力してください`
住所	任意	自由入力	200	自動入力	—	`住所は200文字以内で入力してください`

会社ごとの URL に使う短い名前です。gipple と決めると、その会社の画面は gipple.redpl.app になります。

入力している間に、その名前が使えるかを調べて下に出します。登録してから「使えません」と言われないようにするためです。

結果	表示
使える	利用できる旨
既に使われている	既に使用されている旨
形が違う	形式が正しくない旨
予約語	使えない旨（`admin` `api` `app` `auth` `docs` `help` `login` `logout` など）

予約語を禁じているのは、admin.redpl.app のようなシステムが使う URLとぶつかるためです。

登録したあとは変えられません。 配った URL が使えなくなるためです。

ボタン	何が起きるか	成功したとき	失敗したとき
登録する	会社を作る	`法人を登録しました` → A-03 一覧へ	入力欄の下にエラーが出ます
キャンセル	前の画面へ戻る	—	—

Gipple 管理者のみ。

使う API	いつ
`GET /api/tenants/lookup-corporate-number/`	法人番号を入れて離れたとき
`GET /api/tenants/slug-availability/`	スラッグを入力している間（500 ミリ秒ごと）
`POST /api/tenants/`	登録したとき