Connecting an AdvantShop store to ILFF
See also: Delivery widget for the cart · ILFF API · All CMS modules
A store on AdvantShop (Alfa-Seller Pro) connects to ILFF without a module on the site: ILFF runs the exchange through the store's Management API.
- orders with the ILFF delivery method arrive in ILFF on their own;
- the tracking number and order status are returned to the store, and the status comment carries the carrier and the tracking link;
- free ILFF stock is passed to the product modifications of the store;
- cancelling an order in the store cancels the request in ILFF if the request is not yet in work.
For AdvantShop, ILFF does not currently show the delivery price in the cart or the choice of a pickup point: you set the ILFF delivery cost yourself in the store delivery method (fixed or by zones). ILFF selects the shipment by the shopper's address.
You need:
- store administrator rights and access to the ILFF client account;
- AdvantShop with the Management API section (Настройки → API, the «API ключи» tab; in English: Settings → API, "API keys").
The connection takes 10 minutes.
The ILFF client account is in Russian, so its labels are given below as they appear on the screen, with a translation in brackets.
Step 1. ILFF delivery method in the store
- In the store admin panel open Настройки → Доставка (Settings → Delivery) and add a delivery method, for example "Доставка ILFF". The type is fixed cost or by zones, and you set your own price.
- The method name must contain "ILFF": this is how ILFF recognises its orders. Do not rename the method without "ILFF": orders will stop arriving.
- Instead of the name you can give the number (id) of the method: it is visible in the address of the method page, for example
…/shippingmethods/edit/7. If there are several ILFF methods (for example, courier and pickup), the numbers of all of them are needed.
Step 2. Management API key
- Open Настройки → API (Settings → API), the API ключи (API keys) tab, and press Создать ключ (Create key).
- The name is, for example, "ILFF", the type is Management API, the access is to orders and products (or full management), and the validity is unlimited.
- Copy the key: it is shown in full only when it is created.
Step 3. Connection in the ILFF client account
Client account → the Интеграции (Integrations) tab → expand the Интернет-магазин (Online store) block.
- Платформа (Platform): choose AdvantShop.
- Адрес магазина (Store address): the address of the site or the admin panel, for example
shop.ruors10.alslr.su/123456-abcd. - Id способа доставки ILFF (ILFF delivery method id): leave it empty, then orders are taken with the delivery method whose name contains "ILFF". Or enter the method number from step 1 (several numbers separated by commas).
- Ключ Management API (Management API key): the key from step 2.
- The Выгружать остатки (Export stock) checkbox: pass free ILFF stock to the product modifications.
- The Заказ с несвязанным товаром ждёт привязки (An order with an unlinked product waits for linking) checkbox: when it is on, an order with a product that is not yet linked to your product in ILFF is not accepted until you link it (step 4). We recommend leaving it on.
- Press Подключить (Connect). The account checks the key in the store and saves the connection. To change the settings only, the key field can be left empty.
Step 4. Linking products
ILFF reads the store products itself once a day and links modifications to your products in ILFF by barcode, then by the modification SKU. Modifications without a pair are in the client account, the Товары магазина (Store products) button in the "Интернет-магазин" block: choose your product for each one and press Привязать (Link).
How the exchange runs
| What | When |
|---|---|
| Orders with the ILFF delivery method | every few minutes: new ones and those changed since the previous load |
| Order change before picking | the request is updated; after picking the changes are visible in the client account ("изменён после сборки", changed after picking) |
| Cancellation in the store (a status with the cancellation flag) | the request is cancelled if it is not yet in work; otherwise contact your ILFF manager |
| Tracking number | as soon as the carrier has issued it |
| Status in the store | handed over to the carrier → "Отправлен" (Shipped), delivered → the final status, cancellation, refusal and return → the cancellation status |
| Stock | after the free stock changes, only for linked modifications |
ILFF chooses the store statuses from the status list: "Отправлен" by name, the final and cancellation ones by the status flags. ILFF no longer changes orders that are completed in the store.
If something does not work
| Message | What to do |
|---|---|
| «Магазин не принял ключ API» (The store did not accept the API key) | The key must be of the Management API type and active. Create a new key and connect again |
| «У ключа API нет доступа к заказам» (The API key has no access to orders) | Open the key in the store and grant access to orders and products |
| An order did not arrive in ILFF | Check that the ILFF delivery method is chosen for the order (with "ILFF" in the name or with the given number), and the "Интернет-магазин" block in the account (orders waiting for product linking) |
| Stock in the store does not change | Check the "Выгружать остатки" checkbox and the link between the modification and the ILFF product ("Товары магазина") |