此数据交换适用于云端 Битрикс24 中的交易。它通过 REST API 的传入 Webhook 工作,与“1C-Битрикс”模块无关。
ILFF 提供以下功能:
- 读取指定阶段的交易并生成配送申请;
- 回写状态、跟踪号和跟踪链接,更改交易阶段并添加备注;
- 交易进入失败阶段时,如果配送申请尚未开始处理,则取消申请;
- 先按条码、再按货号关联商品和规格;
- 启用库存管理后,通过入库单和库存核销单校准库存。
现阶段不包括 Битрикс24 配送服务和交易中的 ILFF 费率。
第 1 步:Webhook
- 在 Битрикс24 中打开 Разработчикам → Другое → Входящий вебхук(开发者 → 其他 → 传入 Webhook)。
- 创建具有 CRM (crm) 和 Торговый каталог (catalog)(商品目录)权限的 Webhook。
- 首次接入时,为创建 ILFF 字段,Webhook 用户需要在 CRM 中拥有 Разрешить изменять настройки(允许更改设置)权限。同步库存还需要查看商品目录和仓库,以及创建并审核入库单和库存核销单的权限。
- 保存完整地址,格式为
https://<портал>.bitrix24.ru/rest/<user>/<секрет>/。该地址包含密钥:请勿公开传输,也不要将其保存在文档中。
第 2 步:销售漏斗和阶段
选择 ILFF 读取交易的销售漏斗或具体阶段。如果只指定销售漏斗,则使用其第一个处理中阶段。系统还会读取同一漏斗中的失败阶段,以便 ILFF 取消配送申请。
请将 Webhook 地址以及所选销售漏斗或阶段提供给 ILFF 管理员。接入时,系统会在交易中创建以下字符串字段:
- Трек ILFF(ILFF 跟踪号);
- Ссылка отслеживания ILFF(ILFF 跟踪链接);
- Статус ILFF(ILFF 状态)。
第 3 步:商品
ILFF 读取商品和规格,先按条码、再按货号(code 或 xmlId)查找匹配项。没有唯一匹配项的商品会标记为未关联;请在客户后台手动关联。
如何为 ILFF 准备交易
- 将交易移至所选阶段。
- 填写联系人、电话号码和收货地址。在地址字段
ADDRESS_POSTAL_CODE中填写邮政编码。 - 添加商品行。商品行总金额计为商品价值;交易总额超出该金额的部分计为配送费。
CLOSEDATE字段用作计划配送日期。
没有地址或商品的交易不会生成配送申请,而会连同原因一起显示在等待补充数据的列表中。
状态
- 已交给物流公司——Отгружен(已发货)阶段(或 Отправлен,已发送;Передан в доставку,已交配送);
- 已签收——Доставлен(已送达)或成功阶段;
- 已取消或全部拒收——Отменен(已取消)或失败阶段;
- 退货已接收——Возврат(退货),如果有此阶段;否则使用失败阶段。
准确状态和物流公司也会写入 Статус ILFF 字段。状态变化时,系统会在时间线中添加备注。
库存
如果存在启用的 ILFF 仓库,请选择该仓库;否则使用第一个启用的仓库。同步前,ILFF 会将其库存与门户中的库存进行比较,只创建必要的入库单或库存核销单,并添加 ILFF 标记。再次运行不会更改已经一致的库存。如果门户未启用库存管理,则会直接跳过同步。
常见问题
- 没有 crm/catalog 权限——请在 Webhook 设置中启用这些权限,然后重新接入。
- 未创建 ILFF 字段——请授予 Webhook 用户更改 CRM 设置的权限,或自行创建三个字符串字段:
UF_CRM_ILFF_TRACK、UF_CRM_ILFF_TRACK_URL、UF_CRM_ILFF_STATUS。 - 交易未进入 ILFF——请检查阶段、地址和商品行,并查看客户后台中等待补充数据的列表。
- 库存未同步——请检查库存管理、启用的仓库,以及入库单和库存核销单的权限。