Elbuz fetches the ELKO Ukraine price list from ecom.elko.ua — UAH price and RRP, stock, photos, dimensions, descriptions, specifications — and sends supplier orders to ELKO from a document.
When you need this:
- ELKO returns descriptions one product at a time — the app collects them over several imports.
- You enter ELKO orders by hand — a document button creates the shipment and saves the waybill.
- You need a specific ELKO warehouse — stock and shipments from Warehouse 1, 2 or both.
- ELKO allows only approved IPs — the Elbuz server address is in the access settings window.
Where to start: get ELKO API access and approve the Elbuz IP.
What the ELKO integration does
- Price list with no manual mapping — product code, part number, name, brand, price and RRP in hryvnias, warranty, barcode, category, stock and a link to the product on ELKO.
- All photos, weight and dimensions — together with the price list.
- Descriptions and specifications — collected gradually within the ELKO limit.
- Two ELKO warehouses — stock in the price list and shipments from the warehouse you need, or from both.
- Shipments from a document — as a reservation or for shipment, with status and the number.
How ready-made integrations work in general — the wizard, the access settings window, column mapping — is covered in How to connect a supplier via API. This article covers only what's specific to ELKO.
What to ask ELKO for: API access and IP approval
- API access. Your ecom.elko.ua username and password will do — the app gets the token itself. Or use an API token from your ELKO account: enter it in full in “Password (token)”.
- The Elbuz IP address on the approved list. ELKO only allows API access from approved addresses. Give your ELKO manager the Elbuz server address from the “API access settings” window (where to find it).
Which ELKO request parameters to fill in
In the new source wizard, on the “From where” step, choose the “API” tile and “ELKO” in the list. The app fills in the address https://uaapi.elko.cloud/v3.0/, the format, the columns and photo import itself (what exactly it does). In the “API access settings” window, enter your username and password or a token.
The “Get reference data” button shows your ELKO delivery addresses with their numbers — you'll need the number for orders.
| Parameter | Default | What it does |
|---|---|---|
| “Full product cards” | 1 | 1 — descriptions and specifications from ELKO (more); 0 — price list only |
| “Language of price list, descriptions and specifications” | ua | ua — Ukrainian, ru — Russian; after a change, the app fetches the descriptions again |
| “Merge specification values”, “Specification value separator” | 1, / | specifications with the same name become one, with the values joined by the separator |
| “Descriptions and attributes: seconds per import” | 240 | how long one import spends collecting descriptions and specifications (why) |
| “Order: delivery address (addressNumber)” | empty | the address number from “Get reference data”; without it the order isn't sent |
| “Order: reserve only” | 1 | 1 — ELKO reserves the products; 0 — ELKO creates a shipment |
| “Warehouse for price list stock” | all | all — total for both warehouses, wh1 or wh2 — one warehouse only (more) |
| “Order: shipping warehouse” | wh1 | wh1 — Warehouse 1, wh2 — Warehouse 2, all — ELKO chooses the warehouse |
| “Order: split between warehouses” | 0 | 1 — ELKO may pick the order from two warehouses; works only with the shipping warehouse set to all |
Sources connected earlier got these rows, the description and dimension columns, and import of all photos with this version.
1
Descriptions and attributes: seconds per import2
Order: delivery address3
Order: reserve only- Descriptions and attributes: seconds per import — how long one import may spend fetching product descriptions.
- Order: delivery address — the address number from the reference data; orders are not sent without it.
- Order: reserve only — 1 reserves the goods, 0 creates a shipment.
What comes from ELKO
ELKO sends the price list as an XML file. The columns of the ELKO source are the XML tag names:
| Column | What's in it | Field in Elbuz |
|---|---|---|
| Id | ELKO product code | “Supplier SKU”; used for orders and for linking the product card |
| ManufacturerCode | manufacturer part number | “Manufacturer SKU” |
| Name | name | “Name” |
| VendorName | brand | “Manufacturer” |
| Catalog | ELKO category code | category from the price list |
| Price | your price, UAH | “Price” |
| RRP | RRP, UAH | “RRP” |
| Quantity | stock | “Stock status (from price list)” (stock) |
| FullDsc | key specifications in brief | “Short description” |
| EanCode, Warranty, HttpDescription | barcode, warranty, link to the product on ELKO | “EAN barcode”, “Warranty”, “Product link (URL)” |
| content_description, content_weight, content_width, content_height, content_depth | description, weight and dimensions | “Full description”, “Weight”, “Width”, “Height”, “Length” |
Photos come with the price list — all product photos, plus weight and dimensions verified by ELKO itself. ELKO's RRP is in hryvnias; older mapping versions set the RRP currency to US dollars, new sources use UAH.
1
Supplier SKU = Id2
Price = Price, UAH3
RRP = RRP, UAH- Supplier SKU is taken from the Id field of the feed.
- Price is taken from the Price field, in UAH.
- RRP is taken from the RRP field, in UAH.
Why descriptions and specifications arrive in batches
ELKO returns descriptions and specifications for only one product per request, and the API allows no more than 50 requests per 10 seconds — above that, ELKO blocks access for a minute. So the app:
- fetches 4 products at a time and keeps the pace below the limit;
- collects as much as it can in one import within “Descriptions and attributes: seconds per import”; the rest during the next imports, in-stock products first;
- stores the cards separately from the price list and refreshes them every 30 days; the “Import” button doesn't erase them.
During an import, the log shows “ELKO descriptions and attributes: ‹N› of ‹N› received…”. For a large price list, the first fill takes several imports — that's normal.
When a product is added to the base catalog, its card arrives already filled in (product specifications, product photos).
How ELKO stock is read
ELKO shows the exact quantity up to 10 pcs, then thresholds: “> 10”, “> 40”, “> 100”. The standard statuses recognize this with no setup: a number from 1 up means “In stock” with the threshold itself as the quantity; 0 means “Out of stock” (product stock in a supplier price list).
How to send an order to ELKO and get the waybill
A purchase order created in Elbuz for the ELKO contact is sent from the document with the “Send to supplier” button. First enter the delivery address number in “Order: delivery address (addressNumber)”.
ELKO creates a real shipment, so the app asks for confirmation before sending. You can't cancel or change the shipment from Elbuz — only in your ecom.elko.ua account.
- the app checks whether this document has already been sent to ELKO;
- it sends the lines by ELKO code; identical products are merged into one line;
- ELKO creates the shipment (as a reservation if “reserve only” = 1); the shipment number is saved to the document, and its state goes to the supplier status.
The state is updated only with the “Refresh status from supplier” item: it shows the shipment state (“Awaiting processing”, “Picking”, “Ready for pickup”…), and once the waybill appears, saves it to the document.
Sending again doesn't create a second shipment. If the document already has an ELKO number, clicking the button again sends nothing.
We tested order sending against a simulated ELKO server, not a real order. Make your first order a small one and check the result in your ecom.elko.ua account.
How to choose an ELKO warehouse
ELKO has two warehouses: Warehouse 1 (wh1) and Warehouse 2 (wh2); the value all means both. The warehouse for the price list and the warehouse for orders are set separately, in the “Request parameters” card. By default, it works as before the second warehouse: the price list shows the total for both warehouses, and orders ship from Warehouse 1.
1
Warehouse for price list stock2
Order: shipping warehouse3
Order: split between warehouses- Warehouse for price list stock — all, or one of the two warehouses.
- Order: shipping warehouse — which warehouse ships the order.
- Order: split between warehouses — let ELKO fill one order from both warehouses.
Stock in the price list
“Warehouse for price list stock” sets what goes into the Quantity column, that is, the product's stock:
- all — total for both warehouses. A product that's only in Warehouse 2 will also be in stock;
- wh1 or wh2 — stock is counted for that warehouse only. A product it doesn't have won't be in stock, even if the other warehouse has it.
Set one warehouse when orders ship only from it: then your shop won't promise customers a product that warehouse doesn't have. The new value applies from the next price list import.
Where the order ships from
| “Order: shipping warehouse” | “Order: split between warehouses” | What ELKO does |
|---|---|---|
| wh1 | 0 | ships only from Warehouse 1 |
| wh2 | 0 | ships only from Warehouse 2 |
| all | 0 | picks one warehouse that can fulfill the order |
| all | 1 | first looks for one warehouse; if neither has everything, splits the order between the two warehouses |
With wh1 or wh2, the app doesn't pass “Order: split between warehouses” = 1 to ELKO: ELKO allows splitting only for all. Enter the warehouse in Latin letters — wh1, wh2 or all. The app won't accept any other value: the price list won't import and orders won't be sent until the warehouse is fixed.
Under ELKO's rules, pickup is available only from Warehouse 1. You can't choose pickup in an order sent from Elbuz — place such orders in your ecom.elko.ua account.
Scenarios
Add ELKO products to the catalog with descriptions and specifications
What to do. “Full product cards” = 1 (new sources already have this), source import on a schedule.
Result. Photos and dimensions are there right away; descriptions and specifications fill in over several imports, in-stock products first. After that, products are added to the catalog already filled in.
Reserve products at ELKO for a customer order
What to do. “Order: reserve only” = 1, delivery address entered; create a “Purchase order” for ELKO and click “Send to supplier”.
Result. ELKO reserves the products, and the shipment number is saved to the document.
Sell and order only from Warehouse 2
What to do. “Warehouse for price list stock” = wh2, “Order: shipping warehouse” = wh2; import the price list again.
Result. Stock in the price list is from Warehouse 2 only, and ELKO ships orders from it too.
Ship from any warehouse that has the product
What to do. “Warehouse for price list stock” = all, “Order: shipping warehouse” = all, “Order: split between warehouses” = 1.
Result. Your shop sees ELKO's total stock. ELKO picks the order from one warehouse, or from two if neither has everything.
Create the shipment right away and track the waybill
What to do. “Order: reserve only” = 0; after sending, click “Refresh status from supplier” from time to time.
Result. ELKO creates the shipment, and the waybill number appears in the document as soon as ELKO creates it.
What to do when the ELKO price list didn't arrive or the order wasn't sent
Why the price list didn't update
If the token has expired, the username or password is wrong, or the Elbuz IP address isn't on the approved list, ELKO returns an error, and the log shows “Supplier API error: ELKO Catalogs/Products: …” with ELKO's message. The app then doesn't overwrite the price list: prices and stock stay from the previous import (how it works in general).
| What you see | Why | What to do |
|---|---|---|
| “ELKO Catalogs/Products: …” with an access code | Expired token, wrong username or password, or the IP address isn't approved | Update the token or enter the username and password; ask ELKO to approve the Elbuz IP address (what to ask for) |
| RRP is dozens of times higher than the price | In an old source, the RRP currency is set to US dollars | On the “Columns” tab, set the currency in the “RRP” row to UAH |
| Products have only one photo each | The old settings took only one photo | Import the price list again — with this version, all photos come through |
| “No ELKO delivery address…” | The “Order: delivery address” parameter is empty | Enter the addressNumber from “Get reference data” (parameters) |
| “ELKO: unknown warehouse “…” in the API source parameters…” | The warehouse parameter isn't wh1, wh2 or all — for example, it's typed in Cyrillic | Enter wh1, wh2 or all in Latin letters (warehouses) |
| The order wasn't split between warehouses | The shipping warehouse is wh1 or wh2 (ELKO allows splitting only for all), or “Order: split between warehouses” = 0. If one warehouse has the whole order, ELKO doesn't split it even with all and 1 | Set “Order: shipping warehouse” = all and “Order: split between warehouses” = 1 |
FAQ
What do I enter for ELKO API access?
Your ecom.elko.ua username and password — the app gets the token itself. Or the full API token from your ELKO account in “Password (token)”.
How do I speed up filling ELKO descriptions?
Increase “Descriptions and attributes: seconds per import” — one import will collect more products. The app never sends requests faster than the ELKO limit (50 requests per 10 seconds).
Can I get ELKO descriptions in Russian?
Yes. Set “Language of price list, descriptions and specifications” = ru — the app fetches the descriptions again.
Can I take stock from only one ELKO warehouse?
Yes. Enter wh1 or wh2 in “Warehouse for price list stock” and import the price list again. The default is all — the total for both warehouses.
Can ELKO pick one order from two warehouses?
Yes, if “Order: shipping warehouse” = all and “Order: split between warehouses” = 1. ELKO first looks for one warehouse that has the whole order and splits it only when there's no such warehouse.
Can I cancel an ELKO shipment from Elbuz?
No. Cancel or change shipments in your ecom.elko.ua account.
Will the ELKO waybill number come in automatically?
No, only after you click “Refresh status from supplier”. This item shows the shipment state and saves the waybill to the document once ELKO creates it.
Where to find it and who has access
- Menu
- Directories → Processing price lists → List of price lists
- New source
- new source wizard, the “From where” step → the “API” tile → “ELKO”
- Access and parameters
- source card, the “Source” section → “API settings”
- Order
- “Purchase order” document → “Send to supplier”
- Access right
- the “List of price lists” window plus “Import settings” and “…price list file”; for orders — editing documents
- Prepare
- your ecom.elko.ua username and password or an token; the Elbuz on ELKO's approved list
Related topics
- For the overall picture of ready-made integrations and the parameters window — How to connect a supplier via API.
- If the price list has imported and you need to set up the schedule and import — price list import.
- If you need to build supplier orders from your shop's needs — purchase orders.
- If the “> 10”, “> 40” thresholds should be read differently — product stock in a supplier price list.
