mcpField
B
bitrix-sale

bitrix-sale

github.com/bxmaximum開発47279 回インストール2 週間前に更新
リポジトリ

bitrix-sale について

bitrix-saleは、Bitrixのオンラインストア開発者向けスキルです。saleモジュールのバスケット、注文、決済、配送、割引を扱い、注文オブジェクト経由の変更や権限・処理結果の確認を重視します。商品、価格、在庫はcatalogで扱います。

主な機能

  1. 01バスケット、注文、注文プロパティの管理
  2. 02決済、配送、出荷の処理
  3. 03割引、クーポン、ステータスの設定
  4. 04オブジェクトモデル経由での注文更新と保存
  5. 05権限と制限付き決済・配送選択肢の確認

活用シーン

  1. 01注文や注文プロパティの作成・更新
  2. 02チェックアウト前のバスケット割引確認
  3. 03決済ハンドラーやコールバックの実装
  4. 04配送、出荷予約、引き落としの設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-sale

インストール後、Claude Code で/bitrix-saleを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
archive-components.md
basket.md
delivery-reservation.md
discounts.md
order.md
payments.md
statuses-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\*Table ORM は読み取り専用です。ループ内で Order::load() を呼び出してはいけません。
  • オブジェクト API は権限をチェックしません。ユーザーのリクエストに対して操作を行う前に、CSaleOrder::CanUserViewOrder() などで確認してください。
  • 決済システムと配送サービスは制限付きリストから取得し、リクエストから生の ID を受け取ってはいけません。
  • isSuccess() と getWarningMessages() の両方を確認します。OnSaleOrderSaved 内で $order->save() を呼び出してはいけません。

コメント