Settings
Open Add-ons > Manage add-ons > Allegro Marketplace Connector > Settings for the general settings, and Orders > Allegro channel for the working pages (Listings, Categories, Attributes, Rules, Orders, Returns, Connection, Log, Jobs).
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Secrets and tokens are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often products are synchronized, orders and returns imported and shipments reported. |
| Status of imported orders | O (Open) | Status of a new Allegro order in CS-Cart (the “Created” row of the status mapping). |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave the secret field empty to keep the saved value. Saving other fields keeps the Allegro authorization; a new client ID or secret removes it and you connect again.
| Field | Description |
|---|---|
| Mode | Test uses the sandbox hosts and the sandbox application; Live uses allegro.pl and the live application. |
| Client ID / Client secret | Of your own Allegro application (one per mode). |
| Marketplace | allegro-pl (PLN), allegro-cz (CZK), allegro-sk (EUR) or allegro-hu (HUF). Sets the currency of prices and the offer language. |
| Delivery price list ID | From your Allegro sales settings. Every offer created by the add-on uses it. |
| Return policy ID, Implied warranty ID, Warranty ID | From your Allegro after-sales settings (the warranty is optional). |
| City, Post code, Province | The seller location of new offers. |
| Invoice type | VAT, VAT_MARGIN, WITHOUT_VAT or NO_INVOICE, as accepted for your account. |
| New offers | Publish at once or save as inactive and publish in Allegro. |
The access token lives 12 hours and is refreshed automatically; the refresh token lives three months, is replaced at every refresh and stays valid as long as the cron runs. If Allegro revokes the authorization, the Connection page asks you to connect again.
Rules page
Section titled “Rules page”| Group | Setting | Description |
|---|---|---|
| Prices | Markup %, fixed amount | Added to the CS-Cart price. A category mapping overrides it for its products, a product markup (Listings page) overrides both. |
| Prices | Price endings | Keep, whole numbers, always x.99 or x.90. |
| Prices | Exchange rate | Amount in the marketplace currency per 1 unit of the store’s primary currency. 1 = use the rate of the CS-Cart currency with the same code when it exists, else prices go unchanged. Allegro has one price: the strike-through list price is not sent. |
| Stock | Stock buffer, show zero at or below, maximum | Allegro sees stock minus the buffer; 0 at or below the minimum. |
| New listings | Create offers automatically | Mapped products that are not on Allegro yet are sent by the sync. |
| New listings | Default brand name, brand feature, VAT rate, default weight, handling days | Defaults for the data Allegro requires. The brand is sent as a value of the category parameter named Marka / Brand when the category has one. |
| Orders | Customers | Guest orders, or attach to the customer account with the same e-mail. |
| Orders | Status mapping | CS-Cart status for each Allegro status (Created, Picking, Shipped, Delivered, Cancelled, Returned). Empty = leave unchanged. |
| Shipping | Report Picking | Sets the Allegro order to Processing when the shipment step starts. Allegro has no invoice status, so the invoice step sends nothing. |
| Shipping | I ship with my own carrier | Adds the tracking number to the order lines at Allegro (carrier from the Allegro carrier list, otherwise OTHER with the carrier name) and sets the order to Sent. |
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_allegro.cronor call index.php?dispatch=kv_allegro.cron&key=<your key> every minute.