网店模块

将云端 Битрикс24 接入 ILFF

另请参阅: 购物车配送组件 · ILFF API · 全部 CMS 模块

此数据交换适用于云端 Битрикс24 中的交易。它通过 REST API 的传入 Webhook 工作,与“1C-Битрикс”模块无关。

ILFF 提供以下功能:

  • 读取指定阶段的交易并生成配送申请;
  • 回写状态、跟踪号和跟踪链接,更改交易阶段并添加备注;
  • 交易进入失败阶段时,如果配送申请尚未开始处理,则取消申请;
  • 先按条码、再按货号关联商品和规格;
  • 启用库存管理后,通过入库单和库存核销单校准库存。

现阶段不包括 Битрикс24 配送服务和交易中的 ILFF 费率。

第 1 步:Webhook

  1. 在 Битрикс24 中打开 Разработчикам → Другое → Входящий вебхук(开发者 → 其他 → 传入 Webhook)。
  2. 创建具有 CRM (crm) 和 Торговый каталог (catalog)(商品目录)权限的 Webhook。
  3. 首次接入时,为创建 ILFF 字段,Webhook 用户需要在 CRM 中拥有 Разрешить изменять настройки(允许更改设置)权限。同步库存还需要查看商品目录和仓库,以及创建并审核入库单和库存核销单的权限。
  4. 保存完整地址,格式为 https://<портал>.bitrix24.ru/rest/<user>/<секрет>/。该地址包含密钥:请勿公开传输,也不要将其保存在文档中。

第 2 步:销售漏斗和阶段

选择 ILFF 读取交易的销售漏斗或具体阶段。如果只指定销售漏斗,则使用其第一个处理中阶段。系统还会读取同一漏斗中的失败阶段,以便 ILFF 取消配送申请。

请将 Webhook 地址以及所选销售漏斗或阶段提供给 ILFF 管理员。接入时,系统会在交易中创建以下字符串字段:

  • Трек ILFF(ILFF 跟踪号);
  • Ссылка отслеживания ILFF(ILFF 跟踪链接);
  • Статус ILFF(ILFF 状态)。

第 3 步:商品

ILFF 读取商品和规格,先按条码、再按货号(code 或 xmlId)查找匹配项。没有唯一匹配项的商品会标记为未关联;请在客户后台手动关联。

如何为 ILFF 准备交易

  1. 将交易移至所选阶段。
  2. 填写联系人、电话号码和收货地址。在地址字段 ADDRESS_POSTAL_CODE 中填写邮政编码。
  3. 添加商品行。商品行总金额计为商品价值;交易总额超出该金额的部分计为配送费。
  4. 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——请检查阶段、地址和商品行,并查看客户后台中等待补充数据的列表。
  • 库存未同步——请检查库存管理、启用的仓库,以及入库单和库存核销单的权限。

WeChat

微信二维码

用微信扫码添加

我们将在几分钟内回电

工作时间我们会立即回电,其他时间将在次日早上回电。周一至周五 11:00–20:00(莫斯科时间,UTC+3)。客户经理使用俄文或英文。