↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect Al-Style via API: two prices in tenge, all photos and the request limit

    3 min readUpdated

    Elbuz fetches the al-style kz price list itself via the al-style.kz distributor API: dealer and retail prices in tenge, stock, brand, barcode, warranty, weight, description and all product photos.

    When you need this:

    • You have an API key from the Al-Style B2B portal — columns, currency and the unique SKU are set automatically.
    • You sell at the Al-Style retail price — it comes separately from the dealer price.
    • You need all product photos — all come, not just one.
    • The import takes a few minutes — that's the Al-Style limit; the app makes as few requests as possible.

    Where to start: get an API key in the Al-Style B2B portal.

    What the Al-Style 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 Al-Style.

    Where to get the Al-Style API key

    You need an API key — an access-token. The Al-Style B2B portal issues it in its API section once you register as a dealer. Enter the key in “Password (token)” in the API settings window; the “Login” field isn't used for Al-Style.

    Which Al-Style request parameters to change

    In the new source wizard, at the “From where” step, choose the “API” tile and “Al-Style” in the list. The app fills in the address https://api.al-style.kz/api/, the format, columns, the unique SKU and photo import itself (what exactly it does). In the “API access settings” window, enter the key in “Password (token)”.

    The “Request parameters” card has one parameter, “In-stock products only”: 1 (default) — the price list without out-of-stock products; 0 — the whole catalog.

    API access settings window, Request parameters card
    1In-stock products only
    1. In-stock products only — 1 skips products not in stock, 0 requests the whole catalog.

    What comes from Al-Style

    The app builds a CSV file from the API response; the first row is a header and doesn't become a product. Prices are in tenge; the KZT currency is set by code.

    ColumnWhat's in itField in Elbuz
    1, 2Al-Style category name and codecategory from the price list
    3Al-Style SKU“Supplier SKU” with the “Consider uniqueness” flag; photos are linked by it
    4brand“Manufacturer”
    5name“Name”
    7dealer price, tenge“Price”
    8retail price, tenge“RRP”
    9stock“Stock status (from price list)” and “Quantity”
    13, 14, 15weight, warranty, model“Weight”, “Warranty”, “Model”
    16, 17product link, barcode“Product link (URL)”, “EAN barcode”
    20description“Short description”
    21part number“Manufacturer SKU”

    The file has other columns too, and you can take any of them with a free row in the “Columns” section:

    • 6 — full name;
    • 10 — new arrival;
    • 18 — markdown;
    • 22 and 23 — discounted price and discount;
    • 24 — Al-Style RRP.
    Columns table of the Al-Style price list
    1Supplier SKU
    2Price
    3RRP
    1. Supplier SKU — column 3, the unique product key.
    2. Price — column 7, currency KZT.
    3. RRP — column 8, currency KZT.

    Why the import takes a few minutes

    Al-Style allows one API request every 5 seconds and returns up to 250 products per request. The app first asks for the whole catalog as one list, which takes dozens of requests. If the service returns products only by category, the app switches to going through categories on its own, and then the import takes longer.

    For the same reason, specifications aren't imported: Al-Style returns them only one product at a time, which means hours for the whole catalog.

    How Al-Style stock is read

    The mapping takes stock and quantity from column 9. Standard statuses read a number from 1 up as “In stock”, and labels like “>50” as “In stock” with a quantity of 50 (product stock in a supplier price list).

    Scenarios

    Sell at the Al-Style retail price

    What to do. Nothing: the retail price is already in the “RRP” row (column 8). If your markup is calculated from the RRP, set it up on the source's “Pricing” tab.

    What you get. Your site gets a price close to the Al-Style recommended one, and the dealer price (column 7) stays for calculating profit.

    Show the whole catalog on the site, not just in-stock items

    What to do. In the API parameters, set “In-stock products only” = 0.

    What you get. The price list will also include products that are currently out of stock at the Al-Style warehouse; standard statuses mark them as out of stock. The import takes longer: there are more products, but the request limit is the same.

    Update prices every night

    What to do. In the Al-Style source schedule, set a daily import at night (import and schedule).

    What you get. Because of the Al-Style limit the import takes a few minutes, and at night it doesn't get in the way of working with the catalog.

    What to do when the Al-Style price list didn't arrive

    Why the price list didn't update

    If the key is wrong, Al-Style refuses, and the log shows “Supplier API error: Al-Style categories: …” or “Al-Style elements: …” with the Al-Style message. If no key is entered — “Al-Style: enter the API key (access-token)…”. In that case the app 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
    “Supplier API error: Al-Style categories: …” The key is wrong or expired Get a new key in the Al-Style B2B portal (where to get it)
    “Column addresses are not filled in for columns flagged “Consider uniqueness”” on an old source Older versions of the mapping didn't set the uniqueness flag Turn on “Consider uniqueness” in the “Supplier SKU” row (address 3)
    Products have one photo or none Older versions took photos from a single column Import the price list again — this version brings all photos

    FAQ

    What currency are Al-Style prices in?

    Tenge. The mapping sets the KZT currency by code for both the dealer and retail price.

    Can I speed up the Al-Style import?

    No: the limit is set by Al-Style — one request every 5 seconds. Keep “In-stock products only” = 1 — there will be fewer products and requests.

    Can I import specifications from Al-Style?

    No. Al-Style returns them only one product at a time, and with its limit that means hours for a catalog (why).

    Why doesn't the Al-Style price list include out-of-stock products?

    That's what “In-stock products only” = 1 does. Set it to 0 to get the whole catalog; the import will take longer.

    Can I send an order to Al-Style from Elbuz?

    No. The Al-Style API doesn't accept orders; orders are placed in the B2B portal.

    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 → “Al-Style”
    Key and parameters
    source card, the “Source” section → “API settings”
    Access right
    the “List of price lists” window plus “Import settings” and “…price list file”
    Prepare
    an API key (access-token) from the Al-Style B2B portal

    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