↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect a supplier via API

    5 min readUpdated

    Elbuz pulls products, prices and stock directly from the supplier's service — no file to upload or send. We built twenty supplier integrations; you provide only the login and password.

    When you need this:

    • The supplier has a ready-made integration — columns come premapped, no matching step.
    • The supplier asks for an IP to allowlist — the Elbuz server IP is in the access settings.
    • You need only your warehouse or pickup point — its ID goes into request parameters.
    • You need attributes and photos — some integrations include them in the price list.

    Where to start: new source wizard → “From where” step → “API” tile → your supplier.

    What an API connection can do

    • Twenty ready-made integrations — suppliers from Ukraine, Moldova, Kazakhstan, Slovakia, plus international ones.
    • Mapping done in advance — the server address, format and columns are filled in automatically.
    • Access settings — login, password and the IP address for the allowlist in one window.
    • Request parameters — catalog language, warehouse, price list scope, currency rate.
    • Supplier reference data — lists of warehouses, categories and brands with their .

    Which suppliers connect via API

    A ready-made API integration is a module we have written for a specific supplier. There is no file at all: the program calls the supplier's service and gets products, prices and stock directly. All you provide is the login and password.

    There are twenty such integrations, available on every account. You choose them only in the wizard, at the “From where” step: the “API” tile, with the subheading “Ready-made API integrations” and the hint “Suppliers whose API we maintain ourselves — pick one, then set the access parameters.” The list shows the supplier's name, country and domain.

    CountrySuppliers
    InternationalBigBuy, vidaXL, Yukatel
    KazakhstanAl-Style, ComPortal
    MoldovaAccent, dmlink.md, eMag, Ultra
    SlovakiaPHOENIX Zdravotnícke zásobovanie
    UkraineAntey, artline.ua, BRAIN, DC Link, ELKO, ERC, MTI, Omega, Yug-Contract, Unik Trade

    The order in the table matches the screen: country groups follow the internal country code, not the alphabetical order of the country name, so the largest group — Ukraine — comes last. Country names are shown in the interface language, and each country forms exactly one group.

    New source wizard, “From where” step: the API tile is selected and a list of ready-made API integrations appears below
    1API tile
    2Supplier row with country and domain
    3Explanation under the heading
    1. The API tile switches the step to ready-made integrations.
    2. Each row shows the supplier name, its country and its website domain.
    3. The note explains that these are suppliers whose API is maintained by the platform, so you only enter access parameters.

    Some integrations have their own articles:

    • ERC — how to import stock for only the warehouse you need.
    • Brain — full product cards with descriptions and photos, sending orders.
    • DC Link — full product cards and reservation from a document.
    • Yug-Contract — photos, full product cards and orders with reservation.

    What happens when you pick an integration

    When you pick a supplier from the list, the program does four things for you:

    • fills in the API server address;
    • sets the correct price list format;
    • creates the list of request parameters;
    • maps the column addresses in advance — SKU, name, price, RRP, stock, category.

    That is why the API wizard has no third step: column is already done, so there is nothing to check. Instead of the column table, the wizard opens the access settings window right away.

    An integration is bound to a source once and for good. You can't switch a source from one API to another in the interface — even if you have just picked the wrong supplier. The only way out: create a new source and pick the right integration in the wizard.

    How to enter credentials and the IP for the allowlist

    The window is called “API access settings”; its title shows the integration name and the supplier's domain. To open it later, use the “API settings” button in the “Source” section. It contains three cards.

    “Access” — “API Server URL”, “Login” and “Password (token)”. The address is already filled in; you only enter the credentials the supplier gave you. Everything is saved automatically.

    Below the fields is the line “IP address of the Elbuz Jumper server to give to the supplier for access:” followed by the IPv4 address. If the supplier asks for your for their API allowlist, take it from here: API requests come from the Elbuz server, not your computer or office, so your ISP's address won't work.

    “Request parameters” — what to request and how: catalog language, warehouse, filters. A table with the columns “Parameter”, “Value” and “Description”; an edited value is saved immediately. If the supplier has no extra parameters, you'll see “This API has no additional request parameters.”

    “Supplier reference data” — the “Get reference data” button. It asks the supplier for lists of warehouses, categories and brands with their IDs, so you can put those IDs into the request parameters.

    The window header has an “Import” button: it saves the credentials and starts the import. The import runs not in this window but in the source list window — so if you closed it, you'll see “Open the “Supplier price lists” window and start the source import.”

    How to set up request parameters

    Each supplier has its own parameters. A few examples to show what this is about:

    API access settings window: request parameters table and supplier reference data card
    1Parameter column
    2Value column
    3Get reference data button
    1. The Parameter column names what is requested from the supplier.
    2. The Value column holds the value for each parameter; it is saved as soon as you edit it.
    3. The button loads the supplier's reference lists (warehouses, categories, brands) with their IDs.
    SupplierParameterDefaultWhat it means
    ERC“Language code”uacatalog language; possible values ru, ua, ru-ru, uk-ua
    ERC“Import currency rate”1take the supplier's currency rate along with prices
    ERC“API URL for attributes and photos”emptya link with a token to a separate attributes and photos service, for example: https://api.erc.ua/api/erc/wares.xml?token=; without it the price list comes without attributes or extra photos
    BRAIN“Pickup point (ID)”29the warehouse whose stock is shown
    BRAIN“Price list scope”00 — only the stock of the selected pickup point; 1 — the supplier's whole catalog
    DC Link“Import currency rate”1same as in ERC

    The “Price list scope” parameter in BRAIN looks harmless, but 1 instead of 0 means “give me the whole catalog”. The parameter description says so directly and warns that this is not an “in stock only” filter. The price list grows many times over — up to hundreds of thousands of items. If in doubt, keep the default.

    The API price list loaded, but there are no attributes or photos. In ERC, attributes, descriptions and extra photos come in a second request — via the link in the “API URL for attributes and photos” parameter.

    If the token in that link is wrong or expired, the import doesn't stop: prices and stock arrive, attributes and photos are skipped. The source log shows “Supplier API error: attributes and photos were not loaded (check the token in “API URL for attributes and photos”)” with the service's response after the colon. Ask the supplier for a new token and paste the link with it into this parameter; how to build the link — see the ERC article.

    If such a change has already gone through, the next import removes the extra items — see the steps in “If the method was set up wrong”.

    Where to find a warehouse or pickup point ID

    The “Get reference data” button doesn't work for every integration: nine of the twenty active ones have no reference data — ERC, DC Link, Yug-Contract, BigBuy, Antey, vidaXL, artline.ua, dmlink.md and PHOENIX. The window says so: “This integration has no reference data: the supplier does not provide lists of warehouses, categories or other values for the request parameters. Fill the parameters in manually, following the supplier documentation.” In that case, ask the supplier for the warehouse or pickup point ID.

    Some integrations send more than a price list: supplier categories, product attributes or photos — they arrive as separate files next to the price list. ERC and DC Link, with “Import currency rate” turned on, also pass their own currency rate, which is applied to prices.

    In the run log, API work shows up as the lines “Connecting to the API server” and “File received: ‹size› MB”. If the supplier refused, the log gets “Supplier API error: ‹reason›” — after the colon is the supplier's verbatim response, and that is what you need to read.

    Scenarios

    You need stock for your own BRAIN pickup point only

    What to do. In the new source wizard, at the “From where” step, pick the “API” tile, then BRAIN in “Ready-made API integrations”. In “API access settings” enter the “Login” and “Password (token)”, click “Get reference data” and find your pickup point. Enter its ID in “Pickup point (ID)”; leave “Price list scope” at 0.

    What you get. The price list comes from the stock of the selected pickup point. Columns are already mapped; there is no separate column matching step.

    What won't happen. Without a pickup point ID the price list isn't requested at all. “Price list scope” 1 doesn't filter “in stock only” — it returns the supplier's whole catalog. A wrong integration can't be fixed by switching — only by creating a new source. Other Brain settings are in the Brain integration article.

    You picked the wrong supplier in the wizard

    What to do. Create a new source and pick the right integration at the wizard's “From where” step. Disable or delete the wrong source.

    What you get. The new source gets the server address, format and column mapping of the right supplier.

    What won't happen. You can't switch an existing source to another integration in the interface.

    What to do when the API price list doesn't arrive

    Common problems
    What you seeWhyWhat to do
    “Supplier API error: ‹reason›” The supplier refused; the text after the colon is their verbatim response Most often the login or password is wrong, or the supplier hasn't added our IP address to the allowed list (about access settings)
    “Open the “Supplier price lists” window and start the source import.” You clicked “Import” in the API settings window while the source list window was closed Open the source list and start the import from there (about access settings)
    “Pick a supplier from the ready-made API list” The “API” type is selected in the wizard, but no supplier is selected in the list: no is bound to the source Select a row in the “Ready-made API integrations” list (about integrations)

    FAQ

    Can I switch a source to another API integration?

    No. The integration is bound once and can't be changed in the interface. If you picked the wrong supplier, create a new source and pick the right integration in the wizard.

    The supplier I need isn't among the ready-made integrations. What do I do?

    Agree on a file: a direct link, an email with an attachment, or access. These methods work with any supplier — ways to receive a price list.

    The supplier asks for our IP to access the API. Where do I find it?

    In the “API access settings” window, the “Access” card, the line “IP address of the Elbuz Jumper server…”. Don't give the IP of your computer or office: the API is called by the Elbuz server.

    The ERC price list loads without attributes and photos. What do I do?

    Check the token in the “API URL for attributes and photos” parameter. If it has expired, prices arrive but attributes and photos are skipped. Ask for a new token — about ERC.

    The “Get reference data” button does nothing. Why?

    Nine integrations have no reference data: the supplier doesn't provide lists of warehouses and categories. In that case, ask the supplier for the warehouse or pickup point ID — about reference data.

    Where it is and who has access

    Menu
    Directories → Processing price lists → List of price lists
    Choosing an integration
    new source wizard, the “From where” step → the “API” tile
    API settings
    the “Source” section → “API settings”
    Access right
    the “List of price lists” window plus “Import settings” and “…price list file”
    Prepare
    login and password (token) from the supplier; sometimes a warehouse or pickup point ID

    How to go through the new source wizard is covered in How to go through the source connection wizard.

    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