↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect the VS Trade price list: exact stock, category tree and photos

    3 min readUpdated

    Elbuz fetches the vs trade price list from vstrade.kz itself: price in tenge, exact stock, brand, part number, name, category tree and product photo. No login or column mapping.

    When you need this:

    • You mapped the VS Trade price list manually — the integration maps columns consistently and survives accidental edits.
    • You need the VS Trade catalog as a tree — categories arrive with parent sections.
    • Site stock should barely lag the warehouse — the file arrives in seconds, so update several times a day.

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

    What the VS Trade integration does

    • Price list with no manual mapping — VS Trade code, part number, name, brand, description, price in tenge, stock and category.
    • Product photo — the VS Trade price list has one photo per product.
    • Catalog as a tree — categories with their parent sections: “Компьютеры, ноутбуки / Моноблоки” (computers, laptops / all-in-ones).
    • Exact stock — in pieces, for in-stock products only.

    Prices and stock update on a schedule, like for any price list source. How ready-made integrations work in general is covered in How to connect a supplier via API.

    Where the app gets the VS Trade price list

    The app downloads the price list from https://www.vstrade.kz/export/exportspec.xml — the same file VS Trade dealers connect by link. No login or password needed.

    If your VS Trade manager gave you a different price list link, enter it in the “API Server URL” field and the app will download from it.

    How to connect VS Trade

    1. In the new source wizard, at the “From where” step, choose the “API” tile and “VS Trade” in the list.
    2. Click “Import” — the price list arrives in a few seconds.

    The app fills in the address, sets the format, product node offer, category node category, column mapping, photo import and KZT currency (what the binding does).

    If you already connected the VS Trade price list by link and mapped the columns manually, you can create the new source alongside it, compare the results and turn off the old one.

    What comes from VS Trade

    The columns of an XML price list are tag names. The VS Trade price list has no separate name tag: the full product name sits in the model tag, so the binding takes the name from there.

    ColumnWhat it containsField in Elbuz
    [id]VS Trade product code (offer attribute)“Supplier SKU”
    partnomermanufacturer part number“Manufacturer SKU”
    modelfull product name“Name”
    vendorbrand“Manufacturer”
    descriptiondescription (mostly repeats the name)“Short description”
    quantitywarehouse stock, pieces“Stock status (from price list)” and “Quantity”
    categoryIdVS Trade category codecategory from the price list
    priceprice, tenge“Price”

    VS Trade often writes the brand in lowercase (“hp”); the manufacturer directory maps it to the same manufacturer as “HP” from other price lists. The VS Trade price list has no specifications.

    The Products tab of the VS Trade source filtered by manufacturer, with the Product preview panel on the right
    1Product photo
    2Manufacturer
    3Stock status
    4Product preview
    1. Product photo — the picture that came with the supplier feed.
    2. Manufacturer — the brand, filtered here to one maker.
    3. Stock status — the stock level taken from the supplier's price list.
    4. Product preview — the selected row's photo, name and description.

    What happens to a product VS Trade has run out of

    A product that runs out simply disappears from the price list, and the app treats it as unavailable from the supplier, following the rules you've set for missing products (what happens to a product that's no longer in the price list).

    The VS Trade price list only has products in stock, with the exact quantity in the quantity tag. The standard statuses read that number as “In stock” and set it as the quantity (product stock in a supplier price list).

    Scenarios

    Switch from a manually mapped price list to the integration

    What to do. Create a new source with the “VS Trade” integration, import it and compare the product count and prices with the old source. Then turn off the old one.

    Result. Columns, currency, categories and photos are mapped the same way for everyone who connects VS Trade, and won't break if someone accidentally changes the mapping.

    Update stock several times a day

    What to do. In the VS Trade source schedule, set an import every two to three hours (import and schedule).

    Result. The price list is small and arrives as one file in a few seconds, so frequent updates don't load the app, and stock on your site lags the VS Trade warehouse by a few hours at most.

    Sort VS Trade products into your own categories

    What to do. Open the source's “Categories” tab and match VS Trade categories to yours (supplier category matching).

    Result. New VS Trade products land in your categories on their own when added to the catalog.

    What to do when the VS Trade price list didn't arrive

    Why the price list didn't update

    If VS Trade didn't return the price list (link closed or changed, site down), the source log shows “Supplier API error: VS Trade: …” with the server response code, e.g. “HTTP 403”, and the start of the returned page. The price list isn't overwritten: prices and stock stay from the last import (how it works in general).

    Common problems
    What you seeWhyWhat to do
    “Supplier API error: VS Trade: HTTP 403 …” VS Trade closed the link or changed the price list address Get the current link from your VS Trade manager and enter it in “API Server URL” (where the price list comes from)
    A few products have no category In the VS Trade price list the product refers to a category that isn't in the same price list Assign such products to categories manually or wait until VS Trade fixes the price list
    A product disappeared from the VS Trade price list It ran out in the warehouse: the price list only has what's in stock Nothing: the product comes back as soon as it's in stock again (stock)

    FAQ

    Do I need a VS Trade login and password?

    No. The app downloads the price list from the link VS Trade publishes for dealers (where the price list comes from).

    What currency are VS Trade prices in?

    Tenge. The binding sets KZT currency by its code.

    Does VS Trade send specifications?

    No, the VS Trade price list doesn't have them. Photos — one per product.

    Why is the VS Trade brand “hp” in lowercase?

    That's how VS Trade writes it. The manufacturer directory maps “hp” to the same manufacturer as “HP” from other price lists.

    Can I send an order to VS Trade from Elbuz?

    No. The VS Trade price list is only a file; orders are placed on the VS Trade website.

    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 → “VS Trade”
    Price list address
    source card, the “Source” section → “API settings” → “API Server URL”
    Access right
    the “List of price lists” window plus “Import settings” and “…price list file”
    Prepare
    nothing: the VS Trade price list is open by link

    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