=== Epicentr Price & Stock Sync for WooCommerce ===
Contributors: catcodestudio
Tags: woocommerce, epicentr, marketplace, price, stock
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Ціни й наявність товарів WooCommerce оновлюються в кабінеті Епіцентр Маркетплейс через офіційне API, а нові товари заходять туди XML-файлом з характеристиками з довідника Епіцентру.

== Description ==

Продавець, який торгує і на власному сайті, і на Епіцентр Маркетплейс, щоразу змінює ціну чи залишок двічі: у WooCommerce і в кабінеті продавця. Модуль прибирає другий крок — бере ціну й наявність із товарів WooCommerce і надсилає їх в Епіцентр через офіційне API оновлення цін і наявності.

= Що вміє =

* Оновлення ціни, старої (перекресленої) ціни й наявності в кабінеті Епіцентру
* Товар знаходиться за артикулом: SKU на сайті = «Артикул» у кабінеті; або за ID товару Епіцентру з окремого поля
* Варіації йдуть окремими товарами, кожна зі своїм артикулом
* Надсилається лише змінене: той самий набір значень удруге не йде
* Пакети до 1000 товарів і дотримання ліміту Епіцентру (120 запитів за 2 хвилини)
* Статус кожного товару: у черзі, оновлено, без змін, відхилено, не знайдено в кабінеті — з поясненням людською мовою
* Список товарів, які не оновились, і журнал пакетів
* Поріг залишку і вибір, як показувати передзамовлення
* Статус синхронізації прямо в картці товару
* Сумісність з HPOS

= Нові товари з характеристиками =

* Довідник Епіцентру прямо в адмінці: категорії, набори характеристик і значення списків тягнуться через API
* Звʼязка категорії магазину з категорією Епіцентру з пошуком за назвою; батьківська категорія покриває підкатегорії
* Для кожної характеристики — звідки брати значення: атрибут, бренд, GTIN, вага й габарити (переводяться в грами й міліметри), мета-поле або однакове значення
* Значення списків підставляються за назвою, а незбіги («Рінгель» → «Ringel») зіставляються вручну
* XML-файл у форматі імпорту Епіцентру: ціни й наявність за тими ж правилами, що й API, варіації окремими товарами
* Звіт: які товари не потрапили у файл і якої обовʼязкової характеристики їм бракує

= Pro =

* Автоматичне оновлення: змінили ціну чи залишок у WooCommerce (вручну, імпортом чи замовленням) — за кілька хвилин це вже в Епіцентрі
* Націнка для Епіцентру (множник ціни) й округлення до гривні
* Виключення категорій із синхронізації
* Файл товарів для будь-якої кількості категорій (без Pro — одна)
* Файл товарів сам перезбирається щодоби

Pro можна спробувати 7 днів безкоштовно, без картки.

== Installation ==

1. Завантажте архів у «Плагіни → Додати новий → Завантажити плагін».
2. Активуйте плагін.
3. WooCommerce → «Епіцентр: ціни й наявність» — вставте токен API і натисніть «Перевірити звʼязок».
4. Натисніть «Надіслати зміни зараз».

== Frequently Asked Questions ==

= Де взяти токен? =

У кабінеті продавця Епіцентру: «Налаштування компанії» → вкладка «API». Якщо вкладки немає, доступ відкриває категорійний менеджер.

= Чи можна перевірити модуль без кабінету продавця? =

Ні. Пісочниці в Епіцентру немає — API відкривається лише токеном живого кабінету.

= Як модуль знаходить товар в Епіцентрі? =

За артикулом: значення SKU на сайті має повністю збігатися з полем «Артикул» у кабінеті. Якщо артикули різні, увімкніть пошук за ID — у картці товару й кожної варіації зʼявиться поле «ID товару в Епіцентрі».

= Чому ціна в кабінеті змінилась не одразу? =

Епіцентр обробляє зміни асинхронно: спершу приймає пакет у чергу, потім застосовує. Статус «у черзі» змінюється на «оновлено» за кілька хвилин — кнопка «Оновити статуси з Епіцентру» підтягує результат, а з Pro модуль робить це сам.

= Чому ціна одного товару не змінилась? =

Найчастіше — товар бере участь в акції Епіцентру: поки акція триває, кабінет не дає змінити ціну. Причина видна у списку «Товари, які не оновились» і в картці товару.

= Чи надсилаються ціни, якщо валюта магазину не гривня? =

Ні. Епіцентр приймає ціни в гривнях, тож за іншої валюти модуль надсилає лише наявність.

= Товари створюються в Епіцентрі? =

Не через API: публічне API Епіцентру оновлює лише ціну й наявність. Нові товари модуль збирає в XML-файл з характеристиками, який ви завантажуєте в кабінеті: «Імпорт» → «Файл» → «Оновити все». Після модерації ціни й наявність далі веде синхронізація через API.

= Чому товар не потрапив у файл? =

На сторінці «Епіцентр: товари» є список пропущених товарів з причиною: немає артикула, фото чи ціни, порожня обовʼязкова характеристика або значення, якого немає в довіднику Епіцентру.

== Changelog ==

= 1.1.0 =
* Нове: XML-файл товарів з характеристиками для імпорту в кабінет Епіцентру — довідник категорій і характеристик через API, звʼязка категорій, джерела значень, зіставлення значень списків і звіт про пропущені товари.

= 1.0.0 =
* Перший випуск: оновлення цін і наявності через API Епіцентр Маркетплейс.
