監理費請求 - 新規登録・編集 API


概要

{primary} 検索条件にて絞り込んだ監理費請求のレコードのリストを返却します。

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

監理団体アカウントはマスター、管理者、一般に制限なく全ての監理費請求を作成・編集可能です。

実習実施先アカウントは新規作成は出来ません。自身の監理費請求のみ編集可能です。


エンドポイント

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

ROUTEパラメータ

パラメーター名 内容 特記

リクエストパラメータ

パラメーター名 必須 内容 特記
id int 請求書ID 新規作成時NULL / 編集時のみ必須
company_id int 実習実施先ID
company_office_id int 実習実施先事業所ID
registration_number string 登録番号
publishing_date datetime 請求書発行日
payment_deadline datetime 支払期限
email string メールアドレス
addressee string 宛名
subject string 件名
subtotal_amount int 小計
total_amount int 合計
items[][name] json 品目[名前]
items[][unit_price] json 品目[単価]
items[][quantity] json 品目[数量]
items[][unit] json 品目[単位]
items[][taxable_type ] json 品目[税区分] 1:課税, 2:非課税
items[][item_price ] json 品目[価格]
remarks string 備考

レスポンス

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

ステータスコード:200

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

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


バリデーション

画面項目名 フィールド名 チェック内容 備考
実習実施先ID company_id required
実習実施先事業所ID company_office_id required
登録番号 registration_number nullable
請求書発行日 publishing_date required
日付チェック
支払期限 payment_deadline required
日付チェック
メールアドレス email nullable
型チェック
宛名 addressee required
件名 subject required
max:255
小計 subtotal_amount required
numeric
max:2147483647
合計 total_amount required
numeric
max:2147483647
品目[名前] items[][name] required
max:100
品目[単価] items[][unit_price] required
numeric
max:2147483647
品目[数量] items[][quantity] required
numeric
max:2147483647
品目[単位] items[][unit] required
max:10
品目[税区分] items[][taxable_type ] required
品目[価格] items[][item_price ] nullable