=== MAXPOS Integration ===
Contributors: makspostal
Tags: iiko, woocommerce, delivery, restaurant, food
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.0.5
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Integration of basic iikoCloud API functionality with WooCommerce: import of categories and products and export of orders.

== Description ==

MAXPOS Integration connects your WooCommerce store to the iiko accounting system (iikoCloud API / Syrve API).

The plugin lets you import your menu from iiko to your website and send customer orders directly to the restaurant POS.

Official plugin website: [en.wpwc.app](https://en.wpwc.app/)
Documentation: [wpwc.app/docs](https://wpwc.app/docs/)

### The free version of the plugin provides:

* **Nomenclature import**: manual [import of core data from iiko](https://wpwc.app/docs/import/menu-import.html): organizations, terminals, nomenclature, payment types, cities, and streets.
* **Soft sync**: [option to preserve manual SEO content](https://wpwc.app/docs/reference/settings.html#additional-import-options) (descriptions, titles, images) from being overwritten on re-import.
* **Order export**: manual [export of orders from WooCommerce to iiko](https://wpwc.app/docs/export/manual-actions.html) (via a button in the admin).
* **Basic settings**: support for one organization and one terminal, [import of cities and streets](https://wpwc.app/docs/quick-start/delivery-payment.html#cities-and-streets-setup), and support for the [new delivery address format](https://wpwc.app/docs/export/address-format.html) on export.

### MAXPOS Integration Pro

For full delivery automation and large chain operations, a professional version of the plugin is available — **[MAXPOS Integration Pro](https://en.wpwc.app/)**.

Pro version features:
* **Automatic order export**: when an order is placed or after online payment.
* **Multi-organization support**: route orders to different organizations and terminals depending on the selected delivery method.
* **Automatic nomenclature import**: [scheduled import with a configurable interval](https://wpwc.app/docs/reference/pro-settings.html#cron-tab).
* **Extended nomenclature import**: support for importing dishes with [sizes and modifiers](https://wpwc.app/docs/modifiers/modifiers.html).
* **iiko webhooks**: [instant stop-list updates and order status synchronization](https://wpwc.app/docs/reference/pro-settings.html#webhooks-tab).
* **Delivery zones on a map (Yandex)**: [visual address selection and zone mapping to delivery methods](https://wpwc.app/docs/export/delivery-zones.html).
* **Custom checkout fields**: [additional checkout fields](https://wpwc.app/docs/reference/pro-settings.html#checkout-tab) (delivery time, guest count, entrance, floor, apartment, table).
* **Loyalty (iikoCard)**: support for [bonus scenarios, redemption, and applying bonuses](https://wpwc.app/docs/loyalty/iikocard.html) at checkout.
* **Kitchen orders**: [export of table orders](https://wpwc.app/docs/export/kitchen-orders.html) (including QR link scenarios).
* **Order status display**: automatic order status updates on the order received page.

A detailed version comparison and feature overview is available in the [official documentation](https://wpwc.app/docs/#pro-vs-free).

== Frequently Asked Questions ==

= Where can I find plugin documentation? =

Full documentation with setup instructions is available at: [wpwc.app/docs](https://wpwc.app/docs/)

= How do I enable Syrve API? =

Detailed instructions for switching to Syrve API are available in [our documentation](https://wpwc.app/docs/other/faq.html#faq-setup).

= Is there a trial version of MAXPOS Integration Pro? =

Yes, we offer a trial version of MAXPOS Integration Pro. To request access, contact us:
- Email: [hi@wpwc.app](mailto:hi@wpwc.app)
- Telegram: [@WPWC_iikoCloud_Bot](https://t.me/WPWC_iikoCloud_Bot)

= I need more information about the plugin =

For more information, visit:
- Website: [en.wpwc.app](https://en.wpwc.app/)
- Email: [hi@wpwc.app](mailto:hi@wpwc.app)
- Telegram: [@WPWC_iikoCloud_Bot](https://t.me/WPWC_iikoCloud_Bot)

== Installation ==

= Using The WordPress Dashboard (Recommended) =

1. Go to `Plugins` → `Add New`
2. Search for "MAXPOS Integration"
3. Click `Install Now`
4. Activate the plugin

= Uploading in WordPress Dashboard =

1. Go to `Plugins` → `Add New`
2. Click `Upload Plugin`
3. Select the `maxpos-integration.zip` file
4. Click `Install Now`
5. Activate the plugin

= Using FTP (Not Recommended) =

1. Download `maxpos-integration.zip`
2. Extract the `maxpos-integration` folder
3. Upload to `/wp-content/plugins/`
4. Activate via the WordPress admin

== Screenshots ==

1. Plugin main page with an overview of features and settings
2. General settings configuration
3. Import settings and options
4. Auto-import configuration
5. Export settings and options
6. Checkout page customization
7. Payment type configuration
8. Webhook settings
9. Loyalty program settings
10. Product display on the frontend
11. Checkout page example
12. Order management with export options
13. Pickup shipping method configuration
14. Courier delivery configuration

== External services ==

This plugin uses the following external services to function:

1. **iiko Cloud API / Syrve API**
   - **Purpose**: This is the core Point of Sale (POS) and restaurant management API that the plugin connects to. It is used to import your restaurant's categories, products, modifiers, cities, and streets into WooCommerce, and to export your customers' orders back to the POS system.
   - **Service URLs**: `https://api-ru.iiko.services/docs` (for iiko Cloud) or `https://api-eu.syrve.live/docs` (for Syrve API).
   - **Terms & Privacy**:
     - iiko: [Privacy Policy](https://iiko.ru/storage/privacy.html), [License agreement (offer)](https://iiko.ru/oferta)
     - Syrve: [Privacy Policy](https://www.syrve.com/en-gb/privacy-policy), [Terms of Service](https://www.syrve.com/en-gb/terms-of-service)

2. **Telegram (Bot API)**
   - **Purpose**: If you configure a Telegram bot under `WooCommerce -> Settings -> MAXPOS Integration -> General`, the site may send operational notifications through the Telegram Bot API.
   - **Service URL**: `https://api.telegram.org/` (Telegram Bot API when notifications are enabled).
   - **Terms & Privacy**: [Telegram Terms of Service](https://telegram.org/tos), [Telegram Privacy Policy](https://telegram.org/privacy)
