內容簡介
Elementary POS for WooCommerce 是一款現代化的雲端銷售點系統，專為零售業務設計。此外掛可實現 Elementary POS 系統與 WooCommerce 商店之間的產品與庫存自動即時同步，提升經營效率。
【主要功能】
• 完全兼容 WooCommerce 高效能訂單儲存（HPOS）
• 雙向產品匯入與匯出
• 智能稅務對應系統
• 草稿模式匯入新產品
• 安全產品移除至垃圾桶
• 實時網頁鉤子更新銷售情況
外掛標籤
開發者團隊
② 後台搜尋「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.
