計画認定プロジェクト - 新規登録 API

概要

{primary} 計画認定プロジェクトの新規登録を行います。

監理団体アカウントで、ステータスが 5:利用中 のユーザのみ利用できます。

監理団体アカウントはマスター、管理者、一般に制限なく新規作成可能です。

実習実施先アカウントは新規作成は出来ません。

エンドポイント

メソッド URI Headers
POST /api/application Default

ROUTEパラメータ

  • 本APIにはROUTEパラメータはありません。

リクエストパラメータ

パラメーター名 必須 型 内容 特記
company_id 〇 int 実習実施先ID
target_trainee_class 〇 int 対象技能実習区分 次の技能実習区分です。
trainees.*.trainee_id 〇 json / int 技能実習生ID
trainees.*.entry_expected_date 〇 json / date 入国予定日
trainees.*.company_office_id 〇 json / int 実習実施先事業所ID

レスポンス

成功時
パラメーター名 型 内容 特記
result boolean リクエスト結果 true
errors array 成功のためエラーがないので空配列が返ってきます 
{
    "result"   : true,
    "errors"   : "",
    "data"     : [],
}
失敗時

ステータスコード：200

パラメーター名 型 内容 特記
result boolean リクエスト結果
error List 失敗した理由を配列 
{
  "result"   : false,
  "errors"   : {
    'error'       : ['失敗しました'],
  },
  "data"     : "",
}

{danger} 失敗時は200以外のエラーコードが返却されます。共通ルールのレスポンスをチェック。

データストア / 計画認定プロジェクト

  • appdoc_projectsテーブル
論理名 物理名 バリデーション 備考
ID id - 自動採番により登録されます。
実習実施先ID company_id required / (※)ID存在チェック
計画プロジェクトステータス project_status - 新規登録時に固定値でenum : ProjectStatusの2:作成中を登録します。
作成日時 company_office_id - 現在日時を登録します。
最終更新日時 registration_number - 現在日時を登録します。

データストア / 計画認定プロジェクト 技能実習生

  • appdoc_traineesテーブル
論理名 物理名 バリデーション 備考
ID id - 自動採番により登録されます。
計画認定プロジェクトID appdoc_project_id - appdoc_projectsのレコード作成時の主キーの値を登録します。
実習実施先ID company_id required / (※)ID存在チェック
実習実施先 事業所ID company_office_id required / (※)ID存在チェック
技能実習生ID trainee_id required / distinct / (※)ID存在チェック / (※)重複チェック 他の計画認定プロジェクトにて進行中の場合は重複して計画認定プロジェクトに追加できません。
計画認定プロジェクトステータス project_status - @todo未定
入国予定日 engtry_expected_date reqired / 日付形式:Y/m/d
作成日時 company_office_id - 現在日時を登録します。
最終更新日時 registration_number - 現在日時を登録します。