{primary} 検索条件にて絞り込んだ監理費請求のレコードのリストを返却します。
監理団体アカウントで、ステータスが 5:利用中 のユーザのみ利用できます。
監理団体アカウントはマスター、管理者、一般に制限なく全ての監理費請求を作成・編集可能です。
実習実施先アカウントは新規作成は出来ません。自身の監理費請求のみ編集可能です。
| メソッド | URI | Headers |
|---|---|---|
/api/bill |
Default |
| パラメーター名 | 型 | 内容 | 特記 |
|---|
| パラメーター名 | 必須 | 型 | 内容 | 特記 |
|---|---|---|---|---|
| id | int | 請求書ID | 新規作成時NULL / 編集時のみ必須 | |
| company_id | 〇 | int | 実習実施先ID | |
| company_office_id | 〇 | int | 実習実施先事業所ID | |
| registration_number | string | 登録番号 | ||
| publishing_date | 〇 | datetime | 請求書発行日 | |
| payment_deadline | 〇 | datetime | 支払期限 | |
| 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 | |
| 日付チェック | |||
| メールアドレス | 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 |