=== Hepsiburada & n11 Connector for WooCommerce ===
Contributors: catcodestudio
Tags: hepsiburada, n11, marketplace, turkey, pazaryeri
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sell your WooCommerce products on Hepsiburada and n11: link your listings and keep prices and stock in sync on both marketplaces.

== Description ==

You sell in your own WooCommerce shop and on Hepsiburada and n11. Every price change and every sale has to be repeated in two seller panels — or a product oversells. This plugin connects WooCommerce to both marketplaces through their official APIs.

= Free =

* Hepsiburada: merchant id, API user name and password (service key), the integrator name for the User-Agent header, live or test (SIT) environment. n11: API key and secret. Passwords and keys are stored encrypted.
* Import of the listings of both stores, linked to WooCommerce products and variations by SKU (Hepsiburada merchant SKU, n11 stock code) or GTIN/EAN. A report shows the listings without a product in the shop.
* Price and stock sync of the linked products, a few minutes after a change and on demand. Only changed data is sent; the result for every product is read back from the marketplace and shown on the product (Hepsiburada: errors and price locks per SKU; n11: the task result per stock code).
* Price rules per marketplace: markup in % and a fixed add-on, rounding (,90 / ,99 / whole lira); shared: WooCommerce prices with or without KDV, a conversion rate for another shop currency. n11: the regular price as the crossed-out list price during a sale.
* Stock reserve per marketplace, a quantity for products without stock management; a product that is unpublished, deleted or switched off gets zero stock.
* The marketplace status of every linked product: on sale, locked or suspended (with the reason), n11 approval status, price and stock there.
* API log for 30 days; passwords and keys are never logged.

= Pro =

* Hepsiburada orders in WooCommerce every 5 minutes: buyer, delivery and invoice address, corporate invoice data, products with KDV, the cargo company, the shipping deadline. The stock goes down here.
* n11 orders in WooCommerce every 5 minutes: one n11 package = one order, with the amount to invoice per line, n11 and store discounts, pick-up point and e-export orders marked.
* Cancellations on the marketplaces cancel the order here and restore the stock (also for single cancelled lines); deliveries can complete the order.
* Hepsiburada: pack the order from the order screen or by order status (package number and cargo barcode), undo a package, download the common cargo label (PDF, ZPL or PNG), send the invoice link, cancel open lines with a reason.
* n11: approve the order (Picking) from the order screen, by order status or right after the import, send the invoice link (with number and date for e-export orders), cancel the lines of an approved order with a reason.

Pro can be tried for 7 days for free, no card needed. One key works on two sites: the shop and its test copy.

= Languages =

English and Turkish.

== Frequently Asked Questions ==

= Where do I get the Hepsiburada credentials? =

Hepsiburada gives the merchant id, the API user name and password after the integration request (test environment first, the live credentials through a ticket in the merchant panel: Yardım Merkezi → Talepler → API Entegrasyon). If you work through an integrator, the service key is in Bilgilerim → Entegrasyon → Entegratör Bilgileri.

= Where do I get the n11 API key? =

In the n11 seller panel: Hesabım → API Hesapları.

= Can the plugin create new products on the marketplaces? =

No. New products are created in the seller panels (catalogue approval is done by the marketplaces); the plugin links them to WooCommerce products and keeps price and stock up to date.

= Does the plugin receive orders instantly? =

Orders are read every 5 minutes. Hepsiburada's order webhook is set up by Hepsiburada for each integration and n11 has none, so the plugin asks the marketplaces itself.

== Changelog ==

= 1.0.0 =
* First release: Hepsiburada and n11 listing import, price and stock sync with results per product; Pro: orders from both marketplaces, packing, approval, cancellation, invoice links and cargo labels; Turkish translation.
* Updates of the Pro version come from catcode.com.ua and show up in Dashboard → Updates while the licence covers updates.
