BlueAI 受領請求書（Received Invoices）
受領した請求書の登録・承認・却下・支払管理を行います。
|
エンドポイント
| GET | /api/v1/received-invoices | 受領請求書一覧を取得 |
| POST | /api/v1/received-invoices | 受領請求書を登録 |
| GET | /api/v1/received-invoices/dashboard | ダッシュボードを取得 |
| GET | /api/v1/received-invoices/{id} | 受領請求書を取得 |
| PATCH | /api/v1/received-invoices/{id} | 受領請求書を更新 |
| DELETE | /api/v1/received-invoices/{id} | 受領請求書を削除 |
| POST | /api/v1/received-invoices/{id}/approve | 承認 |
| POST | /api/v1/received-invoices/{id}/reject | 却下 |
| POST | /api/v1/received-invoices/{id}/mark-paid | 支払済みにする |
GET
/api/v1/received-invoices受領請求書一覧を取得
認証が必要です— セッション Cookie または Bearer トークンを含めてください
クエリパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
status | string | 任意 | ステータスで絞り込み（pending / approved / rejected / paid） |
company_id | string | 任意 | 取引先 ID で絞り込み |
limit | integer | 任意 | 取得件数（デフォルト: 50, 最大: 200） |
offset | integer | 任意 | スキップ件数 |
コード例
curl "https://api.blueai.jp/api/v1/received-invoices" \
-H "Cookie: better-auth.session_token=<token>"POST
/api/v1/received-invoices受領請求書を登録
認証が必要です— セッション Cookie または Bearer トークンを含めてください
コード例
curl -X POST "https://api.blueai.jp/api/v1/received-invoices" \
-H "Cookie: better-auth.session_token=<token>"GET
/api/v1/received-invoices/dashboardダッシュボードを取得
未承認件数・支払期日間近の件数・今月の支出サマリーなどを返します。
認証が必要です— セッション Cookie または Bearer トークンを含めてください
コード例
curl "https://api.blueai.jp/api/v1/received-invoices/dashboard" \
-H "Cookie: better-auth.session_token=<token>"GET
/api/v1/received-invoices/{id}受領請求書を取得
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"PATCH
/api/v1/received-invoices/{id}受領請求書を更新
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl -X PATCH "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"DELETE
/api/v1/received-invoices/{id}受領請求書を削除
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl -X DELETE "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"POST
/api/v1/received-invoices/{id}/approve承認
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/approve" \
-H "Cookie: better-auth.session_token=<token>"POST
/api/v1/received-invoices/{id}/reject却下
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/reject" \
-H "Cookie: better-auth.session_token=<token>"POST
/api/v1/received-invoices/{id}/mark-paid支払済みにする
認証が必要です— セッション Cookie または Bearer トークンを含めてください
パスパラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 任意 | 受領請求書 ID |
コード例
curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/mark-paid" \
-H "Cookie: better-auth.session_token=<token>"