↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect Artline via API: account prices, photos and orders from a document

    4 min readUpdated

    The Artline integration fetches the price list from opt.artline.ua — account prices and RRP, stock, description, photos, specifications — and sends supplier orders to Artline from a document.

    When you need this:

    • Your Artline account is in dollars — the app reads each row's currency and converts the price to hryvnias.
    • You need products with photos and descriptions — they come with the price list, no separate catalog.
    • You sell from one Artline warehouse — stock comes from it.
    • You enter Artline orders by hand — one button in a document creates the order, with its status in Elbuz.

    Where to start: get the API key in your opt.artline.ua account.

    What the Artline 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 Artline.

    Where to get the Artline API key

    You need one key — an access-token. You'll find it in your account on the opt.artline.ua portal, in the “Price lists” section. Enter the key in “Password (token)” in the API settings window; the “Login” field isn't used for Artline.

    Which Artline request parameters to fill in

    In the new source wizard, at the “From where” step, choose the “API” tile and “artline.ua”. The app fills in the address https://opt.artline.ua/api/, the format, columns, and photo and specification import itself (what exactly it does). In the “API access settings” window, enter the key in “Password (token)”.

    The “Get reference data” button shows Artline warehouses with their s and the Artline exchange rate — you'll need the warehouse ID for the “Artline warehouse (ID)” parameter.

    Parameters in the “Request parameters” card
    ParameterDefaultWhat it does
    “In-stock products only”11 — the price list without out-of-stock products; 0 — the whole catalog
    “Artline warehouse (ID)”emptystock from one warehouse; empty — total stock
    “Order: payment”22 — without VAT, 1 — with VAT
    “Order: delivery”emptytext for Artline: city, branch, recipient, phone; empty — the manager will clarify delivery

    For sources connected earlier, these four rows, the product key (column 1) and photo and specification import were added in this version.

    The
    1Artline warehouse (ID)
    2Order: payment
    3Order: delivery
    1. Artline warehouse (ID) — stock from one warehouse; leave empty to use total stock.
    2. Order: payment — 2 means without VAT (default), 1 means with VAT.
    3. Order: delivery — delivery text passed to Artline; if empty, the manager will clarify.

    What comes from Artline

    The app builds a CSV file from the API response: each product is a row, each field is a numbered column.

    ColumnWhat's in itField in Elbuz
    1Artline product code“Supplier SKU” and “Product ID (UUID string)” with the “Consider uniqueness” flag: photos and specifications are linked by it, and orders use it
    2part number“Manufacturer SKU”
    3name“Name”
    4, 5Artline category code and namecategory from the price list
    6RRP, UAH“RRP”
    7F1 pricefree column
    8F2 price“Price”
    9row currency: USD or UAH“Currency”
    10stock“Stock status (from price list)” (stock)
    11description ()“Full description”
    12photos separated by “;”used for product photos (photos)

    For sources connected earlier, the description may have been in “Short description” — if needed, move address 11 to the “Full description” row.

    The Columns grid of the Artline source with column addresses
    1Supplier SKU = column 1
    2Price = column 8
    3Currency = column 9
    1. Supplier SKU — read from column 1.
    2. Price — read from column 8.
    3. Currency — read from column 9.

    How F1, F2 prices and the account currency work

    The mapping takes F2 (column 8). Artline gives two account prices — F1 and F2 — in the dealer's account currency: dollars or hryvnias. The app reads each row's currency from column 9 and converts the price to hryvnias when applying the markup, so a dollar account needs no manual setup. The RRP (column 6) is always in hryvnias.

    Need the F1 price? Set address 7 in the “Price” row.

    How photos, specifications and descriptions arrive

    Artline sends photos, specifications and the description together with the price list, no separate catalog needed:

    • Photos — all product photos (1200×1200); not every product has them.
    • Specifications — “name: value” pairs; several values of one specification become one line joined with “ / ”.
    • Description — with HTML markup, in “Full description”.

    When you add a product from the price list to the base catalog, the card arrives filled in, and specifications are matched to your attributes (product specifications, product photos).

    How Artline stock is read

    Artline writes stock as text: “1 шт”, “2 шт”, “>3 шт” (pcs) — the exact quantity only up to 3 units. Standard statuses recognize this without setup: any number means “In stock”, and the quantity is that number (“>3 шт” becomes 3 units). Out-of-stock products aren't in the price list while “In-stock products only” = 1.

    How to send an order to Artline

    A purchase order created in Elbuz for the Artline contact is sent from the document with the “Send to supplier” button. The app takes the parameters from the first active API source of the contact the document is issued to.

    Artline creates a real order, so the app asks for confirmation before sending. You can't delete or change the order from Elbuz — only in your Artline account.

    What happens after you click

    1. the app checks whether this document has already been sent to Artline;
    2. it sends the lines by Artline code; identical products are combined into one line;
    3. it passes the payment method, the delivery text from the parameters and the comment “Elbuz ‹document number›”.

    The Artline order number is saved to the document, and the status from the supplier is “New order”. If Artline didn't add all products to the order, the app lists them after “Warning:”.

    Clicking again doesn't create a second order. If the document already has an Artline order number, clicking again sends nothing and shows that number.

    Order status

    The status updates only with “Refresh status from supplier”. It asks Artline for the current status and shows “Artline: order ‹number› — ‹status›, ‹payment›”: for example, “До відвантаження, Не оплачений” (ready to ship, not paid). The status is saved to the document as the status from the supplier.

    We tested sending orders against a simulated Artline server, not a real order. Make your first order a small one and check the result in your Artline account.

    Scenarios

    Account in dollars, prices on the site in hryvnias

    What to do. Nothing extra: the mapping already takes the currency from column 9.

    What you get. Each product's price is converted to hryvnias at your dollar rate when the markup is applied.

    Sell only from your Artline warehouse

    What to do. Click “Get reference data”, find the warehouse ID and enter it in “Artline warehouse (ID)”.

    What you get. The price list shows stock from that warehouse only.

    Order from Artline with delivery

    What to do. Fill in “Order: delivery” (city, branch, recipient, phone), create a “Purchase order” for Artline and click “Send to supplier”.

    What you get. The Artline order number is saved to the document, and “Refresh status from supplier” shows the status and payment.

    What to do when the Artline price list didn't arrive or the order wasn't sent

    Why the price list didn't update

    If the key is wrong, Artline refuses, and the log shows “Supplier API error: Artline catalog/list: …” with Artline's text. If the key isn't entered, you'll see “Artline: 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
    “Column addresses are not filled in… “Consider uniqueness”” on a new Artline source This happened in older versions: the mapping didn't set the uniqueness flag On the “Columns” tab, set “Consider uniqueness” in the “Supplier SKU” row (address 1)
    “Supplier API error: Artline catalog/list: …” The API key is wrong or outdated Get the key in your opt.artline.ua account, “Price lists” section (where to get it)
    The source was connected long ago, and there are no photos or specifications They weren't imported before Import the price list again — with this version they come
    “No Artline code on the lines…” The document's product isn't matched with the Artline price list Match the product with the Artline price list (product matching)

    FAQ

    Do I need to turn anything on to get Artline photos and specifications?

    No, they come with the price list: all photos, specifications and the description (more).

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

    That's set by “In-stock products only” = 1. Set it to 0 to get the whole catalog.

    Why is the quantity of Artline products never more than 3?

    Artline shows exact stock only up to 3 units; above that it shows “more than 3”. The app takes 3.

    Will a duplicate be created if I click “Send to supplier” twice?

    No. If the document already has an Artline order number, the app doesn't send again and shows that number.

    Can I change or delete an Artline order from Elbuz?

    No. Make changes in your Artline account.

    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 → “artline.ua”
    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
    an API key (access-token) from your opt.artline.ua account

    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