bitrix-sale

在线商店（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()。Internals\*Table ORM 对订单数据是只读的。切勿在循环中调用 Order::load()。
• 对象 API 不会检查权限：处理用户请求前，请检查 CSaleOrder::CanUserViewOrder() 等方法。
• 从受限列表中获取支付系统和配送服务，切勿使用请求中的原始 ID。
• 检查 isSuccess() 和 getWarningMessages()。切勿在 OnSaleOrderSaved 中调用 $order->save()。