↑↓ selectEnter openEsc close

    1. Elbuz
    2. European marketplaces

    How to receive ceneo.pl (Kup Teraz) orders in Elbuz

    15 min readUpdated

    Elbuz picks up paid orders from the “Kup Teraz” service of the Polish price comparison site ceneo.pl and queues them with your other channels: same warehouse, same customer base, same managers.

    When you need this:

    • Shoppers check out directly on Ceneo — each order becomes a “Customer order” document with the “Paid” status.
    • Your Ceneo feed is generated by Elbuz — order lines find your cards right away by the ID from the feed.
    • Your manager takes the order from there — repeat runs skip an imported document.

    Where to start: get an access key in your Ceneo account and paste it into a template of the “ceneo.pl” type.

    What the Ceneo connection does

    Ceneo brings only orders into Elbuz. Products travel the other way: you send them to the marketplace as a feed from the data export section.

    What you need from Ceneo

    You need one access key: it is issued in your store account, in the “Kup Teraz” service settings, and goes into the “Token” field of the “Connection” card. The other fields of this card are left empty for Ceneo.

    On every run Elbuz presents the key, gets temporary access and uses it to pick up orders. There is nothing to store or renew; Elbuz trims spaces at the start and end of the key by itself.

    The marketplace's documentation for partners: Ceneo Developers.

    How to connect, step by step

    1. Create a template of the “ceneo.pl” type and paste the key into the “Token” field. There is no “Orders” checkbox here: this type imports orders only.
    2. Save the template and run it manually — the log shows whether the key was accepted and how many orders were found.
    3. Open a few documents and check the lines, totals, customer and address against your Ceneo account.
    4. Lines landed on your cards — put the template on a schedule. They arrived as new cards — fix the feed first (line matching).

    What comes with an order

    Ceneo returns an order in parts — the list first, then the lines and delivery details for each order. Elbuz assembles them into one document:

    Ceneo dataDocument field in Elbuz
    order number shown to the customerDocument number
    internal order IDExternal key (used to recognize the order on later runs)
    creation dateOrder date
    order total and delivery costDocument total, delivery price
    customer's email and phoneEmail, phone
    first name, last name, company nameRecipient details
    address, postal code, city, region, countryDelivery address
    delivery methodDelivery type
    payment methodPayment type (table below)
    customer's commentOrder description
    lines: name, price, quantity, totalDocument lines

    Elbuz picks up “Kup Teraz” orders whose payment has already been confirmed. So the payment status is “Paid” right away, and only orders with the money already received get into processing.

    Payment and delivery types

    Payment in CeneoPayment type in Elbuz
    fast transferOnline payment
    payment on receiptCash on delivery
    credit cardBank card
    transfer directly to the store's accountBank transfer
    installments, split paymentBank card — by the fallback rule for all unrecognized payments

    You cannot change this mapping with a rule: the “Related settings” card of a Ceneo template has only “Schedule setup”, with no buttons for mapping statuses and payment types, and rules from other templates do not apply to Ceneo. Fix the payment type in the document itself, in the “Payment” section — repeat runs will not overwrite this edit.

    Courier delivery and InPost (Polish parcel lockers) are recognized by name and go to the matching delivery services. All other Ceneo delivery methods come in as “Pickup”.

    How order lines find your cards

    For each line Ceneo sends the product ID from your feed and the name, without an SKU. If your Ceneo feed is generated by Elbuz, the line finds its card right away. If nothing matches the ID, it searches by name.

    Before connecting orders, make sure your Ceneo feed sends stable product IDs and is generated from the same catalog. Then order lines will not create half-empty cards in a service category.

    A new card appears only on the bottom branch, when a line finds no card either by the feed ID or by name.
    yesnoyesnoyesnonoyesCeneo order lineDoes the feed ID matchthe card UUID?Document line linked to the cardIs there a card with the same name?Does the feed ID matchthe card code in Elbuz?Does the service category“Products - ceneo - template name”exist?The category is created disabledand excluded from exportsThe category is againexcluded from exportsNew card in the service categorywith price and quantity from the line,one per distinct name
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    Service category: what to do with it

    A line without a card creates a new one in the service category “Products - ceneo - ‹your template name›” at the top level of the tree. The category is created disabled and excluded from exports; if you later allow export, subsequent runs will not reset it.

    • The new card's price comes from the order line, and its stock is the quantity from that line.
    • Different names get a card each; identical names in one run share a single card.
    • You can move the cards to your own categories: the document line keeps its link to the card and keeps its own name, price and quantity.
    • A deleted or renamed category comes back: Elbuz looks for it by exact name at the top level.

    Before deleting the category, move the cards out of it: service categories and brands.

    What happens to an order after import

    Each order arrives as an unposted “Customer order” document with the “Paid” status and the “Paid” payment status. Import does not create an incoming payment document: “Paid” is just a mark on the order itself.

    Import does not change stock in cards or warehouses. The only thing it recalculates for existing products is the sales count. A reservation appears only after you post the order with inventory tracking turned on.

    A posted Ceneo order keeps the goods reserved until you move it to a final status or post a sales invoice based on it. Details: reservation and available stock, shipment.

    An order that is already in Elbuz is skipped on a repeat import: there is no duplicate, but changes from the marketplace do not come through either. Your manager handles the document; what happened to the order on Ceneo after import is visible in your marketplace account.

    Scheduled updates

    Elbuz contacts Ceneo on the schedule set with the “Schedule setup” button in the “Related settings” card. Orders arrive paid and are waiting to be shipped, so check several times an hour. To turn the template off for a while: disable a template.

    Each run requests orders created since the previous import, going back an extra twelve hours to cover clock differences and marketplace delays.

    How many orders per run

    Elbuz requests the list in pages, newest first, but no more than 5,000 orders per run; each new order takes two more requests — lines and delivery. After the run, the starting point moves to the date of the newest order.

    Orders that did not fit into a run and were created more than twelve hours before the newest one will not be requested by the next run. You can pick them up with a date in the “Advanced” section (scenario).

    A Ceneo run checks the “Stop” button only once, at the start; once data exchange has begun, the run goes on to the end.

    The top two notes show where a run ends before reaching any orders. Further on, in the loop for lines and delivery, Elbuz goes only through orders that are not in the database yet.
    CeneoElbuzThe “Token” field is empty or Stop was pressed — the run ends before contacting CeneoAccess denied — error in the log, the run endsA document with this ID already exists — the order is skippedloop[Each order on the page]loop[List pages, while orders keep coming, no more than 5,000 per run]The very first page is empty or the connection failed — the run ends without writing anythingIf there are new orders — documents and customers are saved, the starting point moves to the newest oneKey from the “Token” fieldTemporary accessNext page of orders from the date minus 12 hours, newest firstResponse pageOrder linesDelivery details
    • Request or action
    • Reply
    • loop — repeats
    • Note

    Scenarios

    Receive paid “Kup Teraz” orders along with your other channels

    What to turn on. A template of the “ceneo.pl” type, the key in the “Token” field, a schedule via the “Schedule setup” button, and the badge in the form header set to “Active”.

    What you get. New orders arrive as “Customer order” documents with the “Paid” status. An order that is already imported is neither updated nor duplicated (after import).

    Make lines land on your cards instead of new ones

    What to turn on. A Ceneo feed generated by Elbuz that sends the card ID from your catalog as the product ID.

    What you get. A line finds its card by this ID, or else by name. If it finds nothing either way, Elbuz creates a new card in the service category.

    Pick up orders for an earlier period

    What to turn on. In the “Advanced” section of the template form, enter a date in the “Import orders from date (YYYY-MM-DD)” field and run the template manually.

    What you get. Elbuz requests orders from that date minus twelve hours and creates documents for those not yet in Elbuz. After the run, the field gets the date of the newest order. If the period has more than 5,000 orders, this run will not pick up the oldest ones.

    Expanded Advanced block with the order start date field
    1Import orders from date (YYYY-MM-DD)
    1. Import orders from date (YYYY-MM-DD) — the date from which (minus twelve hours) Elbuz requests orders.

    Temporarily stop receiving Ceneo orders

    What to turn on. Click the status badge in the form header so that it shows “Disabled”.

    What you get. The template is skipped by the schedule, but a manual run still works. Once you turn it back on, import resumes from the date of the last order minus twelve hours, with the same 5,000 cap.

    What to do when Ceneo orders do not arrive

    Common problems
    What you seeWhyWhat to do
    “API token not specified” The “Token” field is empty Paste the key from your Ceneo account (what you need)
    “API authorization error. Check the site address, login and password.” The key was copied incompletely or has been revoked; the Ceneo form has no address, login or password. It also happens when the marketplace did not respond Copy the key again; if it is definitely correct, run the template later
    No orders, even though your account shows them These are click-throughs from price comparison to your store, not “Kup Teraz” orders — the does not have them Such sales come from your own website
    Lines create new cards The IDs in the feed do not match the catalog cards Fix the feed, not the import (line matching)
    Order changes on Ceneo do not come through An imported order is skipped so as not to overwrite your manager's work Check changes against your Ceneo account (after import)
    The wrong data was imported Everything created is marked with the template name Filter documents, cards and new contacts by “Source: name” and delete them; unpost posted ones first (how to remove)

    How to remove imported data

    • Orders. In the document list, filter rows by “Source: name” and delete them in bulk. Bulk delete skips posted ones: “Posted documents were not deleted (N). Cancel the posting first.” Deleted documents stay in the “Document trash” for 30 days.
    • Cards. They are in the service category, with the template name in the “Source: name” column.
    • Customers. New contacts have the template name in the “Source: name” column; existing ones matched by email or phone do not get this mark.

    The marketplace will return a deleted order again, but only within the date the import starts from; an earlier period is picked up with a date in “Advanced”. General procedure: if the wrong data was imported.

    FAQ

    Can I import products from Ceneo?

    No. You send products to Ceneo as a feed, and orders come back from there (line matching).

    Why are all orders marked as paid?

    “Kup Teraz” returns orders with confirmed payment, so the payment status is “Paid” right away (what comes with an order).

    Which payment type do installments and split payments get?

    “Bank card”, by the fallback rule. Set the right payment type in the document, in the “Payment” section (payment types).

    Why did the delivery come in as “Pickup”?

    Elbuz recognizes only courier delivery and InPost; all other Ceneo methods come in as “Pickup” (delivery types).

    The order arrived — why didn't the stock change?

    Import does not touch stock. A reservation appears after the order is posted (after import).

    Where it is and who has access

    Menu
    Directories → Operations → Data import → new template of the “ceneo.pl” type
    Access right
    the “Import” window in “Group permissions”
    Have ready
    an access key from your store account on Ceneo; a product feed on Ceneo
    Connection card of the ceneo.pl import setup window
    1Token field
    1. Token field — the access key from your Ceneo 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