Modules for online stores

Connecting amoCRM to ILFF

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

The exchange works through a private amoCRM integration and a long-lived token. The integration does not need to be published publicly.

What ILFF does:

  • collects deals at the selected stage and creates or updates delivery requests;
  • writes the status, tracking number and tracking link to the deal, changes the stage if configured and adds a note;
  • cancels the request when the deal moves to Закрыто и не реализовано (Closed and not implemented) if picking has not started;
  • synchronizes products and links them to ILFF items by SKU, then by barcode.

The current version does not export stock levels to amoCRM.

The ILFF client account section used for connection is called amoCRM. It will appear after this platform is enabled for your account.

Step 1. Private integration

  1. Sign in to amoCRM with administrator rights.
  2. Open Настройки → Интеграции → Создать интеграцию (Settings → Integrations → Create integration) and create a private integration.
  3. Grant it the Доступ к данным аккаунта (Access to account data) right. This is needed to read deals, contacts and products, as well as to write order states and create ILFF fields.

Important: amoCRM does not provide technical support for system errors in private integrations. A waiver of such support will be required during connection. Consultations and help with payment questions remain available.

Step 2. Long-lived token

  1. Open the integration you created and go to the Ключи (Keys and scopes) tab.
  2. Click Сгенерировать токен (Generate token) and choose its validity period. The recommended period is 1 год (1 year).
  3. Save the token immediately in secure storage: amoCRM will not show it again later. Do not send the token openly or store it in documents.

A long-lived token is not renewed automatically. When it expires, create a new token in this integration and replace the old one in the amoCRM section of the ILFF client account.

Step 3. Connection and deal stage

  1. Find the full address of your account: https://<поддомен>.amocrm.ru.
  2. In the ILFF client account, open amoCRM and enter the account address and long-lived token.
  3. Choose the pipeline or the specific stage from which ILFF should collect deals. If nothing is selected, the first active stage of the main pipeline is used. If a pipeline is selected without a stage, its first active stage is used.
  4. The Неразобранное (Unsorted) stage is not suitable for the exchange. Choose a stage at which the deal already contains the data required for delivery.

During connection, ILFF will create the missing deal fields itself:

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

You do not need to create these fields manually.

Step 4. Products

  1. In the amoCRM settings, open Списки (Lists) and enable the Товары (Products) catalog.
  2. Fill in the SKU and price in the product cards. For barcode linking, ILFF will find an existing Штрихкод (Barcode), ШК or Barcode field or create a Штрихкод field automatically.
  3. Add lines from the Товары catalog to deals and specify whole-number quantities.

ILFF looks for a match first by SKU, then by barcode. If a product cannot be linked uniquely, it will remain in the list for manual linking in the client account.

How to prepare a deal for ILFF

  1. Fill in the primary contact, recipient name and phone number.
  2. Enter the address in a contact field of the Адрес (Address) type. The city is required. You can use the Адрес text field instead. The field can be filled in the deal or in its primary contact.
  3. Add product lines from the catalog and check their quantities.
  4. Enter the deal budget. It becomes the order total and the cash-on-delivery amount. Line prices are calculated from the prices in the product cards.
  5. Move the deal to the stage selected for ILFF.

If the address or products are missing, or a product is not linked to an ILFF item, no request is created. The deal will appear in the list of items awaiting data, with the reason.

Statuses and cancellation

ILFF writes the request state to the Статус ILFF, Трек ILFF and Ссылка отслеживания ILFF fields. When the state actually changes, a note is added to the deal; the stage changes if such a mapping is configured.

To cancel the order, move the deal to the Закрыто и не реализовано stage before picking starts. Deleting the deal also cancels the linked request. If picking has already started, agree the cancellation with ILFF.

If something does not work

  • The token has expired or been revoked — create a new long-lived token and replace it in the amoCRM section of the ILFF client account.
  • ILFF fields were not created — check the Доступ к данным аккаунта right and the administrator rights of the user who created the integration, then repeat the connection.
  • A deal did not arrive — check the stage, primary contact, address with a city and product lines, as well as the list of items awaiting data in the client account.
  • A product is not linked — check the SKU and barcode in the product card or link it manually in the client account.
  • The product catalog was not found — enable the Товары catalog in Списках (Lists) in amoCRM and repeat the connection.

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.