# WCPOS Documentation > WCPOS is a point of sale (POS) for WooCommerce. It runs in a web browser or as a Windows, macOS or Linux desktop app, with iOS and Android apps in beta. It sells from the same catalogue, stock and prices as your online store and records every sale as a WooCommerce order. The free plugin takes cash and external card payments and prints receipts; WCPOS Pro adds integrated card readers, refunds, stock editing, order history, reports and multiple stores. - [WCPOS Documentation](/index.md) ## getting-started ### connect How to connect WCPOS to your WooCommerce store, including login options and troubleshooting connection issues. - [Connecting to Your Store](/getting-started/connect.md): How to connect WCPOS to your WooCommerce store, including login options and troubleshooting connection issues. ### free-vs-pro A side-by-side comparison of WCPOS Free and WCPOS Pro — every feature, payment gateway, and capability so you can decide which one you need. - [Free vs Pro](/getting-started/free-vs-pro.md): A side-by-side comparison of WCPOS Free and WCPOS Pro — every feature, payment gateway, and capability so you can decide which one you need. ### installation Minimum requirements for WCPOS including WordPress, WooCommerce, and PHP versions, supported browsers, and minimum desktop and mobile operating system versions. - [Installation Requirements](/getting-started/installation.md): Minimum requirements for WCPOS including WordPress, WooCommerce, and PHP versions, supported browsers, and minimum desktop and mobile operating system versions. ### is-wcpos-right-for-you Who WCPOS suits, who it doesn't, what it needs, what it costs, and how it compares with other point-of-sale options for WooCommerce, answered plainly. - [Is WCPOS right for you?](/getting-started/is-wcpos-right-for-you.md): Who WCPOS suits, who it doesn't, what it needs, what it costs, and how it compares with other point-of-sale options for WooCommerce, answered plainly. ### offline What works offline in WCPOS, how the local database syncs with WooCommerce, and what happens when connectivity is lost. - [Offline Functionality](/getting-started/offline.md): What works offline in WCPOS, how the local database syncs with WooCommerce, and what happens when connectivity is lost. ### previous-versions How to downgrade WCPOS by installing a previous version of the plugin from WordPress.org. - [Re-Installing a Previous Version of the WCPOS Plugin](/getting-started/previous-versions.md): How to downgrade WCPOS by installing a previous version of the plugin from WordPress.org. ### pro-license If you have purchased the Pro version please follow the steps below to install the plugin. - [Installing WCPOS Pro](/getting-started/pro-license.md): If you have purchased the Pro version please follow the steps below to install the plugin. ### roadmap Where WCPOS is headed — the public roadmap, how to request or vote on features, and the major themes in development. - [Roadmap](/getting-started/roadmap.md): Where WCPOS is headed — the public roadmap, how to request or vote on features, and the major themes in development. ## pos Overview of the WCPOS point of sale screen layout — header, product panel, cart, navigation drawer, and which screens are Free vs Pro. - [POS Screen Overview](/pos.md): Overview of the WCPOS point of sale screen layout — header, product panel, cart, navigation drawer, and which screens are Free vs Pro. ### cart Manage the shopping cart in WCPOS including line items, quantities, discounts, fees, and customer selection. - [Cart Panel](/pos/cart.md): Manage the shopping cart in WCPOS including line items, quantities, discounts, fees, and customer selection. - [Cart Discounts](/pos/cart/discounts.md): Apply discounts at the WCPOS register — quick percentage discounts, line-item price changes, and order-level discount fees. - [Cart Line Items](/pos/cart/line-items.md): Edit cart line items in WCPOS including quantities, prices, discounts, and product details with inline editing. - [Open Orders](/pos/cart/open-orders.md): Work with multiple orders simultaneously in WCPOS including parking orders, switching between transactions, and recovering from interruptions. - [Order Actions](/pos/cart/order-actions.md): Access order management features in WCPOS including order notes, meta data, fees, shipping, and discounts. ### checkout Complete sales in WCPOS checkout including payment methods, payment processing, and order completion. - [Checkout](/pos/checkout.md): Complete sales in WCPOS checkout including payment methods, payment processing, and order completion. ### product-panel Browse, search, and add products to cart in the WCPOS product panel. Includes grid/list views and category filtering. - [Product Panel](/pos/product-panel.md): Browse, search, and add products to cart in the WCPOS product panel. Includes grid/list views and category filtering. - [Barcode Scanning](/pos/product-panel/barcode-scanning.md): Set up barcode scanning in WCPOS using USB scanners, camera scanning, or custom barcode fields. - [Meta Data Keys](/pos/product-panel/meta-data-keys.md): Copy custom product meta data onto cart and order line items in WCPOS using the Meta Data Keys setting. - [Search & Filtering](/pos/product-panel/search-filtering.md): Search and filter products in WCPOS by name, SKU, category, tags, and other attributes. - [Variable Products](/pos/product-panel/variations.md): Work with WooCommerce variable products in WCPOS including quick selection, inline expansion, and barcode scanning for variations. ### reconciliation Quick end-of-day close for WCPOS cashiers — count the drawer, run the report, compare cash and card, and sign off. - [End-of-Day Reconciliation](/pos/reconciliation.md): Quick end-of-day close for WCPOS cashiers — count the drawer, run the report, compare cash and card, and sign off. ### refunds Quick guide to issuing a refund during a sale in WCPOS — start the refund, choose where the money goes, and confirm. - [Refunds at the Till](/pos/refunds.md): Quick guide to issuing a refund during a sale in WCPOS — start the refund, choose where the money goes, and confirm. ## products Manage WooCommerce products in WCPOS, including inventory updates, price changes, and stock management. - [Products Management](/products.md): Manage WooCommerce products in WCPOS, including inventory updates, price changes, and stock management. ### pos-only-products Control product visibility between your online store and POS, including POS-only and online-only products. - [POS Only Products](/products/pos-only-products.md): Control product visibility between your online store and POS, including POS-only and online-only products. ### sync How WCPOS downloads and synchronises products from WooCommerce, including sync presets, coverage, and keeping the catalogue fresh. - [Product Synchronisation](/products/sync.md): How WCPOS downloads and synchronises products from WooCommerce, including sync presets, coverage, and keeping the catalogue fresh. ## orders View and manage WooCommerce orders in WCPOS, including order history, refunds, and reprinting receipts. - [Orders](/orders.md): View and manage WooCommerce orders in WCPOS, including order history, refunds, and reprinting receipts. ### refunds Issue full or partial refunds for WooCommerce orders directly from WCPOS, with support for refunds back to the original payment method or out of the till as cash. - [Refunds](/orders/refunds.md): Issue full or partial refunds for WooCommerce orders directly from WCPOS, with support for refunds back to the original payment method or out of the till as cash. ## customers Manage WooCommerce customers in WCPOS, including customer lookup, editing details, and viewing order history. - [Customers](/customers.md): Manage WooCommerce customers in WCPOS, including customer lookup, editing details, and viewing order history. ## coupons Manage and apply WooCommerce coupons in WCPOS, including creating coupons, validation rules, and applying them at the register. - [Coupons](/coupons.md): Manage and apply WooCommerce coupons in WCPOS, including creating coupons, validation rules, and applying them at the register. ### applying-coupons The cashier workflow for applying WooCommerce coupons at the WCPOS register — search, coupon pills, sequential discounts, and resolving validation errors. - [Applying Coupons at the Till](/coupons/applying-coupons.md): The cashier workflow for applying WooCommerce coupons at the WCPOS register — search, coupon pills, sequential discounts, and resolving validation errors. ## stores Set up and manage multiple store locations in WCPOS, including per-store pricing, ATUM inventory integration, tax rates, and reports. - [Multi-Store](/stores.md): Set up and manage multiple store locations in WCPOS, including per-store pricing, ATUM inventory integration, tax rates, and reports. ### setup Step-by-step guide to creating and configuring a store location in WCPOS Pro — store details, authorized users, tax, pricing, and login behavior. - [Setting Up Stores](/stores/setup.md): Step-by-step guide to creating and configuring a store location in WCPOS Pro — store details, authorized users, tax, pricing, and login behavior. ## reports View sales reports and analytics in WCPOS, including daily summaries, payment breakdowns, and cashier reports. - [Reports](/reports.md): View sales reports and analytics in WCPOS, including daily summaries, payment breakdowns, and cashier reports. ### reconciliation Cashier-facing end-of-day procedure in WCPOS — count the drawer, run the report, reconcile cash and card, handle variances, and sign off. - [End-of-Day Reconciliation](/reports/reconciliation.md): Cashier-facing end-of-day procedure in WCPOS — count the drawer, run the report, reconcile cash and card, handle variances, and sign off. ## payment Configure payment methods in WCPOS including cash, card, and custom payment gateways like Stripe Terminal and SumUp. - [Payment Methods](/payment.md): Configure payment methods in WCPOS including cash, card, and custom payment gateways like Stripe Terminal and SumUp. ### gateways Payment gateways for WCPOS - [Payment Gateways](/payment/gateways.md): Payment gateways for WCPOS - [Email Invoice Gateway](/payment/gateways/email-invoice.md): Send payment invoices to customers via email in WCPOS - [Mercado Pago Terminal Gateway](/payment/gateways/mercadopago-terminal.md): Take in-person payments on Mercado Pago Point Smart terminals in WCPOS - [Mollie Terminal Gateway](/payment/gateways/mollie-terminal.md): Take in-person payments on Mollie Terminal devices in WCPOS - [PayArc Terminal Gateway](/payment/gateways/payarc-terminal.md): Take in-person payments on PayArc PAX terminals in WCPOS - [PayPal Reader (Zettle) Gateway](/payment/gateways/paypal-reader.md): Accept in-person card payments through a PayPal Reader (Zettle) card terminal in WCPOS - [Square Terminal Gateway](/payment/gateways/square-terminal.md): Collect in-person payments on Square Terminal devices in WCPOS - [Stripe Terminal Gateway](/payment/gateways/stripe-terminal.md): Accept payments using Stripe Terminal hardware readers in WCPOS - [SumUp Terminal Gateway](/payment/gateways/sumup-terminal.md): Process payments through SumUp card readers in WCPOS - [Vipps MobilePay Gateway](/payment/gateways/vipps-mobilepay.md): Accept phone-based payments via QR code or push notification in WCPOS - [Web Checkout Gateway](/payment/gateways/web-checkout.md): Complete payments via the web store checkout in WCPOS - [Windcave Terminal Gateway](/payment/gateways/windcave-terminal.md): Take in-person card payments on Windcave terminals (HIT) in WCPOS ## receipts Customise WCPOS receipts using the template gallery, logicless HTML templates, and thermal printer XML templates. - [Receipts](/receipts.md): Customise WCPOS receipts using the template gallery, logicless HTML templates, and thermal printer XML templates. ### at-checkout Print and email receipts in WCPOS, including printer setup and receipt customisation options. - [Receipts](/receipts/at-checkout.md): Print and email receipts in WCPOS, including printer setup and receipt customisation options. ### cloud-printing Print WCPOS receipts to printers that aren't attached to the till — Star Online, Star CloudPRNT, Epson Server Direct Print, and PrintNode. - [Cloud Printing](/receipts/cloud-printing.md): Print WCPOS receipts to printers that aren't attached to the till — Star Online, Star CloudPRNT, Epson Server Direct Print, and PrintNode. ### customise The easiest way to change how your WCPOS receipt looks — pick a different template, ask AI to tweak it, or edit it by hand. - [Customise Your Receipt](/receipts/customise.md): The easiest way to change how your WCPOS receipt looks — pick a different template, ask AI to tweak it, or edit it by hand. ### html-templates Create and customise logicless HTML receipt templates using Mustache-style placeholders. - [HTML Templates](/receipts/html-templates.md): Create and customise logicless HTML receipt templates using Mustache-style placeholders. ### receipt-data Complete reference for the canonical data contract available in WCPOS receipt templates. - [Receipt Data Reference](/receipts/receipt-data.md): Complete reference for the canonical data contract available in WCPOS receipt templates. ### storefront Let online customers download receipts and invoices from My Account, rendered with your custom WCPOS template. - [Receipts on Your Online Store](/receipts/storefront.md): Let online customers download receipts and invoices from My Account, rendered with your custom WCPOS template. ### thermal-templates Create XML-based receipt templates for ESC/POS thermal printers with Epson and Star support. - [Thermal Printer Templates](/receipts/thermal-templates.md): Create XML-based receipt templates for ESC/POS thermal printers with Epson and Star support. ## hardware Connect physical devices to WCPOS — receipt printers, barcode scanners, card readers, and cash drawers. - [Hardware](/hardware.md): Connect physical devices to WCPOS — receipt printers, barcode scanners, card readers, and cash drawers. ### printers Add a receipt printer in WCPOS — one scan covers USB, Bluetooth and Wi-Fi, then a test page confirms it works. - [Receipt Printers](/hardware/printers.md): Add a receipt printer in WCPOS — one scan covers USB, Bluetooth and Wi-Fi, then a test page confirms it works. - [Printer permissions on Android](/hardware/printers/android-permissions.md): Nearby devices, local network access and plain connections — the three Android permissions that make a printer appear or vanish. - [Pairing a Bluetooth receipt printer](/hardware/printers/bluetooth-pairing.md): Why a Bluetooth printer isn't in the chooser — one host at a time, Classic versus Low Energy, and the status sheet. - [Printing from the browser: permissions and certificates](/hardware/printers/browser-permissions.md): Chrome's local network permission, mixed content and self-signed certificates — the three things that stop a browser reaching a printer. - [Connecting a cash drawer to the printer](/hardware/printers/cash-drawer.md): The drawer plugs into the receipt printer, not the till. How to wire it, switch it on, and what to check when it doesn't pop. - [Let the app find printers on your iPad or iPhone](/hardware/printers/ios-local-network.md): On iOS, a denied Local Network permission looks exactly like a printer that's switched off. Where to turn it back on. - [The logo is missing from receipts printed in the browser](/hardware/printers/logo-missing-browser.md): Receipts print fine except for the store logo, and only in a browser tab — a CORS header on your WordPress uploads is what's missing. - [Give the printer a fixed address on the same network](/hardware/printers/network-address.md): Why a Wi-Fi printer isn't found, or stops working after weeks — subnets, guest Wi-Fi, client isolation, and DHCP. - [Receipts in Chinese, Thai, Arabic or Cyrillic](/hardware/printers/non-latin-receipts.md): Question marks or boxes instead of text mean the printer has no characters for your language. Print the receipt as an image instead. - [Epson printed once and then stopped — power-cycle first](/hardware/printers/printed-once-then-stopped.md): An Epson holding a job it will never print refuses every other job too. A power cycle clears it in ten seconds. - [Getting the receipt width right (58 mm, 80 mm, 42 or 48 characters)](/hardware/printers/receipt-width.md): What the test page's ruler tells you about paper width, and which of the four character-width answers to pick. - [Epson Secure Printing: what it blocks and how to turn it off](/hardware/printers/secure-printing.md): New Epson printers ship with Secure Printing on and silently discard receipts. Where the setting is, which ports it blocks, and how to turn it off. - [Epson prints nothing and its web page still works (Server Direct Print)](/hardware/printers/server-direct-print.md): When another service on the Epson owns the print engine, every receipt fails while the printer looks perfectly healthy. - [Printer Setup Wizard](/hardware/printers/setup-wizard.md): Answer a few questions and we'll walk you through connecting your receipt printer step by step — and help you fix it if the test print doesn't work. - [Supported receipt printers](/hardware/printers/supported-printers.md): Which receipt printers are tested, which are expected to work, and which are not supported yet — plus how to report yours. - [USB printer permissions on Linux](/hardware/printers/usb-linux.md): An access error when printing over USB on Linux means the device belongs to root — add a udev rule to hand it to your user. - [USB receipt printers on Windows: install a Generic/Text driver](/hardware/printers/usb-windows.md): Why a USB printer on Windows either prints nothing or spits out a page of symbols, and how a Generic/Text queue fixes it. ### scanners Connect a barcode scanner to WCPOS — camera, keyboard-mode, USB, and Bluetooth scanners across web, desktop, and mobile. - [Barcode Scanners](/hardware/scanners.md): Connect a barcode scanner to WCPOS — camera, keyboard-mode, USB, and Bluetooth scanners across web, desktop, and mobile. - [Scanner Setup Wizard](/hardware/scanners/setup-wizard.md): Answer a few questions and we'll walk you through setting up your barcode scanner — and help you fix it if a scan doesn't come through. ## settings Overview of WCPOS settings, including WordPress admin settings, store settings, and application preferences. - [Settings Overview](/settings.md): Overview of WCPOS settings, including WordPress admin settings, store settings, and application preferences. ### store Configure WCPOS store settings including general options, tax, barcode scanning, theme, and keyboard shortcuts. - [Store Settings](/settings/store.md): Configure WCPOS store settings including general options, tax, barcode scanning, theme, and keyboard shortcuts. - [Barcode Settings](/settings/store/barcode.md): Configure barcode scanning settings in WCPOS including scan delay, search actions, and camera scanning options. - [General Settings](/settings/store/general.md): Configure WCPOS store settings including currency display, number formatting, and default order status. - [Keyboard Shortcuts](/settings/store/hotkeys.md): Configure keyboard shortcuts in WCPOS for faster checkout and navigation using customisable hotkeys. - [Tax Settings](/settings/store/tax.md): Configure tax calculation and display settings in WCPOS including tax-inclusive pricing and itemised tax display. - [Theme Settings](/settings/store/theme.md): Customise WCPOS appearance with light, dark, and system themes plus accent colour options. ### wp-admin Configure WCPOS backend settings in WordPress admin including general options, checkout, and user access permissions. - [Settings in the WordPress Admin](/settings/wp-admin.md): Configure WCPOS backend settings in WordPress admin including general options, checkout, and user access permissions. - [Accessing the POS](/settings/wp-admin/access.md): Configure user roles and capabilities for WCPOS access including Administrator, Shop Manager, and Cashier permissions. - [Checkout Settings](/settings/wp-admin/checkout.md): Configure WCPOS checkout settings in WordPress admin including payment gateways and order processing. - [Customer Tax IDs](/settings/wp-admin/customer-tax-ids.md): How WCPOS stores customer tax IDs, detects which plugin's field to write to, and copies tax IDs onto orders at checkout. - [Email Notifications](/settings/wp-admin/email-notifications.md): Control which WooCommerce email notifications fire for POS orders — per-email admin, customer, and cashier toggles in WCPOS settings. - [General Settings](/settings/wp-admin/general.md): Configure WCPOS general settings in WordPress admin including POS-only products, decimal quantities, and barcode fields. - [Sessions](/settings/wp-admin/sessions.md): View active POS login sessions per user and device, and remotely sign devices out of WCPOS. - [Store Tax IDs](/settings/wp-admin/store-tax-ids.md): Configure the business tax identifiers WCPOS prints on POS receipts and invoices, including VAT, ABN, GSTIN, EIN, and company-registry numbers. ## integrations Third-party WooCommerce plugins that WCPOS works with out of the box, and what to expect from each. - [Integrations](/integrations.md): Third-party WooCommerce plugins that WCPOS works with out of the box, and what to expect from each. ### woocommerce-tax Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how POS orders get their rates, setup steps, and what to expect at the till. - [WooCommerce Tax](/integrations/woocommerce-tax.md): Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how POS orders get their rates, setup steps, and what to expect at the till. ## extensions Browse, install, and manage POS extensions from the extension directory. Learn how to create and submit your own extensions. - [Extensions](/extensions.md): Browse, install, and manage POS extensions from the extension directory. Learn how to create and submit your own extensions. ### atum Link WCPOS Pro stores to ATUM Multi-Inventory locations for per-location stock, pricing, and SKUs at the POS. - [WCPOS ATUM Integration](/extensions/atum.md): Link WCPOS Pro stores to ATUM Multi-Inventory locations for per-location stock, pricing, and SKUs at the POS. ### polylang Filter WCPOS products by Polylang language and avoid duplicate translated products in the POS. - [WCPOS Polylang](/extensions/polylang.md): Filter WCPOS products by Polylang language and avoid duplicate translated products in the POS. ### storeapps-smart-coupons StoreApps Smart Coupons store credit compatibility for WCPOS receipts, order notes, and POS balance deductions. - [WCPOS StoreApps Smart Coupons](/extensions/storeapps-smart-coupons.md): StoreApps Smart Coupons store credit compatibility for WCPOS receipts, order notes, and POS balance deductions. ### wp-multilang Filter WCPOS products by WP Multilang language and avoid duplicate translated products in the POS. - [WCPOS WP Multilang](/extensions/wp-multilang.md): Filter WCPOS products by WP Multilang language and avoid duplicate translated products in the POS. ### wpml Filter WCPOS products by WPML language and avoid duplicate translated products in the POS. - [WCPOS WPML](/extensions/wpml.md): Filter WCPOS products by WPML language and avoid duplicate translated products in the POS. ## support Get help with WCPOS through Discord, email support, or browse troubleshooting guides and FAQs. - [Support](/support.md): Get help with WCPOS through Discord, email support, or browse troubleshooting guides and FAQs. ### logs Access and understand WCPOS logs for troubleshooting, including the Store health activity log, server-side logs, and error codes. - [Logs](/support/logs.md): Access and understand WCPOS logs for troubleshooting, including the Store health activity log, server-side logs, and error codes. ### notifications Understand the in-app notification bell in WCPOS — where announcements, plugin updates, and licence alerts appear. - [Notifications](/support/notifications.md): Understand the in-app notification bell in WCPOS — where announcements, plugin updates, and licence alerts appear. ### performance Optimise WCPOS performance including server configuration, checkout speed, and WooCommerce HPOS migration. - [Performance](/support/performance.md): Optimise WCPOS performance including server configuration, checkout speed, and WooCommerce HPOS migration. - [Checkout Performance](/support/performance/checkout.md): Troubleshoot slow checkout times in WCPOS by analysing execution times and identifying bottlenecks. - [Server Performance](/support/performance/server.md): Optimise WordPress server performance for WCPOS including HPOS, caching, database optimisation, and hosting recommendations. ### store-health The Store health area in WCPOS: sync performance presets and measured server load, per-collection download coverage, recovering refused changes, and the activity log. - [Store Health](/support/store-health.md): The Store health area in WCPOS: sync performance presets and measured server load, per-collection download coverage, recovering refused changes, and the activity log. ### translations How WCPOS is translated — AI-generated from tuned rules and improved by the community. Suggest fixes for the apps and plugin in the wcpos/translations repo, and for these docs in the wcpos/docs repo. - [Contributing Translations](/support/translations.md): How WCPOS is translated — AI-generated from tuned rules and improved by the community. Suggest fixes for the apps and plugin in the wcpos/translations repo, and for these docs in the wcpos/docs repo. ### troubleshooting - [Clear All Local Data](/support/troubleshooting/clear-local-data.md): How to clear the local WCPOS database and trigger a fresh sync from your WooCommerce store. - [Cloudflare](/support/troubleshooting/cloudflare.md): Stop Cloudflare's security checks from blocking the WCPOS app's connection to your store. - [Troubleshooting "There has been a critical error on this website."](/support/troubleshooting/critical-error.md): Fix the WordPress critical error in WCPOS by checking WooCommerce fatal error logs and identifying the cause. - [Plugin Conflicts](/support/troubleshooting/plugin-conflicts.md): Identify and resolve WordPress plugin conflicts affecting WCPOS using systematic troubleshooting methods. - [Troubleshooting "Cannot read properties of undefined (reading 'data')" Error](/support/troubleshooting/response-error.md): Fix the "Cannot read properties of undefined" error in WCPOS caused by empty server responses or plugin conflicts. - [Your Store and the POS Disagree on Totals](/support/troubleshooting/totals-disagree.md): What it means when WCPOS reports that your store changed an order's totals, and how to find the cause. ## error-codes Reference guide for WCPOS error codes across the sync, auth, checkout, payment, printing, and product domains, with troubleshooting steps. - [Error Codes](/error-codes.md): Reference guide for WCPOS error codes across the sync, auth, checkout, payment, printing, and product domains, with troubleshooting steps. ### api API errors occur when communicating with your WooCommerce server. - [API Errors](/error-codes/api.md): API errors occur when communicating with your WooCommerce server. ### API01001 API01001: Connection Timeout — The POS application attempted to connect to your WooCommerce server, but the server took too long to respond. - [API01001: Connection Timeout](/error-codes/API01001.md): API01001: Connection Timeout — The POS application attempted to connect to your WooCommerce server, but the server took too long to respond. ### API01002 API01002: Connection Refused — The server actively refused the connection attempt. - [API01002: Connection Refused](/error-codes/API01002.md): API01002: Connection Refused — The server actively refused the connection attempt. ### API01003 API01003: Connection Reset — The connection to the server was established but then unexpectedly closed. - [API01003: Connection Reset](/error-codes/API01003.md): API01003: Connection Reset — The connection to the server was established but then unexpectedly closed. ### API01004 API01004: DNS Resolution Failed — The POS could not convert your website's domain name (e.g., yourstore.com) into an IP address. - [API01004: DNS Resolution Failed](/error-codes/API01004.md): API01004: DNS Resolution Failed — The POS could not convert your website's domain name (e.g., yourstore.com) into an IP address. ### API01005 API01005: SSL Certificate Error — There's a problem with your website's SSL/TLS certificate. - [API01005: SSL Certificate Error](/error-codes/API01005.md): API01005: SSL Certificate Error — There's a problem with your website's SSL/TLS certificate. ### API01006 API01006: Network Unreachable — The POS cannot establish a route to the server. - [API01006: Network Unreachable](/error-codes/API01006.md): API01006: Network Unreachable — The POS cannot establish a route to the server. ### API01007 API01007: Device Offline — Your device is not connected to the internet. - [API01007: Device Offline](/error-codes/API01007.md): API01007: Device Offline — Your device is not connected to the internet. ### API01008 API01008: Website Unavailable — The POS can reach the internet, but your specific website is not responding. - [API01008: Website Unavailable](/error-codes/API01008.md): API01008: Website Unavailable — The POS can reach the internet, but your specific website is not responding. ### API02001 API02001: Invalid Credentials — The username or password you entered is incorrect. - [API02001: Invalid Credentials](/error-codes/API02001.md): API02001: Invalid Credentials — The username or password you entered is incorrect. ### API02002 API02002: Token Expired — Your authentication session has expired. - [API02002: Token Expired](/error-codes/API02002.md): API02002: Token Expired — Your authentication session has expired. ### API02003 API02003: Token Invalid — The authentication token being used is not recognized by the server. - [API02003: Token Invalid](/error-codes/API02003.md): API02003: Token Invalid — The authentication token being used is not recognized by the server. ### API02004 API02004: User Not Authorized — You're logged in, but your user account doesn't have permission to perform the requested action. - [API02004: User Not Authorized](/error-codes/API02004.md): API02004: User Not Authorized — You're logged in, but your user account doesn't have permission to perform the requested action. ### API02005 API02005: Insufficient Permissions — Your user account lacks the specific WordPress capabilities required for this action. - [API02005: Insufficient Permissions](/error-codes/API02005.md): API02005: Insufficient Permissions — Your user account lacks the specific WordPress capabilities required for this action. ### API02006 API02006: API Key Invalid — The WooCommerce REST API key being used is invalid. - [API02006: API Key Invalid](/error-codes/API02006.md): API02006: API Key Invalid — The WooCommerce REST API key being used is invalid. ### API02007 API02007: Token Refresh Failed — The POS tried to automatically renew your authentication session, but the refresh request failed. - [API02007: Token Refresh Failed](/error-codes/API02007.md): API02007: Token Refresh Failed — The POS tried to automatically renew your authentication session, but the refresh request failed. ### API02008 API02008: Refresh Token Invalid — The refresh token stored by the POS is not recognized by the server. - [API02008: Refresh Token Invalid](/error-codes/API02008.md): API02008: Refresh Token Invalid — The refresh token stored by the POS is not recognized by the server. ### API02009 API02009: Refresh Token Expired — Your refresh token has exceeded its lifetime and can no longer be used to obtain new access tokens. - [API02009: Refresh Token Expired](/error-codes/API02009.md): API02009: Refresh Token Expired — Your refresh token has exceeded its lifetime and can no longer be used to obtain new access tokens. ### API02010 API02010: Auth Required — The action you're trying to perform requires authentication, but you're not currently logged in. - [API02010: Auth Required](/error-codes/API02010.md): API02010: Auth Required — The action you're trying to perform requires authentication, but you're not currently logged in. ### API03001 API03001: Invalid Request Format — The request sent to the server was not in the expected format. - [API03001: Invalid Request Format](/error-codes/API03001.md): API03001: Invalid Request Format — The request sent to the server was not in the expected format. ### API03002 API03002: Missing Required Parameters — The request is missing data that the server needs to complete the action. - [API03002: Missing Required Parameters](/error-codes/API03002.md): API03002: Missing Required Parameters — The request is missing data that the server needs to complete the action. ### API03003 API03003: Invalid Parameter Value — One of the values in your request is invalid. - [API03003: Invalid Parameter Value](/error-codes/API03003.md): API03003: Invalid Parameter Value — One of the values in your request is invalid. ### API03004 API03004: Request Too Large — The request you're sending exceeds the server's size limits. - [API03004: Request Too Large](/error-codes/API03004.md): API03004: Request Too Large — The request you're sending exceeds the server's size limits. ### API03005 API03005: Rate Limit Exceeded — You've made too many requests to the server in a short period. - [API03005: Rate Limit Exceeded](/error-codes/API03005.md): API03005: Rate Limit Exceeded — You've made too many requests to the server in a short period. ### API03006 API03006: Unsupported Method — The HTTP method used (GET, POST, PUT, DELETE, etc.) is not supported for this endpoint. - [API03006: Unsupported Method](/error-codes/API03006.md): API03006: Unsupported Method — The HTTP method used (GET, POST, PUT, DELETE, etc.) is not supported for this endpoint. ### API03007 API03007: Request Queue Full — The POS has too many pending requests waiting to be sent. - [API03007: Request Queue Full](/error-codes/API03007.md): API03007: Request Queue Full — The POS has too many pending requests waiting to be sent. ### API04001 API04001: Invalid Response Format — The server responded, but the response format is not what the POS expected. - [API04001: Invalid Response Format](/error-codes/API04001.md): API04001: Invalid Response Format — The server responded, but the response format is not what the POS expected. ### API04002 API04002: Unexpected Response Code — The server returned an HTTP status code that wasn't expected for this request. - [API04002: Unexpected Response Code](/error-codes/API04002.md): API04002: Unexpected Response Code — The server returned an HTTP status code that wasn't expected for this request. ### API04003 API04003: Malformed JSON Response — The server returned data that appears to be JSON but is corrupted or invalid. - [API04003: Malformed JSON Response](/error-codes/API04003.md): API04003: Malformed JSON Response — The server returned data that appears to be JSON but is corrupted or invalid. ### API04004 API04004: Missing Response Data — The server responded successfully, but the response is missing expected data. - [API04004: Missing Response Data](/error-codes/API04004.md): API04004: Missing Response Data — The server responded successfully, but the response is missing expected data. ### API04005 API04005: JSON Recovery Attempted — The server sent a response with some invalid JSON content, but the POS attempted to recover and extract valid data. - [API04005: JSON Recovery Attempted](/error-codes/API04005.md): API04005: JSON Recovery Attempted — The server sent a response with some invalid JSON content, but the POS attempted to recover and extract valid data. ### API04006 API04006: Resource Not Found — The server could not find the requested resource. - [API04006: Resource Not Found](/error-codes/API04006.md): API04006: Resource Not Found — The server could not find the requested resource. ### API05001 API05001: WooCommerce API Disabled — The WooCommerce REST API is disabled on your site. - [API05001: WooCommerce API Disabled](/error-codes/API05001.md): API05001: WooCommerce API Disabled — The WooCommerce REST API is disabled on your site. ### API05002 API05002: WCPOS Plugin Not Found — The WCPOS plugin is not installed or not active on your WordPress site. - [API05002: WCPOS Plugin Not Found](/error-codes/API05002.md): API05002: WCPOS Plugin Not Found — The WCPOS plugin is not installed or not active on your WordPress site. ### API05003 API05003: WCPOS Plugin Outdated — The WCPOS plugin installed on your server is outdated and not compatible with your version of the POS application. - [API05003: WCPOS Plugin Outdated](/error-codes/API05003.md): API05003: WCPOS Plugin Outdated — The WCPOS plugin installed on your server is outdated and not compatible with your version of the POS application. ### API05004 API05004: WordPress API Disabled — The WordPress REST API is disabled on your site. - [API05004: WordPress API Disabled](/error-codes/API05004.md): API05004: WordPress API Disabled — The WordPress REST API is disabled on your site. ### API05005 API05005: Plugin Not Found — A required WordPress plugin is not installed or active. - [API05005: Plugin Not Found](/error-codes/API05005.md): API05005: Plugin Not Found — A required WordPress plugin is not installed or active. ### API06001 API06001: Invalid URL Format — The URL configured for your WooCommerce site is not in a valid format. - [API06001: Invalid URL Format](/error-codes/API06001.md): API06001: Invalid URL Format — The URL configured for your WooCommerce site is not in a valid format. ### API06002 API06002: Missing API URL — No URL has been configured for connecting to your WooCommerce store. - [API06002: Missing API URL](/error-codes/API06002.md): API06002: Missing API URL — No URL has been configured for connecting to your WooCommerce store. ### API06003 API06003: Invalid Site Configuration — The site configuration is invalid or incomplete. - [API06003: Invalid Site Configuration](/error-codes/API06003.md): API06003: Invalid Site Configuration — The site configuration is invalid or incomplete. ### AUTH101 Your session ended and you need to sign in again. - [AUTH101: Session expired](/error-codes/AUTH101.md): Your session ended and you need to sign in again. ### AUTH111 The store did not accept the sign-in credentials. - [AUTH111: Credentials rejected](/error-codes/AUTH111.md): The store did not accept the sign-in credentials. ### AUTH121 The signed-in store account does not match the cashier on this till. - [AUTH121: Signed in as wrong user](/error-codes/AUTH121.md): The signed-in store account does not match the cashier on this till. ### AUTH131 The saved store session was incomplete, so WCPOS returned to the store list. - [AUTH131: Store session incomplete](/error-codes/AUTH131.md): The saved store session was incomplete, so WCPOS returned to the store list. ### AUTH201 Your account does not have permission to perform this action. - [AUTH201: Insufficient role](/error-codes/AUTH201.md): Your account does not have permission to perform this action. ### AUTH301 Another authentication plugin is preventing WCPOS from connecting. - [AUTH301: Auth plugin conflict](/error-codes/AUTH301.md): Another authentication plugin is preventing WCPOS from connecting. ### AUTH311 WCPOS can't reach its connection point on your store. - [AUTH311: Rest route missing](/error-codes/AUTH311.md): WCPOS can't reach its connection point on your store. ### AUTH321 WooCommerce is not active on this site, so WCPOS cannot connect. - [AUTH321: WooCommerce missing](/error-codes/AUTH321.md): WooCommerce is not active on this site, so WCPOS cannot connect. ### AUTH331 This store's WCPOS plugin is too old for this version of the app. - [AUTH331: WCPOS plugin outdated](/error-codes/AUTH331.md): This store's WCPOS plugin is too old for this version of the app. ### AUTH401 A secure connection to this store could not be trusted. - [AUTH401: TLS untrusted](/error-codes/AUTH401.md): A secure connection to this store could not be trusted. ### AUTH411 The store address is missing or not a valid URL. - [AUTH411: Store URL invalid](/error-codes/AUTH411.md): The store address is missing or not a valid URL. ### AUTH421 The store's server is blocking the login token on every channel this app can use. - [AUTH421: Auth token blocked by host](/error-codes/AUTH421.md): The store's server is blocking the login token on every channel this app can use. ### AUTH431 The store's REST API did not answer on any address form this app can use. - [AUTH431: Rest transport blocked](/error-codes/AUTH431.md): The store's REST API did not answer on any address form this app can use. ### AUTH441 The login token is larger than this server accepts. - [AUTH441: Auth token too large](/error-codes/AUTH441.md): The login token is larger than this server accepts. ### AUTH999 Signing in or staying signed in hit an unexpected problem. - [AUTH999: Auth unexpected](/error-codes/AUTH999.md): Signing in or staying signed in hit an unexpected problem. ### CHECKOUT101 Checkout did not finish, and the cart is still safe to retry. - [CHECKOUT101: Checkout failed cart safe](/error-codes/CHECKOUT101.md): Checkout did not finish, and the cart is still safe to retry. ### CHECKOUT111 This change could not be applied to the cart, which is unchanged. - [CHECKOUT111: Cart update failed](/error-codes/CHECKOUT111.md): This change could not be applied to the cart, which is unchanged. ### CHECKOUT201 WCPOS could not confirm whether checkout completed. - [CHECKOUT201: Checkout outcome unknown](/error-codes/CHECKOUT201.md): WCPOS could not confirm whether checkout completed. ### CHECKOUT211 The store returned no checkout result, so the order status is unknown. - [CHECKOUT211: Checkout empty response](/error-codes/CHECKOUT211.md): The store returned no checkout result, so the order status is unknown. ### CHECKOUT301 Checkout cannot continue because a product SKU is duplicated or invalid. - [CHECKOUT301: SKU duplicate](/error-codes/CHECKOUT301.md): Checkout cannot continue because a product SKU is duplicated or invalid. ### CHECKOUT401 Your store's total for this order differs from what the till showed. The order is saved with the store's total. - [CHECKOUT401: Totals diverged](/error-codes/CHECKOUT401.md): Your store's total for this order differs from what the till showed. The order is saved with the store's total. ### CHECKOUT411 A line on this order has price details the POS could not read, so its amount was taken from the stored totals instead. - [CHECKOUT411: Cart line price basis unreadable](/error-codes/CHECKOUT411.md): A line on this order has price details the POS could not read, so its amount was taken from the stored totals instead. ### CHECKOUT421 This order refers to a tax rate your store no longer has, so its tax may be wrong. - [CHECKOUT421: Order tax rate unknown](/error-codes/CHECKOUT421.md): This order refers to a tax rate your store no longer has, so its tax may be wrong. ### CHECKOUT999 Checkout hit an unexpected problem. - [CHECKOUT999: Checkout unexpected](/error-codes/CHECKOUT999.md): Checkout hit an unexpected problem. ### CLIENT101 WCPOS could not finish starting. - [CLIENT101: App start failed](/error-codes/CLIENT101.md): WCPOS could not finish starting. ### CLIENT111 Syncing is taking longer than expected to start. - [CLIENT111: App start slow](/error-codes/CLIENT111.md): Syncing is taking longer than expected to start. ### CLIENT121 This browser lets only one tab send changes at a time. - [CLIENT121: Multi tab limited](/error-codes/CLIENT121.md): This browser lets only one tab send changes at a time. ### CLIENT131 WCPOS queued too many requests at once and dropped some. - [CLIENT131: Request queue overflow](/error-codes/CLIENT131.md): WCPOS queued too many requests at once and dropped some. ### CLIENT141 Search showed some results that don't match your products, so WCPOS hid them. - [CLIENT141: Search results did not match](/error-codes/CLIENT141.md): Search showed some results that don't match your products, so WCPOS hid them. ### CLIENT142 The search index did not answer in time, so WCPOS searched the catalogue directly instead. - [CLIENT142: Search index did not answer](/error-codes/CLIENT142.md): The search index did not answer in time, so WCPOS searched the catalogue directly instead. ### CLIENT143 Search was missing a product it should have found. - [CLIENT143: Search index missed a record](/error-codes/CLIENT143.md): Search was missing a product it should have found. ### CLIENT144 A search index rebuild failed, so results may be incomplete while the app retries initialization. - [CLIENT144: Search index rebuild failed](/error-codes/CLIENT144.md): A search index rebuild failed, so results may be incomplete while the app retries initialization. ### CLIENT151 Part of the screen failed to load and was replaced by an error message. - [CLIENT151: Screen render failed](/error-codes/CLIENT151.md): Part of the screen failed to load and was replaced by an error message. ### CLIENT171 This device's clock and your store's clock are more than a minute apart. - [CLIENT171: Clock out of sync](/error-codes/CLIENT171.md): This device's clock and your store's clock are more than a minute apart. ### CLIENT181 WCPOS couldn't switch to that store. - [CLIENT181: Store switch failed](/error-codes/CLIENT181.md): WCPOS couldn't switch to that store. ### CLIENT201 This device ran out of memory, and the last action may not have finished. - [CLIENT201: Out of memory](/error-codes/CLIENT201.md): This device ran out of memory, and the last action may not have finished. ### CLIENT211 WCPOS stopped because of a device-level crash. - [CLIENT211: Native crash](/error-codes/CLIENT211.md): WCPOS stopped because of a device-level crash. ### CLIENT999 WCPOS encountered an unexpected error. - [CLIENT999: Unexpected error](/error-codes/CLIENT999.md): WCPOS encountered an unexpected error. ### db Database errors occur when storing or retrieving data in the local database. - [Database Errors](/error-codes/db.md): Database errors occur when storing or retrieving data in the local database. ### DB01001 DB01001: Connection Failed — The POS could not connect to its local database. - [DB01001: Connection Failed](/error-codes/DB01001.md): DB01001: Connection Failed — The POS could not connect to its local database. ### DB01002 DB01002: Query Timeout — A database operation took too long to complete. - [DB01002: Query Timeout](/error-codes/DB01002.md): DB01002: Query Timeout — A database operation took too long to complete. ### DB01003 DB01003: Transaction Failed — A database transaction could not be completed. - [DB01003: Transaction Failed](/error-codes/DB01003.md): DB01003: Transaction Failed — A database transaction could not be completed. ### DB02001 DB02001: Duplicate Record — The database tried to insert a record with an ID that already exists. - [DB02001: Duplicate Record](/error-codes/DB02001.md): DB02001: Duplicate Record — The database tried to insert a record with an ID that already exists. ### DB02002 DB02002: Record Not Found — The requested record does not exist in the local database. - [DB02002: Record Not Found](/error-codes/DB02002.md): DB02002: Record Not Found — The requested record does not exist in the local database. ### DB02003 DB02003: Constraint Violation — The data you're trying to save violates database rules. - [DB02003: Constraint Violation](/error-codes/DB02003.md): DB02003: Constraint Violation — The data you're trying to save violates database rules. ### DB03001 DB03001: Query Syntax Error — The database query has syntax errors. - [DB03001: Query Syntax Error](/error-codes/DB03001.md): DB03001: Query Syntax Error — The database query has syntax errors. ### DB03002 DB03002: Invalid Data Type — The data type doesn't match what the database expects. - [DB03002: Invalid Data Type](/error-codes/DB03002.md): DB03002: Invalid Data Type — The data type doesn't match what the database expects. ### DB03003 DB03003: Missing Required Field — A required field was not provided. - [DB03003: Missing Required Field](/error-codes/DB03003.md): DB03003: Missing Required Field — A required field was not provided. ### HOST101 The server is blocking the browser's permission check (CORS preflight), so the web app cannot reach it. - [HOST101: Cors preflight blocked](/error-codes/HOST101.md): The server is blocking the browser's permission check (CORS preflight), so the web app cannot reach it. ### HOST111 The server's cross-origin (CORS) configuration is broken, so the browser refuses its responses. - [HOST111: Cors misconfigured](/error-codes/HOST111.md): The server's cross-origin (CORS) configuration is broken, so the browser refuses its responses. ### HOST121 A bot-protection page is answering instead of the store's API. - [HOST121: Bot challenge blocking api](/error-codes/HOST121.md): A bot-protection page is answering instead of the store's API. ### HOST131 A proxy in front of the store rejects the server's responses for having too many headers. - [HOST131: Response headers rejected](/error-codes/HOST131.md): A proxy in front of the store rejects the server's responses for having too many headers. ### HOST141 The host's security filter is blocking product searches. - [HOST141: Search blocked by waf](/error-codes/HOST141.md): The host's security filter is blocking product searches. ### HOST151 Your host's cache can replay one person's store data to another. - [HOST151: Cache shared replay](/error-codes/HOST151.md): Your host's cache can replay one person's store data to another. ### HOST161 The host is rate-limiting this store's tills. - [HOST161: Host rate limited](/error-codes/HOST161.md): The host is rate-limiting this store's tills. ### LICENSE101 Your WCPOS Pro license is not active for this store or device. - [LICENSE101: License not active here](/error-codes/LICENSE101.md): Your WCPOS Pro license is not active for this store or device. ### LICENSE201 WCPOS Pro is disabled because its version does not match WCPOS. - [LICENSE201: Version skew Pro disabled](/error-codes/LICENSE201.md): WCPOS Pro is disabled because its version does not match WCPOS. ### LICENSE301 The updater is not authorized to download WCPOS Pro updates. - [LICENSE301: Updater not authorized](/error-codes/LICENSE301.md): The updater is not authorized to download WCPOS Pro updates. ### LICENSE999 License checking hit an unexpected problem. - [LICENSE999: License unexpected](/error-codes/LICENSE999.md): License checking hit an unexpected problem. ### PAYMENT101 Payment succeeded, but WCPOS could not refresh its status afterward. - [PAYMENT101: Payment ok status check failed](/error-codes/PAYMENT101.md): Payment succeeded, but WCPOS could not refresh its status afterward. ### PAYMENT201 WCPOS could not confirm whether the terminal charged the payment. - [PAYMENT201: Payment outcome unknown](/error-codes/PAYMENT201.md): WCPOS could not confirm whether the terminal charged the payment. ### PAYMENT301 The selected payment gateway is unavailable for this store. - [PAYMENT301: Gateway unavailable](/error-codes/PAYMENT301.md): The selected payment gateway is unavailable for this store. ### PAYMENT311 WCPOS couldn't confirm whether this refund went through. - [PAYMENT311: Refund outcome unknown](/error-codes/PAYMENT311.md): WCPOS couldn't confirm whether this refund went through. ### PAYMENT401 The payment terminal did not finish pairing with WCPOS. - [PAYMENT401: Terminal pairing incomplete](/error-codes/PAYMENT401.md): The payment terminal did not finish pairing with WCPOS. ### PAYMENT999 Payment handling hit an unexpected problem. - [PAYMENT999: Payment unexpected](/error-codes/PAYMENT999.md): Payment handling hit an unexpected problem. ### PRINT101 Automatic printing did not start for this receipt. - [PRINT101: Autoprint did not start](/error-codes/PRINT101.md): Automatic printing did not start for this receipt. ### PRINT201 WCPOS could not confirm that the print job completed. - [PRINT201: Print job failed](/error-codes/PRINT201.md): WCPOS could not confirm that the print job completed. ### PRINT301 The selected printer cannot be reached. - [PRINT301: Printer unreachable](/error-codes/PRINT301.md): The selected printer cannot be reached. ### PRINT311 This receipt could not be emailed or downloaded. - [PRINT311: Receipt delivery failed](/error-codes/PRINT311.md): This receipt could not be emailed or downloaded. ### PRINT999 Printing hit an unexpected problem. No sale is affected. - [PRINT999: Print unexpected](/error-codes/PRINT999.md): Printing hit an unexpected problem. No sale is affected. ### PRODUCT101 This product change hasn't reached your store yet. - [PRODUCT101: Product save failed](/error-codes/PRODUCT101.md): This product change hasn't reached your store yet. ### PRODUCT111 This variation could not be added to the product. - [PRODUCT111: Variation add failed](/error-codes/PRODUCT111.md): This variation could not be added to the product. ### PRODUCT201 This product image is unavailable, but the product can still be sold. - [PRODUCT201: Product image unavailable](/error-codes/PRODUCT201.md): This product image is unavailable, but the product can still be sold. ### PRODUCT301 No products matched the current search and filters. - [PRODUCT301: Search no results reason](/error-codes/PRODUCT301.md): No products matched the current search and filters. ### PRODUCT321 More than one product matches this barcode. - [PRODUCT321: Barcode ambiguous](/error-codes/PRODUCT321.md): More than one product matches this barcode. ### PRODUCT401 The displayed stock may be older than the store stock. - [PRODUCT401: Stock stale](/error-codes/PRODUCT401.md): The displayed stock may be older than the store stock. ### PRODUCT411 Barcode scanning settings could not be loaded, so scans may not match products. - [PRODUCT411: Barcode config unavailable](/error-codes/PRODUCT411.md): Barcode scanning settings could not be loaded, so scans may not match products. ### PRODUCT421 This product's variation price data could not be read, so displayed prices may be wrong or missing. - [PRODUCT421: Variable price meta invalid](/error-codes/PRODUCT421.md): This product's variation price data could not be read, so displayed prices may be wrong or missing. ### PRODUCT999 Loading or updating products hit an unexpected problem. - [PRODUCT999: Product unexpected](/error-codes/PRODUCT999.md): Loading or updating products hit an unexpected problem. ### py Payment errors occur during checkout and payment processing. - [Payment Errors](/error-codes/py.md): Payment errors occur during checkout and payment processing. ### PY01001 PY01001: Payment Declined — The payment was declined by the payment processor or card issuer. - [PY01001: Payment Declined](/error-codes/PY01001.md): PY01001: Payment Declined — The payment was declined by the payment processor or card issuer. ### PY01002 PY01002: Insufficient Funds — The payment was declined because there isn't enough money in the account to cover the transaction. - [PY01002: Insufficient Funds](/error-codes/PY01002.md): PY01002: Insufficient Funds — The payment was declined because there isn't enough money in the account to cover the transaction. ### PY01003 PY01003: Card Expired — The payment card has passed its expiration date and can no longer be used for transactions. - [PY01003: Card Expired](/error-codes/PY01003.md): PY01003: Card Expired — The payment card has passed its expiration date and can no longer be used for transactions. ### PY01004 PY01004: Invalid Card Number — The card number entered is not valid. - [PY01004: Invalid Card Number](/error-codes/PY01004.md): PY01004: Invalid Card Number — The card number entered is not valid. ### PY02001 PY02001: Payment Gateway Error — An error occurred while communicating with the payment gateway. - [PY02001: Payment Gateway Error](/error-codes/PY02001.md): PY02001: Payment Gateway Error — An error occurred while communicating with the payment gateway. ### PY02002 PY02002: Payment Timeout — The payment processing took too long and timed out. - [PY02002: Payment Timeout](/error-codes/PY02002.md): PY02002: Payment Timeout — The payment processing took too long and timed out. ### sy System errors are related to device resources and system configuration. - [System Errors](/error-codes/sy.md): System errors are related to device resources and system configuration. ### SY01001 SY01001: Out of Memory — Your device is running low on memory (RAM) and cannot complete the requested operation. - [SY01001: Out of Memory](/error-codes/SY01001.md): SY01001: Out of Memory — Your device is running low on memory (RAM) and cannot complete the requested operation. ### SY01002 SY01002: Disk Full — Your device's storage is full. - [SY01002: Disk Full](/error-codes/SY01002.md): SY01002: Disk Full — Your device's storage is full. ### SY01003 SY01003: Permission Denied — The POS application doesn't have permission to access a required resource. - [SY01003: Permission Denied](/error-codes/SY01003.md): SY01003: Permission Denied — The POS application doesn't have permission to access a required resource. ### SY02001 SY02001: Invalid Configuration — The system configuration is invalid or corrupted. - [SY02001: Invalid Configuration](/error-codes/SY02001.md): SY02001: Invalid Configuration — The system configuration is invalid or corrupted. ### SY02002 SY02002: Service Unavailable — A required service or component is not available. - [SY02002: Service Unavailable](/error-codes/SY02002.md): SY02002: Service Unavailable — A required service or component is not available. ### SYNC101 WCPOS couldn't write a change to this device's storage. - [SYNC101: Local DB write failed](/error-codes/SYNC101.md): WCPOS couldn't write a change to this device's storage. ### SYNC111 Some data stored on this device is damaged, so it can't sync. - [SYNC111: Local DB corrupted](/error-codes/SYNC111.md): Some data stored on this device is damaged, so it can't sync. ### SYNC121 Your store can't be reached right now. - [SYNC121: Sync unreachable](/error-codes/SYNC121.md): Your store can't be reached right now. ### SYNC131 Your store had an error and didn't finish this request. - [SYNC131: Store server error](/error-codes/SYNC131.md): Your store had an error and didn't finish this request. ### SYNC141 Your store asked WCPOS to slow down for a moment. - [SYNC141: Store rate limited](/error-codes/SYNC141.md): Your store asked WCPOS to slow down for a moment. ### SYNC151 Your store's reply had stray text in it, which WCPOS tried to clean up. - [SYNC151: Store response malformed](/error-codes/SYNC151.md): Your store's reply had stray text in it, which WCPOS tried to clean up. ### SYNC161 This device's storage stopped responding, so saving is paused. - [SYNC161: Local DB unavailable](/error-codes/SYNC161.md): This device's storage stopped responding, so saving is paused. ### SYNC171 WCPOS couldn't set up or remove storage on this device. - [SYNC171: Local DB setup failed](/error-codes/SYNC171.md): WCPOS couldn't set up or remove storage on this device. ### SYNC181 Saving or loading on this device is very slow, and its outcome is not yet known. - [SYNC181: Local database call stalled](/error-codes/SYNC181.md): Saving or loading on this device is very slow, and its outcome is not yet known. ### SYNC191 This change is still on its way to your store. - [SYNC191: Write still sending](/error-codes/SYNC191.md): This change is still on its way to your store. ### SYNC201 Your store refused this change, so it hasn't reached the store. - [SYNC201: Record rejected](/error-codes/SYNC201.md): Your store refused this change, so it hasn't reached the store. ### SYNC202 Your store refused this change, so this device went back to the store's version. - [SYNC202: Record reverted](/error-codes/SYNC202.md): Your store refused this change, so this device went back to the store's version. ### SYNC211 Your store refused a value it was sent. - [SYNC211: Record invalid field](/error-codes/SYNC211.md): Your store refused a value it was sent. ### SYNC221 A change on this device met a newer edit in your store. Nothing is lost. - [SYNC221: Record conflict](/error-codes/SYNC221.md): A change on this device met a newer edit in your store. Nothing is lost. ### SYNC222 This device saved its version over a newer edit made in your store. - [SYNC222: Store edit overwritten](/error-codes/SYNC222.md): This device saved its version over a newer edit made in your store. ### SYNC231 Your store received this change, but this device couldn't record that it was sent. - [SYNC231: Record sent, unrecorded](/error-codes/SYNC231.md): Your store received this change, but this device couldn't record that it was sent. ### SYNC301 Your store's list of changes moved unexpectedly, so WCPOS is re-checking it by itself. Nothing is lost. - [SYNC301: Sync behind head](/error-codes/SYNC301.md): Your store's list of changes moved unexpectedly, so WCPOS is re-checking it by itself. Nothing is lost. ### SYNC311 Data on this device was saved by a different WCPOS version and can't be opened yet. - [SYNC311: Schema mismatch](/error-codes/SYNC311.md): Data on this device was saved by a different WCPOS version and can't be opened yet. ### SYNC321 Some data didn't sync this time. - [SYNC321: Sync partial](/error-codes/SYNC321.md): Some data didn't sync this time. ### SYNC331 This device's copy of a record doesn't match your store's. Nothing you entered is affected. - [SYNC331: Local record diverged](/error-codes/SYNC331.md): This device's copy of a record doesn't match your store's. Nothing you entered is affected. ### SYNC341 This store now requires a newer version of the POS app. - [SYNC341: App update required](/error-codes/SYNC341.md): This store now requires a newer version of the POS app. ### SYNC401 A background sync task stopped unexpectedly before finishing. - [SYNC401: Sync task crashed](/error-codes/SYNC401.md): A background sync task stopped unexpectedly before finishing. ### SYNC411 This device asked the store for data far more often than normal. - [SYNC411: Demand request flood](/error-codes/SYNC411.md): This device asked the store for data far more often than normal. ### SYNC999 Syncing hit an unexpected problem. - [SYNC999: Sync unexpected](/error-codes/SYNC999.md): Syncing hit an unexpected problem. ## reference ### architecture Technical architecture of WCPOS explaining how the POS client communicates with the WooCommerce REST API. - [Architecture](/reference/architecture.md): Technical architecture of WCPOS explaining how the POS client communicates with the WooCommerce REST API. ### fiscal-compliance Where WCPOS stands on fiscal certification (France NF525, Spain VERIFACTU, Norway, Chile) and EU OSS, and the available workarounds. - [Fiscal Compliance & Certification](/reference/fiscal-compliance.md): Where WCPOS stands on fiscal certification (France NF525, Spain VERIFACTU, Norway, Chile) and EU OSS, and the available workarounds. ### gateway-template Create a custom POS-only payment gateway for WCPOS - [Gateway Template](/reference/gateway-template.md): Create a custom POS-only payment gateway for WCPOS ### pos-discounts Developer reference for how WCPOS stores POS line-item price overrides, how they interact with WooCommerce coupons, and the available filters. - [POS Discount Technical Reference](/reference/pos-discounts.md): Developer reference for how WCPOS stores POS line-item price overrides, how they interact with WooCommerce coupons, and the available filters. ### role-endpoint-access Developer reference for which WCPOS REST endpoints are accessible to each default role (administrator, shop_manager, cashier), plus token-expiry behaviour and diagnostic tips. - [Role Endpoint Access](/reference/role-endpoint-access.md): Developer reference for which WCPOS REST endpoints are accessible to each default role (administrator, shop_manager, cashier), plus token-expiry behaviour and diagnostic tips. ### sync-engine Developer reference for the WCPOS sync engine introduced in v1.10.0: scopes, sync lanes, change detection, declared demand, coverage reporting, and the offline write queue. - [How the Sync Engine Works](/reference/sync-engine.md): Developer reference for the WCPOS sync engine introduced in v1.10.0: scopes, sync lanes, change detection, declared demand, coverage reporting, and the offline write queue. ### sync-performance How the WCPOS sync engine protects your server: bounded request ceilings, back-off under pressure, responsiveness guarantees, and the measured numbers behind them. - [Sync Performance and Server Politeness](/reference/sync-performance.md): How the WCPOS sync engine protects your server: bounded request ceilings, back-off under pressure, responsiveness guarantees, and the measured numbers behind them. ### wc-rest-api The WooCommerce REST API is like a set of standardised “channels” that allows store owners to connect their WooCommerce store to other applications and services. - [Understanding the WooCommerce REST API](/reference/wc-rest-api.md): The WooCommerce REST API is like a set of standardised “channels” that allows store owners to connect their WooCommerce store to other applications and services. ## Optional - [WCPOS Website](https://wcpos.com): Product website and downloads - [GitHub](https://github.com/wcpos): Source code and issue tracker - [Discord](https://wcpos.com/discord): Community support chat - [WordPress.org plugin](https://wordpress.org/plugins/woocommerce-pos/): Free version on the WordPress plugin directory - [WCPOS Pro](https://wcpos.com/pro): Pro features and licensing - [Compare WooCommerce POS systems](https://wcpos.com/compare): WCPOS compared with Oliver POS, WooCommerce's official POS, Square, Jovvie, Vitepos, YITH and FooSales: pricing, offline support, hardware, and when each is the better choice