For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/mobile/commerce.md (or send Accept: text/markdown).
モバイルのコマース
ワークスペースのストア商品と注文を管理する。
商品
/api/mobile/commerce/products への GET と POST は商品の一覧と作成を行います — owner と admin のみ。新しい商品は draft として始まります。価格は文字列で入力し、小数 2 桁の精度でセントとして保存され、在庫追跡は任意です。商品は削除されません — archived が取り下げの状態で、PATCH はフィールドとステータス — draft、active、archived — をまとめて更新します。
注文は前進のみ
GET /api/mobile/commerce/orders は注文を一覧します。注文はストアのチェックアウトが作成するもので、アプリからは作成されません。PATCH は状態を前方向にのみ進めます — pending → paid → fulfilled — で、支払い前は cancelled、支払い後は refunded が許可されます。キャンセルは同じトランザクションで追跡中の在庫を戻し、不正な遷移はユーザーが閉じるべきエラーではなく、静かな no-op です。
検証とトラブルシューティング
公開チェックアウトで販売し、モバイルで注文を進め、pending の注文をキャンセルしたときに在庫が戻ることを確認してください。admin 未満のメンバーはこのサーフェスにまったく到達できません — 空ではなく利用不可として見えることを確認してください。