↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect DC Link via API: price list method, stock stars and reservation

    6 min readUpdated

    Elbuz fetches the DC Link B2B price list itself — dollar dealer price, RRP, stock — and, if needed, full product cards with description, specifications and photos via the same sign-in.

    When you need this:

    • You need only in-stock products, or also those in transit — the price list method decides how many come in.
    • Products must enter the catalog with description and photos — DC Link cards are fetched in batches and kept between imports.
    • Purchase orders must be reserved in DC Link — you reserve from the document; invoice and waybill numbers come back.

    Where to start: ask your DC Link manager for an API login and password.

    What the DC Link integration does

    The DC Link subcategory code and name come with every product; you match them to your categories as with any price list (category matching).

    What you need from DC Link: one sign-in for the price list and cards

    1. API login and password. The DC Link B2B portal (online.dclink.ua) has an API section that also describes the “API 2.0 (recommended)” methods. DC Link issues the login and password; if you don't have them, ask your manager.
    2. Full cards don't need a separate sign-in. The DC Link card service (cerebro.dclink.ua) accepts the same login and password, and Elbuz uses them automatically.
    3. Warehouse — only to reserve from one warehouse. DC Link provides no reference data, so get the ID from your manager.
    4. You don't have to provide an IP address. If your DC Link manager asks for the address requests will come from, it's in the access parameters window (where exactly).

    Which DC Link request parameters to set

    In the new source wizard, at the “From where” step, choose the “API” tile and DC Link. Elbuz sets the address https://api.dclink.com.ua/api/, the format and the columns itself (what the binding does). Enter the DC Link API login and password in “Login” and “Password (token)”. Here “Get reference data” only shows “This integration has no reference data…”.

    ParameterDefaultWhat it does
    “Full product name”0passed to DC Link as is; in our price list samples it didn't change the set of tags
    “Price columns”11 — the price list gets extra prices: PriceOpt, RetailPrice, PricePartner, PriceMin
    “Import currency rate”11 — fetch the DC Link non-cash dollar rate before each import (details)
    “Method for fetching products”GetBnPriceswhich method to use for the price list: GetPrice, GetBnPrices or GetPriceAll (details)
    “Company type”east,fcu,opt,dcpassed to DC Link as is in the firm parameter; the DC Link description of GetBnPrices names east and fcu as company keys
    “Full product cards”11 — description, specifications and all photos from the DC Link card service (details)
    “Merge specification values”11 — specifications with the same name become one: “Socket: LGA1200 / LGA1700” instead of two “Socket” rows; 0 — each value in a separate row
    “Specification value separator”/the character between merged values; for a comma or semicolon, a space goes only after the character: “INTEL, AMD”
    “Order: DC Link warehouse (ID)”emptyreserve from this warehouse only; empty — DC Link takes goods from its warehouses in turn (reservation)
    The “Request parameters” card of the API access settings window for the DC Link source
    1Method for fetching products
    2Full product cards
    3Order: DC Link warehouse (ID)
    1. Method for fetching products — GetPrice requests products that are in stock.
    2. Full product cards — 1 loads the description, specifications and photos from DC Link with the same login.
    3. Order: DC Link warehouse (ID) — empty means DC Link reserves from its warehouses in turn.

    Sources connected earlier have cards turned off (0) and no reservation warehouse set. New sources have cards turned on from the start.

    How many products to take: GetPrice, GetBnPrices or GetPriceAll

    “Method for fetching products” decides which method DC Link uses to return the price list. Elbuz accepts three values:

    ValueWhat comes in
    GetPriceproducts in stock; on our test account — 3,740 items, the file in a few seconds
    GetBnPricesproducts in stock and available for non-cash invoicing; on the same account the file came in empty
    GetPriceAlleverything in stock plus products in transit and made to order; on the same account — 6,295 items

    If the price list arrives without products and there are no other errors, set GetPrice: GetBnPrices depends on the terms of your DC Link contract. Elbuz replaces any other value with GetPrice. Products in transit and made to order from GetPriceAll don't get full cards.

    What comes from DC Link: names, prices and rate

    The DC Link price list is an XML file in windows-1251 encoding, where each product is a <Product> tag with nested tags. Columns the binding maps itself:

    DC Link tagField in ElbuzNote
    Code“Supplier SKU”, “Product ID (UUID string)”, and also “JAN Barcode”DC Link product code; it's used to reserve the product, pick its full card and attach photos
    Article“Manufacturer SKU”
    Name“Name”name in Russian (how to get the Ukrainian one)
    Vendor“Manufacturer”
    EAN“EAN barcode”
    PriceUSD“Price”dealer price, always in dollars
    RRP_UAH“RRP”retail price, in hryvnias
    Availability“Stock status (from price list)”stars from * to ***** (stock)
    Subcategory“Category from the price list”subcategory name
    CategoryID“Category ID (UUID string)”for category matching
    Warranty“Warranty”in months

    Other tags — NameUA, DDP, UCGFEA (Ukrainian customs commodity code), RRP, PriceType, Price, and with “Price columns” = 1 also PriceOpt, RetailPrice, PricePartner, PriceMin — are taken via a free column row: enter the tag name in “Column address”.

    Name in Ukrainian. DC Link sends two names: NameUA in Ukrainian and Name in Russian, and the binding puts Name into “Name”. If you need Ukrainian, enter the address NameUA in the “Name” row and run the import.

    Price, RRP and the DC Link rate

    The dealer price PriceUSD is always in dollars, RRP RRP_UAH in hryvnias. In the “Columns” section, the “Price” row must have USD and the “RRP” row UAH; new sources are mapped this way. Multicurrency isn't needed: PriceType with the value UAH refers to the Price tag, not PriceUSD — we checked this on 746 such products.

    If “Import currency rate” = 1, before each import Elbuz fetches the non-cash rate from DC Link and writes it into the dollar rows “Price” and “RRP” of the “Columns” section. The log has no separate line for this. If you turn the parameter off, the last DC Link rate stays — change it manually.

    The Columns grid of the DC Link source with the column addresses
    1Name column address
    2Price in USD
    3RRP in UAH
    4Availability
    5Full description
    1. Name — the product name address in the feed.
    2. Price — PriceUSD, always in US dollars, with the USD currency.
    3. RRP — RRP_UAH, in hryvnias, with the UAH currency.
    4. Stock status (from price list) — Availability, you need your own availability rule for it.
    5. Full description — content_description, the full description from the DC Link card.

    How to get full DC Link product cards

    DC Link provides description, specifications and photos not in the price list but from a separate card service with the same product code. So Elbuz links them without matching:

    • In batches of a thousand products per request. On our test source, a little over half the products got a description — DC Link has no content for the rest. Photos and specifications come for most.
    • Separately from the price list. The “Import” button doesn't erase cards.
    • New products every time, saved cards once every 30 days. The DC Link service provides no list of changes, so a card corrected yesterday updates in Elbuz once it's 30 days old.
    • Only for products in stock (stars in Availability).

    How to turn them on

    1. Turn on cards: in the request parameters, enter 1 in the “Full product cards” row.
    2. Optionally, choose how specifications are shown: “Merge specification values” and “Specification value separator”. After changing them, import the price list again — cards aren't downloaded again.
    3. Import the price list with the “Import” button. The log lines “DC Link full cards: ‹how many› of ‹how many›” show the progress.
    4. Check the description, specifications and photos in the price list products.
    Data from the DC Link cardWhere in the price listColumn address
    full description (with HTML markup)“Full description”content_description
    weight, width, height, depth“Weight”, “Width”, “Height”, “Length”content_weight, content_width, content_height, content_depth
    all photosprice list product photosno separate address needed
    all specificationsprice list product specificationsthe param tag, no separate address needed

    For DC Link, the barcode comes from the price list, in the EAN tag. Card addresses are mapped in all DC Link sources; Elbuz doesn't change your own addresses. The “Load attributes” and “Load photos” switches (the “Products” section, the “What data to load” block) turn on automatically together with cards.

    Photos without cards. Elbuz fetches a list of photo links from DC Link and attaches them to products by code. With cards on, a product that has a card gets photos from it, the rest from the list.

    When you add a product from the price list to the base catalog, its card arrives filled in (product specifications, product photos). If the card service refuses, the log shows “DC Link full cards were not received (…) — the price list is imported with the cards saved earlier”; new cards are fetched next time.

    How not to lose stock: DC Link stars

    DC Link sends stock in the Availability tag as stars: from * to *****. It's a scale, not a quantity, and the DC Link API documentation doesn't say what each number of stars means. The GetPrice method returns only in-stock products, so every product has stars.

    Without your own stock rule, products with two to five stars get “Out of stock”. The standard “In stock” status looks for an exact match, and its list has only one star *. So products with more stock come in as unavailable.

    On the source's “Availability” tab, add a rule for the “In stock” status with the values *, **, ***, ****, *****, or with a single * and substring search (stock status in a supplier price list).

    How to place a reservation in DC Link

    A purchase order created in Elbuz for the DC Link contact is sent to DC Link from the document, and DC Link places a real reservation. The warehouse is the “Order: DC Link warehouse (ID)” row in the request parameters; Elbuz takes it from the first active API source of the document's contact.

    What happens after you click

    Open the “Purchase order” document, click “Send to supplier” and confirm. Elbuz places the reservation in one request:

    1. document lines go by DC Link code; identical products are combined into one line;
    2. the reservation description says “Elbuz ‹document number›” — use it to find the reservation on the portal;
    3. no warehouse set — DC Link takes goods from its warehouses in turn; warehouse set — only from that warehouse.

    DC Link creates a separate sales invoice for each warehouse. All invoice numbers are written into the document separated by commas, the supplier status is “Reserved”, and the result appears in a message and in the document history.

    Purchase order PO-1003 with the Send to supplier button and the open menu under its arrow
    1Send to supplier
    2Refresh status from supplier
    1. Send to supplier — places the reserve with DC Link.
    2. Refresh status from supplier — pulls the current status: Reserved, Shipped with waybill, or Processing.

    When not everything is reserved

    Whatever DC Link couldn't reserve it returns with a reason; the rest stays reserved. Elbuz shows “Not reserved: ‹product› — ‹quantity› pcs, ‹reason›”, and the supplier status is “Partly reserved”. Reasons:

    • “out of stock” — the product isn't available, or isn't in the warehouse from “Order: DC Link warehouse (ID)”;
    • “all already reserved” — the product exists, but all of it is already reserved;
    • “a DDP item cannot be added to a reservation with a USD item” and vice versa — send such lines as a separate order.

    If nothing is reserved, the message is “DC Link reserved nothing: …”, and no number is written into the document.

    When nothing is sent

    • a line has no DC Link code — the product isn't matched with the DC Link price list; the message lists the names of such lines (product matching);
    • the document has no lines with a quantity above zero.

    Repeating doesn't place a second reservation. If the document already has a DC Link invoice number, clicking again shows the status of the existing reservation with the note “Already reserved in DC Link — not created again.”.

    Reservation status and waybill

    The status doesn't update by itself — only via “Refresh status from supplier” in the menu next to the send button. It checks each invoice:

    • “Reserved” — the invoice is still reserved;
    • “Shipped” with a waybill number — DC Link has shipped it; the waybill is written into the document if the waybill number field is empty;
    • “Processing” — the reservation is being handled, not shipped yet.

    We tested sending reservations on a simulated DC Link server, not on a real reservation. Make your first order small and check the result on the DC Link portal.

    Scenarios

    Add DC Link products to the catalog with description and photos right away

    What to do. “Full product cards” = 1, import the source, then add products from the price list to the base catalog as usual.

    What you get. New products in the catalog get description, specifications and photos from DC Link. Later imports update prices and stock and fetch cards for new products.

    Sell products in transit and made to order too

    What to do. “Method for fetching products” = GetPriceAll, and a stock rule for stars as described in the stock section.

    What you get. The price list has products in stock and those in transit or made to order; the latter come without full cards.

    Reserve from one warehouse only

    What to do. Get your warehouse ID from your DC Link manager and enter it in “Order: DC Link warehouse (ID)”.

    What you get. The reservation is placed only from that warehouse, one invoice per order. Whatever isn't in that warehouse is returned with the reason “out of stock”, without searching other warehouses.

    What to do when the DC Link price list is empty or didn't arrive

    Common problems
    What you seeWhyWhat to do
    The file arrived, but the price list has zero products “Method for fetching products” = GetBnPrices, and DC Link returns no non-cash items for your account Set GetPrice (method)
    “Supplier API error: …Access denied. Authorization failed…” Wrong API login or password Check the login and password in “API access settings” (when the price list didn't arrive)
    Some in-stock products come in as “Out of stock” The standard status recognizes only one star *, not **…***** Add a stock rule for all star values (stock)
    Product names are in Russian The “Name” row has the address Name Set NameUA (name in Ukrainian)
    “Partly reserved” status DC Link didn't reserve some lines — the reason is in the message Order the missing items from another supplier or as a separate order (when not everything is reserved)
    “Some lines have no DC Link code…” The document product isn't matched with the DC Link price list Match the product with the DC Link price list (product matching)

    When the price list didn't arrive

    The import log shows DC Link work as “Getting file via API”, “Connecting to the API server” and “File received: ‹size› MB”. For a wrong login or password, DC Link returns “Access denied. Authorization failed. Please check credentials!” — inside the “Supplier API error: …” line, followed by “No data received, previous product list will be displayed”.

    The price list products then stay as they were yesterday (why). Check the login and password in the access parameters window.

    FAQ

    Why does the DC Link price list come in empty?

    Most often because “Method for fetching products” = GetBnPrices: if there are no non-cash items for your account, DC Link returns an empty list. Set GetPrice.

    DC Link corrected a product description — why is Elbuz showing the old one?

    Saved cards update once every 30 days: DC Link provides no list of changes. New products get cards at every import (full cards).

    Can I cancel or move a DC Link reservation from Elbuz?

    No. Elbuz places the reservation and shows its status; you can cancel a reservation or move goods between invoices on the DC Link portal.

    How do I get DC Link names in Ukrainian?

    In the “Columns” section of the DC Link source, in the “Name” row, replace the address Name with NameUA and run the import.

    Why isn't the DC Link product quantity exact?

    In the price list DC Link sends not quantities but stars, from one to five. The quantity is calculated by the stock status rules (details).

    Where it is and who has access

    Menu
    Directories → Processing price lists → List of price lists
    New DC Link source
    new source wizard, the “From where” step → the “API” tile → DC Link
    Access and request parameters
    source card, the “Source” section → “API settings”
    Sending a reservation
    “Purchase order” document → “Send to supplier”
    Access right
    the “List of price lists” window and “Import settings: price list file”; for reservations — editing documents
    Prepare
    the DC Link login and password

    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