Elementary POS for WooCommerce

Elementary POS is a modern cloud-based point-of-sale system for retail businesses. This plugin enables automatic, real-time synchronization of products and inventory between your Elementary POS system and WooCommerce store.

Key Features

• HPOS Compatible – Fully compatible with WooCommerce High-Performance Order Storage
• Bidirectional Product Import – Import products from Elementary POS to WooCommerce, or export from WooCommerce to Elementary POS
• Tax Mapping System – Intelligent tax mapping between WooCommerce tax classes and Elementary POS tax types
• Draft Mode Import – Option to import new products as Draft instead of Published
• Draft Products Synchronization – Optional synchronization of draft products along with published ones
• Safe Product Removal – Products are moved to Trash instead of permanent deletion, allowing recovery
• Bidirectional Stock Sync – Keep stock levels synchronized in both directions
• Real-time Webhooks – Instant updates when sales occur in Elementary POS
• Automatic Order Sync – WooCommerce orders automatically update Elementary POS inventory
• Queue System – Reliable processing with automatic retry on failures; failed items are automatically retried when new activity occurs
• Comprehensive Logging – Track all synchronization activities with detailed logs
• Manual Controls – Full manual control over synchronization when needed

How It Works

What Gets Synchronized:

Elementary POS → WooCommerce:
* Product data (name, SKU, price, categories, tax classes)
* Stock quantity changes from all sources (sales, manual adjustments, inventory corrections)

WooCommerce → Elementary POS:
* Product data (name, SKU, price, tax classes)
* Stock quantity changes from completed orders
* Manual stock adjustments in WooCommerce admin

When Synchronization Happens:

Elementary POS → WooCommerce:
When any stock change occurs in Elementary POS (sale, manual adjustment, etc.), a webhook is sent to WooCommerce.
The plugin processes the update immediately in real-time, updating stock levels in WooCommerce.

WooCommerce → Elementary POS:
When an order is completed in WooCommerce or when stock is manually changed in WooCommerce admin, stock changes are automatically sent to Elementary POS.
Changes are sent immediately when they occur. If the API is unavailable, changes are queued and retried automatically with exponential backoff (15min, 1hour, 6hours). Any previously failed items are automatically reset and retried when new activity occurs, ensuring no changes are permanently lost.

Requirements

• WordPress 5.8 or higher
• WooCommerce 5.0 or higher
• PHP 7.4 or higher
• Elementary POS API key
• Products must have SKU codes for stock synchronization (product import can work without SKU)

Compatibility

• HPOS Compatible – Fully compatible with WooCommerce High-Performance Order Storage
• WP Cron – Uses WordPress cron for queue processing (runs every 15 minutes)

Limitations

• Decimal Quantities Not Supported – Due to WooCommerce core limitations, only whole number quantities are supported. Decimal values (e.g., 1.5 kg, 0.75 liters) are automatically rounded to integers, which may affect stores selling products by weight, length, or volume.
• Stock Synchronization Trigger – WooCommerce → Elementary POS stock synchronization occurs in two scenarios: (1) when WooCommerce reduces stock from completed orders (via woocommerce_reduce_order_item_stock hook), and (2) when stock is manually changed in WooCommerce admin. If your store has stock management disabled for certain products (e.g., services, digital products), those products will not trigger synchronization to Elementary POS.
• Product Visibility and Stock Status – Newly imported products are set as “Visible” in catalog and “In Stock” by default. During updates, catalog visibility is preserved (not changed), but stock status is always set to “In Stock”. If you need products hidden or out of stock, adjust these settings manually after import.
• Simple Products Only – The plugin imports all products as Simple products (WC_Product_Simple). Products with variants in Elementary POS are imported as single simple products, not as Variable products with variations. If your catalog relies heavily on product variations (size, color, etc.), you will need to manually configure them in WooCommerce after import.
• Flat Category Structure – All product categories from Elementary POS are created as root-level categories in WooCommerce. Category hierarchies (parent/child relationships) are not preserved during import. Categories are matched by name only.
• WP-Cron Limitations – WP-Cron works based on time intervals (e.g., every hour or once a day), but it only runs when someone visits your site. That means if no one opens your website, the task may not run on time but is put to queue and is executed when first visitors load your web.

Support

For support, please visit https://elementarypos.com/en/contact/ or email [email protected]

External Services

This plugin relies on Elementary POS API, a third-party external service, to synchronize product and inventory data between your WooCommerce store and Elementary POS system.

What is Elementary POS API and what is it used for?

Elementary POS API is the cloud-based service provided by Elementary POS that manages your point-of-sale data. This plugin connects to the API to:
* Import products from Elementary POS to WooCommerce
* Synchronize stock levels bidirectionally
* Send WooCommerce order updates to Elementary POS
* Receive real-time stock change notifications via webhooks

What data is sent and when?

The plugin sends data to Elementary POS API in the following situations:

During Product Import:
* No data is sent – the plugin only retrieves product information (SKU, name, price, stock quantity)

During Stock Synchronization (WooCommerce → Elementary POS):
* Product SKU codes
* Stock quantity changes
* Timestamp of changes
* This occurs when you manually trigger WC→EP sync or when an order is completed in WooCommerce

During Webhook Registration:
* Your WordPress site URL
* Webhook endpoint URL
* This occurs when you enable automatic synchronization in plugin settings

What the plugin receives from Elementary POS:
* Product information (SKU, name, price, stock)
* Stock change notifications (SKU, quantity delta)
* Webhook status information

API Endpoints Used

• Production: https://api.elementarypos.com

The appropriate endpoint is automatically selected based on your Elementary POS API key.

Service Terms and Privacy

• Elementary POS Privacy Policy: https://elementarypos.com/en/privacy-policy/

Important: You must have an active Elementary POS account and API key to use this plugin. By using this plugin, you agree to Elementary POS terms of service and acknowledge that data will be transmitted to their API endpoints.

Privacy Policy

This plugin does not collect or store personal user data (names, emails, addresses).

The plugin stores operational data in your database:
* Synchronization logs (timestamps, operation types, product SKUs)
* Queue data for retry operations (product and order information)

All data is stored locally in your WordPress database. No data is sent to third parties except your Elementary POS API endpoint for synchronization purposes. Logs can be cleared manually from the plugin settings.