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
- Price list with no manual mapping — product code, part number, name, category, your account prices and RRP, stock.
- Prices in your account's dollars or hryvnias — the currency is read from each row.
- Photos, specifications and description — with the price list; products are added to the catalog already filled in.
- Total stock or stock from one warehouse.
- Orders from a document — with status and payment from Artline.
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.
| Parameter | Default | What it does |
|---|---|---|
| “In-stock products only” | 1 | 1 — the price list without out-of-stock products; 0 — the whole catalog |
| “Artline warehouse (ID)” | empty | stock from one warehouse; empty — total stock |
| “Order: payment” | 2 | 2 — without VAT, 1 — with VAT |
| “Order: delivery” | empty | text 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.
1
Artline warehouse (ID)2
Order: payment3
Order: delivery- Artline warehouse (ID) — stock from one warehouse; leave empty to use total stock.
- Order: payment — 2 means without VAT (default), 1 means with VAT.
- 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.
| Column | What's in it | Field in Elbuz |
|---|---|---|
| 1 | Artline 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 |
| 2 | part number | “Manufacturer SKU” |
| 3 | name | “Name” |
| 4, 5 | Artline category code and name | category from the price list |
| 6 | RRP, UAH | “RRP” |
| 7 | F1 price | free column |
| 8 | F2 price | “Price” |
| 9 | row currency: USD or UAH | “Currency” |
| 10 | stock | “Stock status (from price list)” (stock) |
| 11 | description () | “Full description” |
| 12 | photos 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.
1
Supplier SKU = column 12
Price = column 83
Currency = column 9- Supplier SKU — read from column 1.
- Price — read from column 8.
- 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
- the app checks whether this document has already been sent to Artline;
- it sends the lines by Artline code; identical products are combined into one line;
- 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).
| What you see | Why | What 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
- If you need the overall picture of ready-made integrations and the parameters window — How to connect a supplier via API.
- If the price list has loaded and you need to set up the schedule and import — price list import.
- If the document's product isn't matched with the Artline price list — matching supplier products.
- If you need to build supplier orders from your store's needs — purchase orders.
