発注API

発注伝票の作成・取得・更新・削除およびエクスポートを行うAPIエンドポイントです。

GET /api/v1/orders

発注伝票一覧を取得します。プロジェクトID、ステータス、担当者でフィルタ可能です。

POST /api/v1/orders

新しい発注伝票を作成します。

// リクエスト
{
  "project_id": "prj_abc123",
  "assignee_id": "staff_001",
  "process": "原画",
  "cuts": ["cut_001", "cut_002", "cut_003"],
  "unit_price": 4500,
  "deadline": "2026-04-15"
}

// レスポンス (201 Created)
{
  "id": "ord_xyz789",
  "status": "draft",
  "total_amount": 13500,
  "created_at": "2026-03-22T10:00:00Z"
}

PATCH /api/v1/orders/[id]

発注伝票を更新します。ステータスの変更（draft → sent → accepted等）にも使用します。

DELETE /api/v1/orders/[id]

下書き状態の発注伝票を削除します。送信済みの伝票は削除できません。

GET /api/v1/orders/export

発注伝票をCSV形式でエクスポートします。日付範囲やプロジェクトでフィルタ可能です。