一部品切れのとき、請求はどうなるか

卸仕入れでは「注文した商品の一部が品切れだった」が日常的に起きます。orosy の請求は確保できた分（実際に届く分）にだけ発生します。このガイドでは、その挙動をテスト環境で実際に確かめます。

原則

• 注文時点では請求は確定しません（status: pending_confirmation）
• 仕入れ先での確保が確定した分だけが confirmed_total として請求されます
• 全量品切れなら請求はゼロ。先に多く請求して後から返す、という動きはありません

実際に見てみる（demo キー）

2 個注文して、1 個しか確保できなかったケースを再現します。

1. 2 個注文する — 注文時の見積は合計 ¥2,640（商品 ¥800×2 + 税 + 送料 ¥800）

2. 「1 個だけ確保できた」状況をシミュレート:

curl -X POST -H "Authorization: Bearer orosy_demo_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"action": "confirm_partial", "items": [{"item_no": 1, "confirmed_qty": 1}]}' \
  "https://wholesale-api.orosy.com/v1/orders/《order_id》/simulate"

3. 注文を確認する:

{
  "status": "partially_confirmed",
  "breakdown":           { "total": 2640, … },   // 注文時の金額
  "confirmed_total": 1760,                        // 実際に請求される金額
  "confirmed_breakdown": {
    "subtotal_standard": 1600,
    "tax_standard": 160,
    "shipping_fee": 800,
    "total": 1760
  },
  "items": [ { "qty": 2, "confirmed_qty": 1 } ],
  "payment": { "status": "succeeded" }
}

読み方

• 請求は confirmed_breakdown が正であり、注文時の breakdown は上書きされずに残ります（差分を突き合わせて経理処理できます）
• 送料は実測では据え置きでした（確保数に関わらず配送は発生するため）
• 部分確保を許可したくない場合: 現在の API では、注文リクエストに部分確保を無効化するパラメータはありません（注文レスポンスの allow_partial で設定値を確認できます）

実装のヒント

• 注文後は GET /v1/orders/{order_id} をポーリングし、status が confirmed / partially_confirmed / cancelled のどれに遷移したかで在庫・販売画面を更新する
• 自社の顧客への請求と orosy からの仕入れ請求を突き合わせる時は、confirmed_qty と confirmed_breakdown を使う
• 適格請求書（インボイス）も確定額に対して発行されます（GET /v1/me/orders/{order_id}/invoice。詳細は API リファレンス参照）