日本の複数の仕入れ先の商品 約20万点を、1 本の API で検索し、1 つのカートで発注できる卸仕入れ API です。売れてから買い付ける方式のため、在庫を持たずに品揃えを増やせます。検索から注文・支払い（3D セキュア対応）・適格請求書の取得まで、仕入れに必要な操作がこの API で完結します。
はじめての方は AI に話しかけて仕入れる（コード不要・約 15 分） からどうぞ。
| 方式 | ヘッダ | 用途 |
|---|---|---|
| API キー | Authorization: Bearer orosy_... |
商品検索・カート・注文などほぼ全て |
| Cognito ID トークン | Authorization: Bearer <id_token> |
/v1/me/*（キー管理・支払い方法・請求書）のみ |
orosy_demo_...（test キー）の注文はテスト専用で、実課金・実在庫の変動はありません。POST /v1/orders/{order_id}/simulate で確保確定〜キャンセルの状態遷移を自由に再現できますGET /v1/products — 横断検索（キーワード / 品番・JAN / 価格帯 / 在庫）PUT /v1/cart/items — 仕入れ先をまたいで 1 カートに追加POST /v1/orders — 配送先を指定して注文（価格が変動していれば 409 PRICE_CHANGED で保護）GET /v1/orders/{order_id} — 確保確定 / 出荷の状態を追跡GET /v1/me/orders/{order_id}/invoice — 適格請求書（インボイス）PDF の取得409 を返します。accept_price_change: true で明示的に受け入れた時のみ新価格で確定しますPOST /v1/orders には Idempotency-Key ヘッダの付与を推奨します。同じキーでの再送は最初の注文を返します（新規作成しません）。ヘッダ未指定でも、直近の同一カートの二重送信はサーバ側で自動排除されます全エンドポイントの仕様は API リファレンス を参照してください。