bitrix-sale について
bitrix-saleは、Bitrixのオンラインストア開発者向けスキルです。saleモジュールのバスケット、注文、決済、配送、割引を扱い、注文オブジェクト経由の変更や権限・処理結果の確認を重視します。商品、価格、在庫はcatalogで扱います。
主な機能
- 01バスケット、注文、注文プロパティの管理
- 02決済、配送、出荷の処理
- 03割引、クーポン、ステータスの設定
- 04オブジェクトモデル経由での注文更新と保存
- 05権限と制限付き決済・配送選択肢の確認
活用シーン
- 01注文や注文プロパティの作成・更新
- 02チェックアウト前のバスケット割引確認
- 03決済ハンドラーやコールバックの実装
- 04配送、出荷予約、引き落としの設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-saleインストール後、Claude Code で/bitrix-saleを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/archive-components.mdbasket.mddelivery-reservation.mddiscounts.mdorder.mdpayments.mdstatuses-events.md詳細
オンラインストア(sale)
ベースライン:main 23.0+ · 検証済み:sale 26.500.0、main 26.800.0
sale はバスケット、注文、決済、配送、割引、ステータス、履歴を管理します。商品、価格、在庫については bitrix-catalog を参照してください。
| タスク | 参照先 |
|---|---|
| API レベルの選択、注文の作成/更新、注文プロパティ | rules/order.md |
| バスケット、Fuser、チェックアウト前の割引プレビュー | rules/basket.md |
| ステータス、権限、履歴、イベント | rules/statuses-events.md |
| 決済、独自の決済システムハンドラー、コールバック | rules/payments.md |
| 配送サービス、出荷、引当、減算 | rules/delivery-reservation.md |
| カートのルール、クーポン、適用済み割引 | rules/discounts.md |
| 一覧、アーカイブ、コンポーネント、動作の変更 | rules/archive-components.md |
不変条件
Loader::includeModule('sale')を実行します(商品、価格、引当にはcatalogも必要です)。- 注文の変更にはオブジェクトモデル(
Orderとそのコレクション)のみを使用し、操作ごとにsave()を1回呼び出します。注文データに対するInternals\*TableORM は読み取り専用です。ループ内でOrder::load()を呼び出してはいけません。 - オブジェクト API は権限をチェックしません。ユーザーのリクエストに対して操作を行う前に、
CSaleOrder::CanUserViewOrder()などで確認してください。 - 決済システムと配送サービスは制限付きリストから取得し、リクエストから生の ID を受け取ってはいけません。
isSuccess()とgetWarningMessages()の両方を確認します。OnSaleOrderSaved内で$order->save()を呼び出してはいけません。
コメント
Markdown 対応