mcpField
B
bitrix-sale

bitrix-sale

github.com/bxmaximumDevelopment47279 installsUpdated 2w ago
Repository

About bitrix-sale

bitrix-sale is a skill for Bitrix online-store developers, covering the sale module's baskets, orders, payments, delivery, and discounts. It emphasizes changing orders through the object model, checking permissions and operation results, and handling products, prices, and stock through catalog.

Key features

  1. 01Manage baskets, orders, and order properties
  2. 02Handle payments, delivery, and shipments
  3. 03Configure discounts, coupons, and statuses
  4. 04Update and save orders through the object model
  5. 05Check permissions and restricted payment or delivery options

Use cases

  1. 01Create or update orders and order properties
  2. 02Preview basket discounts before checkout
  3. 03Implement payment handlers and callbacks
  4. 04Configure delivery, shipment reservation, and deduction

Install

Copy the command and run it in a terminal.

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

After installing, type/bitrix-salein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

rules/
archive-components.md
basket.md
delivery-reservation.md
discounts.md
order.md
payments.md
statuses-events.md

Details

From the project README

Online store (sale)

Baseline: main 23.0+ · Verified: sale 26.500.0, main 26.800.0

sale owns basket, orders, payments, shipments, discounts, statuses and history. Products, prices, stock → bitrix-catalog.

TaskRead
API level choice, create/update an order, order propertiesrules/order.md
Basket, Fuser, discount preview before checkoutrules/basket.md
Statuses, rights, history, eventsrules/statuses-events.md
Payments, own pay system handlers, callbacksrules/payments.md
Delivery services, shipments, reservation, deductionrules/delivery-reservation.md
Cart rules, coupons, applied discountsrules/discounts.md
Lists, archive, components, behaviour changesrules/archive-components.md

Invariants

  • Loader::includeModule('sale') (+ catalog for products, prices, reservation).
  • Change orders only through the object model (Order, its collections) and one save() per operation. Internals\*Table ORM is read-only for order data. Never Order::load() in a loop.
  • The object API never checks rights: check CSaleOrder::CanUserViewOrder() and friends before acting on a user request.
  • Take pay systems and delivery services from restricted lists, never a raw ID from the request.
  • Check isSuccess() and getWarningMessages(). Never call $order->save() inside OnSaleOrderSaved.

Comments

Markdown supported