Connect Base.com (formerly BaseLinker)
Run your YNS orders, stock, prices and products from Base.com. Set up the connection, switch on each sync in Base, and see exactly what moves in which direction.
Base.com, known until recently as BaseLinker, is where many Polish merchants run orders from every channel – Allegro, Amazon, their own store – and print courier labels in one place. Connect your YNS store to Base and your store's orders show up there next to everything else, while the work you do in Base (shipping an order, changing stock, adjusting a price, adding a product) flows back to your store.
What the integration does
Everything below works in both directions, but each part has its own switch in Base. Nothing syncs until you turn it on – see Turn on the sync in Base.
| What | Direction | Turned on in Base under |
|---|---|---|
| Your store's orders, with the address, parcel locker, items and the prices actually paid after discounts | YNS → Base | Zamówienia (Orders) |
| Order status: processing, shipped, completed, cancelled | Base → YNS | Statusy (Statuses) |
| Payment received | Base → YNS | Płatności (Payments) |
| Tracking numbers | Base → YNS | Wysyłki (Shipping) |
| Stock | Base → YNS, or YNS → Base | Stany (Stock) |
| Prices | Base → YNS, or YNS → Base | Ceny (Prices) |
| Orders Base took on Allegro, Amazon and its other channels | Base → YNS | Zamówienia (Orders) |
| New products and categories, and later edits to them | Base → YNS | Produkty (Products) |
Base reads your catalog at any time without a switch: products, variants, photos, descriptions, categories, brands and features.
Before you start
- A Base.com account. Your subscription and any channel fees live with Base.
- Decide where you manage stock and prices. Both systems can change them, so pick one place to edit them day to day and let the other follow. Most merchants who sell on Allegro through Base let Base lead.
- Match the currency. Base sends prices without a currency. Make sure the price group Base syncs from (in Base under Produkty → Ustawienia) uses your store's currency, or a price of 100 USD lands in your store as 100 PLN.
- Allegro in one place only. If Base already manages your Allegro account, don't also connect the Allegro add-on to the same account – each Allegro sale would arrive twice and lower your stock twice.
- Let one system take the stock for other channels' orders. When Base sends you an order, it says whether your store should lower stock. If Base already keeps your YNS stock in sync, set it so the order doesn't, or a sale counts twice.
Connect your store
Do the steps in this order. Base checks the address the moment you save the shop, so YNS must already know the password.
- In YNS, open Add-ons and choose Base.com (formerly BaseLinker). Keep the page open – you'll need the integration file address shown there.
- In Base, go to Integracje (Integrations) → Dodaj integrację (Add integration), search for Inny sklep (Other shop) and open it. Leave the form open.
- The form shows a Hasło komunikacji (communication password). Click Kopiuj do schowka to copy it.
- Back in YNS, paste it into Communication password (bl_pass) and click Connect Base.
- Back in Base, type a name for the shop (up to 15 characters) in Nazwa wyświetlana, paste the integration file address from YNS into Plik wymiany danych, and click Zapisz.
Base confirms the shop straight away. Within a few minutes the add-on page in YNS shows Last request from Base with a time. To check the connection at any point, open the shop in Base and click Przetestuj połączenie (Test connection).
Note: Base's form asks you to unpack a
baselinker.phpfile and upload it to your server. Skip that part: YNS hosts the integration file for you, and the address you copied is where it lives.
Saw "invalid_password"? Base saved before YNS knew the password. Paste the password from Base into YNS, click Connect Base, then save the shop in Base again.
Turn on the sync in Base
Open Integracje in Base, find your shop in the list and click its settings icon. Each tab below switches on one part of the integration; click Zapisz on every tab you change.
Orders from your store
On Zamówienia (Orders), set Pobieraj zamówienia to Tak, pobieraj co 1 minutę (every minute) or every 10 minutes. Pobieranie zamówień – status is the Base status new orders start in.
To send the orders Base takes on its other channels into YNS, set Dodawanie zam. do sklepu (Add orders to the store) to Tak. The options below it add the buyer's marketplace login and the offer numbers to the buyer's comment, which shows on the order in YNS as Note from customer. Your own notes from Base arrive as the order's internal note, kept apart from the buyer's. In the other direction, a note a shopper writes in your checkout reaches Base as the buyer's comment.
Order statuses
On Statusy (Statuses), set Powiązanie statusów (Link statuses) to Tak. Then map each Base status to a store status: for example Do wysłania to Processing, Wysłane to Shipped and Anulowane to Cancelled. Leave Nowe zamówienia (New orders) on Nie przekazuj – a store order is already paid or awaiting payment, and Base can't set either.
Your own order statuses are in the list too, sub-statuses as Group › Sub-status. Base can move orders into those with no linked order status, or linked to Processing, Shipped, Completed or Cancelled; a linked one changes the order status as well. Orders you download into Base carry their custom status, and orders in a default status keep the plain order status, so mappings you made before keep working.
Payments
On Płatności (Payments), set Przekazywanie statusów płatności to Tak. Base tells your store an order is paid once the payments it records cover the whole order total. The two defaults below decide which payment method the orders Base sends you get: map prepaid orders to Paid outside YNS and cash on delivery to Cash on delivery.
Orders your store sends to Base carry one of these payment methods in Sposób płatności. They're in your store's language: Polish when the store language is Polish, English otherwise. The names don't change, so an accounting integration can map each one; a new payment provider is added to this list.
| English | Polish | What the shopper or you used |
|---|---|---|
| Card / online payment (Stripe) | Płatność online (Stripe) | Card, BLIK, Apple Pay, Google Pay or another method at Stripe checkout |
| Montonio | Montonio | Montonio |
| Frame | Frame | Frame |
| InPost Pay | InPost Pay | InPost Pay |
| Paynow | Paynow | Paynow |
| PayPal | PayPal | PayPal |
| Bank transfer | Przelew tradycyjny | Bank transfer to your account |
| Cash on delivery | Za pobraniem | Cash on delivery |
| Invoice / payment terms | Faktura / odroczony termin | An order you created (draft or wholesale), paid against an invoice |
| Paid outside YNS (in store or on a marketplace) | Opłacone poza sklepem | Paid outside the store, such as at a counter sale or on a marketplace |
| InPost Buy | InPost Buy | An InPost Buy marketplace order |
| TikTok Shop | TikTok Shop | A TikTok Shop order |
Changing your store language changes the names on orders Base downloads from then on, so update your accounting mapping if you do.
Tracking numbers
On Wysyłki (Shipping), set Wysyłaj numery nadania to Tak, przekazuj automatycznie od razu po utworzeniu przesyłki, so the tracking number reaches your store the moment Base creates the parcel. Domyślny sposób wysyłki picks the delivery method for orders Base sends you.
Stock
On Stany (Stock), pick Synchronizacja z Base.com do sklepu if Base leads your stock, or ze sklepu do Base.com if your store does. Choose how often: every 5 minutes keeps marketplace offers closest to reality. Base syncs only products linked between its catalog and your store.
Prices
On Ceny (Prices), choose the direction and frequency the same way. Base sends gross prices; YNS works out the net price from the product's VAT rate. Check the currency of your price group first – see Before you start.
Products
On Produkty (Products), set Eksportuj produkty do sklepu (Export products to the store) to Tak if you want Base's catalog to be where you create products. Base then creates them in YNS when you export them – see Create and update products from Base. Eksporty cykliczne can repeat an export on a schedule.
Fill your own extra fields in Base
Base lets you add your own fields to orders under Zamówienia → Ustawienia → Pola dodatkowe (Orders → Settings → Extra fields), for example a Kupon field for the coupon code. YNS can fill two of them on every order it sends:
| In YNS | What goes into the Base field |
|---|---|
| Coupon code | The coupon code the buyer used, for example SUMMER10 |
| Traffic source | The UTM source of the visit that led to the order, for example newsletter, or the referring website when the link had no UTM tags |
- In Base, open Pola dodatkowe and note the ID of the field, for example
extra_field_74808. - In YNS, open Add-ons → Base.com (formerly BaseLinker). Under Extra fields in Base, paste the ID next to the data it should hold. Leave a row empty to skip it.
- Click Save.
Orders Base downloads from then on carry the values. Base reads an order once, when it first downloads it, so orders already in Base keep their fields as they are. When Base issues an invoice, it copies the extra fields onto it.
- Empty when there's nothing to send. An order without a coupon leaves the field empty. The traffic source is empty for orders placed without a tracked visit, such as a direct visit or an order you created in the admin.
- Up to 200 characters. Base stores no more than that, so a longer value is cut.
Send orders from Base to your store
With Dodawanie zam. do sklepu on, Base sends the orders it takes on Allegro, Amazon and its other channels to YNS by itself. An order you type into Base yourself goes over when you open it and click Przekaż zamówienie do sklepu (Send the order to the store) next to Numer w sklepie.
The order appears in YNS Orders with a Base badge naming the channel:
- Totals match what the buyer paid. Items from your catalog are matched by product, variant or SKU; anything else becomes a custom item at the paid price.
- The buyer's parcel locker comes along, so InPost labels you print in YNS find it.
- YNS sends the buyer nothing. The marketplace already confirmed the order and keeps the buyer posted, so status changes, tracking numbers and payments on these orders never trigger a YNS email, and YNS files no KSeF e-invoice for them – the marketplace or Base invoices the sale.
- Edit these orders in Base. YNS shows them but won't edit them, so the two copies don't drift apart.
Create and update products from Base
In Base, open Produkty → Lista produktów, tick the products, open the menu above the list and choose Utwórz/edytuj produkty w sklepie internetowym (Create/edit products in the store). Pick your shop under Eksportuj do and click Wykonaj.
- New products are created published, with their photos, description, price, stock, weight and dimensions. Base's features become custom fields on the product.
- Exporting again updates the same product – Base remembers the link. Tick Nie dodawaj zdjęć przy aktualizacji produktu to keep the photos you already have in YNS.
- Categories. Choose Utwórz kategorię to create the category in YNS. Tick the option to split names on
/and a category likeJewellery/Ringsbecomes a tree. - VAT. Tick Użyj stawki przypisanej do produktu to use the product's rate from Base. If your store has no rate at that percentage yet, YNS creates it (for example "VAT 8%"), so the product is never sold without VAT.
- Manufacturer. Base's manufacturer becomes the product's brand in YNS, created if you don't have it yet.
Good to know
- Products with variants. A product with a single variant appears in Base as a simple product. A product with several variants (sizes, colours) appears with each variant listed, each with its own stock and price.
- Bundles and sets aren't sent. Base manages stock per product, and a bundle has no stock of its own.
- Products without stock tracking are reported to Base with a stock of 999, so the offers Base publishes from them stay active. Base can't turn tracking on by accident: when it sends that 999 back, the product stays untracked.
- Order numbers match. Base keeps your YNS order number as the shop's order number, next to its own ID.
- Which orders Base sees. Base sees the orders of the mode your store is in – live orders once you've launched, test orders while you're still in test mode.
- Emails to your own customers. Status changes and tracking numbers Base sends for your store's orders trigger the same customer emails as if you'd made the change in YNS.
- Warehouse owns its stock. If you use Warehouse, stock comes from your deliveries and counts, so Base can't overwrite it. When Base tries, YNS lists it once a day under Issues.
FAQ
How do I see only the orders that came through Base?
In Orders, pick Base.com (BaseLinker) in the Channel filter. The same filter on Analytics shows revenue and orders for one channel at a time, so you can compare your online store with the sales Base brings in.
Base doesn't show any orders from my store. Why?
Order download is off until you switch it on: open your shop in Base, go to Zamówienia and set Pobieraj zamówienia to every minute or every 10 minutes. Base then fetches orders from the last few hours on each check.
What happens to an item Base sells that isn't in my YNS catalog?
It's added to the order as a custom item at the price the buyer paid, so the order total is right. It doesn't affect your YNS stock.
Does cancelling an order in Base refund the customer?
No. Cancelling in Base cancels the order in YNS and puts the items back in stock, but money only moves through your payment provider. Issue the refund in YNS – see Issue refunds and handle returns.
Can Base mark an order as refunded or change a paid order back to unpaid?
No. Base can move an order through processing, shipped, completed and cancelled, and it can mark an unpaid order as paid. Refunds and reservations stay in YNS, where the money and the stock are handled together.
I marked an order as paid in Base, but it's still unpaid in YNS.
Base passes a payment on only when the amount recorded in Base covers the whole order total, delivery included. Check the payment amount on the order in Base, and that Przekazywanie statusów płatności is on.
My customers got a shipping email without a tracking link. Why?
Base sends the tracking number and the status change separately. When the tracking number arrives first, the "shipped" email includes it. Set Wysyłaj numery nadania to send numbers as soon as the parcel is created, and have your Base automation create the parcel before it changes the status.
How do I disconnect?
Open the add-on in YNS and click Disconnect Base. Base stops receiving data straight away. Remove the shop in Base too, so it stops trying to connect.
What's next
- Keep stock accurate across channels with Manage inventory.
- See how orders move from paid to delivered in Fulfill and ship an order.
- Browse other connections in Browse and connect add-ons.