启用后台交换前，请先配置 CRM 连接、销售管道和订单字段映射。正式处理订单前，先用一个测试订单检查结果与日志。 本译文为简要指南；完整的技术参考目前仅提供俄语版。
1. 模块如何工作
1C-Bitrix 模块通过订单 ID 字段，将商店订单与 Bitrix24 交易关联。根据启用的设置，它可以由订单创建交易、由符合条件的交易创建订单，并同步相关字段或阶段。请分别配置每个方向，并查看事件日志。
2. 安装与连接
在 1C-Bitrix 管理后台安装模块。打开 CRM 连接选项卡，填写具有所需权限的 webhook，选择商店站点，并确认连接成功。不要在截图或支持请求中泄露 webhook 凭据。
3. 销售管道与阶段
选择 Bitrix24 销售管道，并将各个相关订单状态映射到交易阶段。若要从 CRM 同步回商店，每个 CRM 阶段必须唯一对应一个订单状态。修改管道或阶段后，应重新检查所有映射。
4. 订单字段与商品
针对每种付款人类型，将订单 ID 映射到合适的 CRM 字段，并设置其他订单字段。检查字段类型和列表选项。启用商品匹配时，选择正确的商店及 CRM 商品目录和唯一商品标识；无法匹配的商品可能阻止反向创建订单。
5. 自动化与后台任务
模块依赖 1C-Bitrix 代理任务和站点 cron。保存设置并不代表 cron 已运行。若需双向同步阶段，请配置 CRM 的出站 webhook，分别从订单和交易发起变更并验证结果。
6. 检查、修正与日志
使用订单检查和修正选项卡前，先确认操作范围。批量创建、修改或删除数据前应阅读报告。比较商店订单 ID 与 CRM 交易字段，查看最新日志，并在修复映射后重新进行单项测试。
7. 正式启用前
检查 webhook 权限、站点、管道、付款人类型、订单 ID 字段、阶段映射和 cron。创建测试订单，核对交易、字段和商品；如启用反向同步，也要测试该方向。联系 modules@ank-studio.ru 时请勿发送密钥。