5.3 KiB
5.3 KiB
給与システム - クイックスタートガイド
セットアップ手順
1. データベーススキーマの適用
# PostgreSQLに接続(環境に応じて認証情報を変更)
$env:PGPASSWORD = "your_password"
psql -U your_user -d your_database -f backend/sql/payroll_schema.sql
または、既存のデータベース接続を使用している場合:
# Pythonスクリプトで実行する場合
cd backend
python -c "
from app.core.database import get_connection
with open('sql/payroll_schema.sql', 'r', encoding='utf-8') as f:
sql = f.read()
with get_connection() as conn:
with conn.cursor() as cur:
cur.execute(sql)
conn.commit()
print('給与システムのスキーマを適用しました')
"
2. サーバーの起動
cd backend
uvicorn app.main:app --reload
3. ブラウザでアクセス
http://localhost:8000/static/payroll.html
初期データのセットアップ
1. 保険料率の確認
システムには以下の初期保険料率が登録されています(2026 年度):
- 健康保険: 10.00% (労使折半 各 5.00%)
- 厚生年金: 18.30% (労使折半 各 9.15%)
- 雇用保険: 1.55% (従業員 0.6% + 事業主 0.95%)
- 労災保険: 0.30% (事業主のみ)
必要に応じて「税率・保険料設定」画面で更新してください。
2. 所得税率表のインポート
サンプル CSV ファイルが backend/income_tax_sample.csv に用意されています。
- 「税率・保険料設定」画面を開く
- 「所得税率表」タブを選択
- 「CSV インポート」ボタンをクリック
income_tax_sample.csvを選択- 適用開始日を入力(例: 2026-01-01)
3. 従業員の登録
- 「従業員管理」画面を開く
- 「新規登録」タブを選択
- 必要な情報を入力:
- 従業員コード(必須)
- 氏名(必須)
- 入社日(必須)
- その他の情報(任意)
- 「登録」ボタンをクリック
4. 扶養家族の登録(必要な場合)
- 「従業員管理」画面で従業員を選択
- 従業員詳細画面の「扶養家族」セクションで追加
5. 給与設定の登録
- 「給与設定」画面を開く
- 従業員を選択
- 「新規設定追加」ボタンをクリック
- 給与情報を入力:
- 基本給(必須)
- 雇用形態(必須)
- 支給形態(必須)
- 通勤手当(任意)
- 適用開始日(必須)
- 「保存」ボタンをクリック
給与計算の実行
月次給与計算の手順
- 「月次給与計算」画面を開く
- 「新規計算」ボタンをクリック
- 給与計算情報を入力:
- 従業員を選択
- 対象年月
- 支給日
- 勤怠情報(出勤日数、勤務時間、残業時間など)
- その他(住民税、その他控除など)
- 「計算実行」ボタンをクリック
- 給与明細を確認
- 問題なければ「承認」ボタンをクリック
給与明細の見方
支給項目
- 基本給: 設定された基本給(欠勤がある場合は控除後)
- 残業手当: 残業時間 × 時給 × 1.25
- 休日手当: 休日出勤時間 × 時給 × 1.35
- 通勤手当: 設定された通勤手当
- その他手当: 入力されたその他手当
- 総支給額: 上記の合計
控除項目
- 健康保険: 総支給額 × 5.00%
- 厚生年金: 総支給額 × 9.15%
- 雇用保険: 総支給額 × 0.60%
- 所得税: 所得税率表に基づいて計算
- 住民税: 入力された金額
- その他控除: 入力された金額
- 総控除額: 上記の合計
差引支給額 = 総支給額 - 総控除額
よくある質問
Q1: 給与を再計算するには?
A: 給与明細画面で「再計算」ボタンをクリックしてください。ただし、承認済みの給与は再計算できません。
Q2: 承認済みの給与を修正するには?
A: 承認済みの給与は変更できません。給与を削除して新規に計算し直す必要があります。
Q3: 時給制の従業員の給与計算は?
A: 給与設定で「支給形態: 時給」を選択し、時給を入力してください。基本給は「時給 × 勤務時間」で自動計算されます。
Q4: 所得税が 0 円になる
A: 所得税率表が登録されていない可能性があります。「税率・保険料設定」画面で所得税率表を確認してください。
Q5: 扶養家族の人数が所得税に反映されない
A: 扶養家族の「有効期間」を確認してください。計算対象月に有効な扶養家族のみがカウントされます。
トラブルシューティング
エラー: 「給与設定が見つかりません」
→ 「給与設定」画面で該当従業員の給与設定を登録してください
エラー: 「保険料率が見つかりません」
→ 「税率・保険料設定」画面で保険料率を確認・登録してください
所得税が正しく計算されない
→ 所得税率表が正しくインポートされているか確認してください → 扶養家族の有効期間が正しく設定されているか確認してください
サポート
詳細なドキュメントは docs/payroll_system.md を参照してください。