↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect ELKO via API: price list, descriptions in batches and shipments with a waybill

    6 min readUpdated

    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

    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

    1. 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)”.
    2. 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.

    Parameters in the “Request parameters” card
    ParameterDefaultWhat it does
    “Full product cards”11 — descriptions and specifications from ELKO (more); 0 — price list only
    “Language of price list, descriptions and specifications”uaua — 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”240how long one import spends collecting descriptions and specifications (why)
    “Order: delivery address (addressNumber)”emptythe address number from “Get reference data”; without it the order isn't sent
    “Order: reserve only”11 — ELKO reserves the products; 0 — ELKO creates a shipment
    “Warehouse for price list stock”allall — total for both warehouses, wh1 or wh2 — one warehouse only (more)
    “Order: shipping warehouse”wh1wh1 — Warehouse 1, wh2 — Warehouse 2, all — ELKO chooses the warehouse
    “Order: split between warehouses”01 — 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.

    Request parameters card of the API access settings window
    1Descriptions and attributes: seconds per import
    2Order: delivery address
    3Order: reserve only
    1. Descriptions and attributes: seconds per import — how long one import may spend fetching product descriptions.
    2. Order: delivery address — the address number from the reference data; orders are not sent without it.
    3. 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:

    ColumnWhat's in itField in Elbuz
    IdELKO product code“Supplier SKU”; used for orders and for linking the product card
    ManufacturerCodemanufacturer part number“Manufacturer SKU”
    Namename“Name”
    VendorNamebrand“Manufacturer”
    CatalogELKO category codecategory from the price list
    Priceyour price, UAH“Price”
    RRPRRP, UAH“RRP”
    Quantitystock“Stock status (from price list)” (stock)
    FullDsckey specifications in brief“Short description”
    EanCode, Warranty, HttpDescriptionbarcode, warranty, link to the product on ELKO“EAN barcode”, “Warranty”, “Product link (URL)”
    content_description, content_weight, content_width, content_height, content_depthdescription, 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.

    Columns sub-tab of the price list: left part of the grid
    1Supplier SKU = Id
    2Price = Price, UAH
    3RRP = RRP, UAH
    1. Supplier SKU is taken from the Id field of the feed.
    2. Price is taken from the Price field, in UAH.
    3. 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.

    1. the app checks whether this document has already been sent to ELKO;
    2. it sends the lines by ELKO code; identical products are merged into one line;
    3. 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.

    Request parameters card: the three warehouse parameters
    1Warehouse for price list stock
    2Order: shipping warehouse
    3Order: split between warehouses
    1. Warehouse for price list stock — all, or one of the two warehouses.
    2. Order: shipping warehouse — which warehouse ships the order.
    3. 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

    Shipping warehouse and order splitting
    “Order: shipping warehouse”“Order: split between warehouses”What ELKO does
    wh10ships only from Warehouse 1
    wh20ships only from Warehouse 2
    all0picks one warehouse that can fulfill the order
    all1first 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).

    Common problems
    What you seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free