Settings
Open Add-ons > Manage add-ons > Hepsiburada Marketplace Connector > Settings for the general settings, and Orders > Hepsiburada 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 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 claims imported and shipments reported. |
| Status of imported orders | O (Open) | Status of a new Hepsiburada 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 a secret field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test uses the test credentials and the -sit hosts; Live uses the live credentials and the production hosts. |
| API user / API password | Sent as HTTP Basic authentication. From the Hepsiburada merchant panel (integration settings). |
| Merchant ID | The GUID of your merchant account, part of every API path. |
| Integrator name | Sent as the User-Agent of every call, letters and digits, up to 30 characters. Use the name Hepsiburada registered for your integration: calls with another name are refused. |
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 | Hepsiburada amount (TRY) per 1 unit of the store’s primary currency. 1 = use the TRY rate of the store’s currency table when it exists, else prices go unchanged. Hepsiburada has one price: the strike-through list price is not sent. |
| Stock | Stock buffer, show zero at or below, maximum | Hepsiburada sees stock minus the buffer; 0 at or below the minimum. |
| New listings | Create products automatically | Mapped products that are not on Hepsiburada yet are sent by the sync. |
| New listings | Default brand name, brand feature, VAT rate, default weight | Defaults for the data Hepsiburada requires. The brand is sent as a name: type it exactly as it appears at Hepsiburada. |
| Orders | Customers | Guest orders, or attach to the customer account with the same e-mail. |
| Orders | Status mapping | CS-Cart status for each Hepsiburada status (Created, Picking, Shipped, Delivered, Not delivered, Cancelled, Returned). Empty = leave unchanged. |
| Shipping | Report Picking / Invoiced | Packs the order lines at Hepsiburada (the package is needed for everything after) and sends an invoice link (prefix + year + order number as the invoice number). |
| Shipping | I ship with my own carrier | Sends the tracking number (and a link built from the template, {tracking} is replaced) and the package moves to Shipped. Only packages of your own carrier accept this; HepsiJet and similar packages are handled by Hepsiburada. |
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_hepsiburada.cronhttps://your-store.example/index.php?dispatch=kv_hepsiburada.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call, job and per-product result with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again. A rate limit answer (429) is retried the same way.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own merchant account.