Modules for online stores

Connecting cloud Bitrix24 to ILFF

See also: Delivery widget for the cart · ILFF API · All CMS modules

The exchange is designed for deals in cloud Bitrix24. It works through an inbound REST API webhook and is not related to the "1C-Bitrix" module.

What ILFF does:

  • collects deals at the selected stage and creates delivery requests;
  • writes back the status, tracking number and tracking link, changes the deal stage and adds a comment;
  • cancels the request at a failure stage if it is not yet in work;
  • links products and variants by barcode, then by SKU;
  • when inventory management is enabled, aligns stock levels with stock receipt and write-off documents.

The Bitrix24 delivery service and the ILFF tariff in the deal are not included at this stage.

Step 1. Webhook

  1. In Bitrix24, open Разработчикам → Другое → Входящий вебхук (For developers → Other → Inbound webhook).
  2. Create a webhook with CRM (crm) and Торговый каталог (catalog) (Product catalog) permissions.
  3. To create the ILFF fields during the initial connection, the webhook user needs the Разрешить изменять настройки (Allow changing settings) right in CRM. For stock levels, the user needs rights to view the catalog and warehouses and to create and post stock receipt and write-off documents.
  4. Save the full address in the format https://<портал>.bitrix24.ru/rest/<user>/<секрет>/. It contains a secret: do not send it openly or store it in documents.

Step 2. Pipeline and stage

Choose the pipeline or the specific stage from which ILFF collects deals. If only a pipeline is specified, its first active stage is used. Failure stages in the same pipeline are also read so that ILFF can cancel the request.

Pass the webhook address and the selected pipeline or stage to the ILFF administrator. During connection, the following string fields are created in deals:

  • Трек ILFF (ILFF tracking number);
  • Ссылка отслеживания ILFF (ILFF tracking link);
  • Статус ILFF (ILFF status).

Step 3. Products

ILFF reads products and variants and looks for a match first by barcode, then by SKU (code or xmlId). Products without a unique match are marked as unlinked; link them manually in the client account.

How to prepare a deal for ILFF

  1. Move the deal to the selected stage.
  2. Fill in the contact, phone number and delivery address. Enter the postal code in the ADDRESS_POSTAL_CODE address field.
  3. Add product lines. The total of the lines is treated as the product value; any amount by which the deal total exceeds it is treated as the delivery cost.
  4. The CLOSEDATE field is used as the planned delivery date.

A deal without an address or products does not create a request and appears in the list of items awaiting data, with the reason.

Statuses

  • handed over to the carrier — the Отгружен (Shipped) stage (or Отправлен, Sent, Передан в доставку, Handed over for delivery);
  • delivered — Доставлен (Delivered) or a successful stage;
  • cancelled or fully refused — Отменен (Cancelled) or a failure stage;
  • return accepted — Возврат (Return), if it exists; otherwise a failure stage.

The exact status and carrier are also written to the Статус ILFF field. A comment is added to the timeline when the status changes.

Stock levels

Choose the active ILFF warehouse if it exists; otherwise the first active warehouse is used. Before exporting, ILFF compares its stock levels with those on the portal and creates only the necessary stock receipt or write-off documents tagged ILFF. Running the export again does not change stock levels that already match. If inventory management is disabled on the portal, the export is simply skipped.

If something does not work

  • No crm/catalog permissions — enable them in the webhook settings and repeat the connection.
  • ILFF fields were not created — grant the webhook user the right to change CRM settings or create the three string fields yourself: UF_CRM_ILFF_TRACK, UF_CRM_ILFF_TRACK_URL, UF_CRM_ILFF_STATUS.
  • A deal did not arrive — check the stage, address and product lines, as well as the list of items awaiting data in the client account.
  • Stock levels were not exported — check inventory management, the active warehouse and rights to stock receipt and write-off documents.

WeChat

WeChat QR code

Scan the QR code in WeChat · 用微信扫码添加

We will call you back

During working hours we call right away, otherwise the next morning. Mon–Fri, 11:00 to 20:00 Moscow time. Managers speak Russian.