Files
njts-accounting-core/docs/payroll_quickstart.md
2026-01-20 11:15:49 +09:00

5.3 KiB
Raw Blame History

給与システム - クイックスタートガイド

セットアップ手順

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 に用意されています。

  1. 「税率・保険料設定」画面を開く
  2. 「所得税率表」タブを選択
  3. 「CSV インポート」ボタンをクリック
  4. income_tax_sample.csv を選択
  5. 適用開始日を入力(例: 2026-01-01

3. 従業員の登録

  1. 「従業員管理」画面を開く
  2. 「新規登録」タブを選択
  3. 必要な情報を入力:
    • 従業員コード(必須)
    • 氏名(必須)
    • 入社日(必須)
    • その他の情報(任意)
  4. 「登録」ボタンをクリック

4. 扶養家族の登録(必要な場合)

  1. 「従業員管理」画面で従業員を選択
  2. 従業員詳細画面の「扶養家族」セクションで追加

5. 給与設定の登録

  1. 「給与設定」画面を開く
  2. 従業員を選択
  3. 「新規設定追加」ボタンをクリック
  4. 給与情報を入力:
    • 基本給(必須)
    • 雇用形態(必須)
    • 支給形態(必須)
    • 通勤手当(任意)
    • 適用開始日(必須)
  5. 「保存」ボタンをクリック

給与計算の実行

月次給与計算の手順

  1. 「月次給与計算」画面を開く
  2. 「新規計算」ボタンをクリック
  3. 給与計算情報を入力:
    • 従業員を選択
    • 対象年月
    • 支給日
    • 勤怠情報(出勤日数、勤務時間、残業時間など)
    • その他(住民税、その他控除など)
  4. 「計算実行」ボタンをクリック
  5. 給与明細を確認
  6. 問題なければ「承認」ボタンをクリック

給与明細の見方

支給項目

  • 基本給: 設定された基本給(欠勤がある場合は控除後)
  • 残業手当: 残業時間 × 時給 × 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 を参照してください。