Partner integrations and setup guide
This page shows how to connect the BYB partner feed to your own system. Every link is in your account, on the Price list feed card, with your own token. The token is personal to you, please do not share it; if it gets out you can request a new one in your account with one click, and the old one becomes invalid immediately.
What the feed contains
There are two endpoints, with the same token. The lean feed (/feed) gives price and stock, in CSV, XML or JSON; poll this several times a day. The full feed (/feed/teljes) carries the same with content: category, warranty, product page URL, images, technical attributes and description, in XML or JSON; once a day is enough. From the full feed you can also get a ready-made import file for your own shop platform, in WooCommerce, Shoptet or Shopify format. The price comes at your own price level, in net forint, together with the binding EUR and USD price on a fixed base rate, and committed stock is already deducted. The volume price bands are in the root of the feed.
Stock: our own and our supplier's
Every item carries three stock numbers, because it matters whether the piece is with us or with our supplier.
- keszlet_sajat — what sits in our own warehouse. This ships the same or the next day.
- keszlet_kulso — our supplier's stock. We can order it, but it is not immediate; the expected arrival is in the beszerzesi_ido field where we know it.
- keszlet — the sum of the two. This field has not changed, so if your system is already wired to it, you do not have to touch anything.
In the CSV and the WooCommerce file they are separate columns, and in the Shoptet file the availability text says it: only our own warehouse stock gives In stock, while supplier stock becomes At supplier.
Tailor the feed to your shop
You can add parameters to the link, and then the data arrives the way your shop needs it. No programming, no formulas in the import: extending the link is enough.
- Only the brands you list:
&marka=akyga,colorway - Only the categories you list, using the category keys from the feed:
&kategoria=usb-kabel - Only what is in stock, either with us or with our supplier:
&keszlet=van - Only what sits in our own warehouse, so it ships right away:
&keszlet=sajat - Your own selling price instead of your purchase price:
&ar=+25% - We round the price to the nearest hundred:
&kerekites=100 - We round the price to the usual form ending in ninety:
&kerekites=990
For the margin we add the percentage you gave to your net purchase price, add VAT, and write the finished gross price where your shop engine expects the selling price. Your purchase price stays in its own field, so your margin remains visible throughout. We always round up, so your margin never shrinks; to ten forints unless you ask for something else.
A full example that takes only the Akyga products in stock, with your own price and neat rounding:
&format=woo&marka=akyga&keszlet=van&ar=+25%&kerekites=990
If you mistype a parameter, the feed does not hand you an empty file — it tells you what is wrong. That way a bad price or a missing product cannot sit in your shop for days.
WooCommerce
- In your account copy the WooCommerce import (CSV) link.
- In your own shop: Products → Import → choose the URL instead of a file, or download the CSV and upload it.
- The columns follow WooCommerce's own importer schema (SKU, name, description, images, category, stock, price), so there is no field mapping to do. The Regular price is the recommended retail price, which you are free to overwrite; the net purchase price and the EUR price arrive in separate meta fields.
- To update, run the import again from the same link; it updates existing products by SKU.
Shoptet
- In your account copy the Shoptet import (XML) link.
- In your Shoptet admin: Products → Import → automatic import, with this URL as the source.
- The file follows the Shoptet supplier XML schema, so there is no field mapping to do. The VAT rate, the net and the gross selling price are each in their own element, so the import settings cannot get the price wrong. Your purchase price and the recommended selling price are also in separate elements, and you are free to overwrite the latter.
- Depending on your Shoptet plan you can refresh from once up to sixteen times a day. The full import runs at night, the stock and price only refresh runs during the day as well, and it takes the same link.
Shopify
- In your account copy the Shopify import (CSV) link.
- For a one-off upload, download the file, then in your Shopify admin: Products → Import.
- A scheduled refresh needs an app, because Shopify itself cannot import from a URL. Stock Sync and Products Import Wizard both accept this link, and the full XML as well, with their own field mapping.
- The columns follow Shopify's own schema. The Price column is the recommended retail price, Cost per item is your purchase price, so Shopify works out the margin on its own. The product is identified by the URL handle column. If a product has several images, the further images come in separate rows, which is the usual shape of a Shopify import.
Unas
- In your account copy the Unas-import (CSV) link and download the file.
- In the Unas admin: Products → Product database → Import, upload type: Delete nothing. The file follows Unas's own import schema, so there is no field mapping to do.
- Net price and Gross price are the recommended retail price, which you are free to overwrite. Your net purchase price is in the Adat 3 field.
- An Unas item number may only contain letters, digits, hyphens and underscores. Where our item number has a dot, a slash or a space, the file carries an underscore, and the original item number is in the Adat 1 field. When ordering, we accept either form.
- Images come in the Kép link field, and Unas transfers them on a schedule. This only works for new products; it does not replace an existing image.
- For a scheduled refresh, Unas customer support wires in the source; give them the Full data (XML) link for that.
ShopRenter
- In your account copy the ShopRenter-import (XML) link.
- In the ShopRenter admin: Settings → Import and export → External XML/CSV import, with this link as the source. The file uses ShopRenter's own machine field names, so the mapping is one to one.
- Schedule the refresh: on the Gold and Platinum plans you can choose anything from every ten minutes to weekly.
- The product identifier is the item number; updates match on it. The price is the recommended retail price, which you are free to overwrite or handle with a price multiplier.
- This file carries no images, because ShopRenter does not display external image links. Upload the images once from the image links in the Full data (XML) or from the Marketing materials package.
Octopus8 (e-procurement)
If you use the Octopus8 ERP, you do not need to upload a file at the supplier connection: Octopus pulls the five files from us. In the supplier connection settings, the file name to load should be the full URL, with the token in the path:
-
…/octopus/<token>/cikklista.xmlmaster data -
…/octopus/<token>/arlista.xmlprices at your price level -
…/octopus/<token>/keszletvalt.xmlavailable stock -
…/octopus/<token>/keszletenlevocikkek.xmlin-stock items only -
…/octopus/<token>/vonalkodok.xmlEAN codes
Load mode: Always full list. Items are identified by cikkid , which is permanent on our side, so no duplicates are created. Ask us for the exact links; we do not publish the prefix without a token here.
A cart from a single link
If you order from your own system or from a spreadsheet, you do not have to retype the item numbers. Build a link with the items on it, and your cart is ready and waiting on our side:
https://byb.hu/cart/betolt?tetelek=AK-EC-21:5,AK-USB-15:2
- Items are separated by a comma; between the item number and the quantity you can use a colon, an asterisk, an x or a space.
- Without a quantity, one piece goes into the cart.
- Anything we do not carry is left out, and the cart page tells you which item number it was. Every other item goes in.
- One link can carry up to 200 items.
- You see your own prices once you sign in, and the cart survives the sign-in.
The link does not place an order and does not reveal any data: it does exactly what typing the item numbers by hand would do. Placing the order stays in your hands.
Machine ordering from your own system
If your system can send an HTTP request, you can place the order with us without a human hand. For that we issue a separate ordering key, which is not the same as your price list link: that one only reads, this one orders.
POST https://feed.byb.hu/partner-rendeles?t=RENDELESI-KULCS
The body of the request is JSON, and this is all of it:
{"hivatkozas":"PO-2026-1234","tetelek":[{"kod":"AK-EC-21","db":5}]}
- The hivatkozas field is your own order number, so that both sides can refer to the same thing. It may be left out.
- You do not have to send a price, and we cannot accept one either: the items are priced on your own price level and your own individual prices, exactly as in the shop.
- Anything we do not carry is left out, and the response tells you which item number it was. Every other item goes into the order.
- One request can carry up to 200 items.
- The response tells you what went in, and the identifier of the daily batch (gyujto).
Items sent during the day go into one daily batch, and at the cut-off time that batch becomes one order. You may send any number of requests in a day; on our side it becomes one order, one pick and one invoice. A request arriving after the cut-off goes into the next day's batch. You receive our order number at the cut-off: query it on the status endpoint with the gyujto parameter, or read it in the confirmation e-mail. Stock is not reserved until the cut-off; if at the cut-off there is not enough free stock for an item, a colleague sorts it out by hand and gets in touch.
If your system needs the order number at the moment of sending, ask us and we switch your key: then every request immediately becomes a separate order.
The order stops with us as a draft, just like an order placed on the portal: we confirm it, we align it with the incoming stock, and only then does it become final. There is no card payment on this route; we send the invoice in the usual way.
A trial run without an order
POST https://feed.byb.hu/partner-rendeles/proba?t=RENDELESI-KULCS
The same body, but no order is created: the response tells you which item numbers we recognise, the unit price on your price level, whether there is free stock, and the net total of the items. It is meant for testing your integration and can be called as often as you like.
Order status
GET https://feed.byb.hu/partner-rendeles/allapot?t=RENDELESI-KULCS
Your company's last fifty orders with their status: draft, confirmed, paid, shipped. Narrow it to one order with the rendeles parameter, or to one daily batch with the gyujto parameter. No other company's orders can be reached this way.
Ask us for the ordering key. If you need help wiring it up, write to us and we will do it together with you.
Marketing materials
On the Marketing materials card in your account there is a downloadable package per brand: logo, product list with photo links and descriptions. The images themselves also come with the full feed, in full resolution.
If you get stuck
Write to us at info@byb.hu , telling us which system you are connecting and where you got stuck, and we will help with the field mapping too.