# 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, split and external card payments, runs a cash-drawer register and prints receipts; WCPOS Pro adds integrated card readers, refunds, stock editing, order history, the customer-facing display, and multiple registers and stores. - [WCPOS Documentation](/index.md) ## getting-started ### connect Connect the WCPOS app to your WooCommerce store, sign in with WordPress, add more cashiers, and fix a sign-in that won't finish. - [Connect to Your Store](/getting-started/connect.md): Connect the WCPOS app to your WooCommerce store, sign in with WordPress, add more cashiers, and fix a sign-in that won't finish. ### free-vs-pro What the free WCPOS plugin does, what WCPOS Pro adds, and what a Pro feature looks like when you're on the free plugin. - [Free vs Pro](/getting-started/free-vs-pro.md): What the free WCPOS plugin does, what WCPOS Pro adds, and what a Pro feature looks like when you're on the free plugin. ### installation What your WordPress site needs for WCPOS 2.0, how to install the plugin, where to open the POS, how to check what's installed, and which computers, tablets and phones run the apps. - [Install WCPOS](/getting-started/installation.md): What your WordPress site needs for WCPOS 2.0, how to install the plugin, where to open the POS, how to check what's installed, and which computers, tablets and phones run the apps. ### 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 Keep selling when the connection drops: what the POS shows, what still works, how sales wait to send, and what needs your store. - [Offline Mode](/getting-started/offline.md): Keep selling when the connection drops: what the POS shows, what still works, how sales wait to send, and what needs your store. ### previous-versions Go back to an earlier version of WCPOS or WCPOS Pro: turn off auto-updates, download the version you need, and upload it over the one you have, without deleting anything. - [Install a Previous Version](/getting-started/previous-versions.md): Go back to an earlier version of WCPOS or WCPOS Pro: turn off auto-updates, download the version you need, and upload it over the one you have, without deleting anything. ### pro-license Buy a WCPOS Pro licence, install the Pro plugin, activate your licence key in WP Admin, and check that the POS now runs Pro. - [Your WCPOS Pro License](/getting-started/pro-license.md): Buy a WCPOS Pro licence, install the Pro plugin, activate your licence key in WP Admin, and check that the POS now runs Pro. ### roadmap What comes after WCPOS 2.0: fiscal compliance, control over what each cashier can do, and your other WooCommerce plugins at the till. How to ask for the feature your store needs. - [Roadmap](/getting-started/roadmap.md): What comes after WCPOS 2.0: fiscal compliance, control over what each cashier can do, and your other WooCommerce plugins at the till. How to ask for the feature your store needs. ### upgrading-to-2 Check whether your store can take WCPOS 2.0 today, what to do before you click Update, how to check every till made it, what changes on day one, and how to roll back. - [Upgrading to WCPOS 2.0](/getting-started/upgrading-to-2.md): Check whether your store can take WCPOS 2.0 today, what to do before you click Update, how to check every till made it, what changes on day one, and how to roll back. ### whats-new WCPOS 2.0 brings a new register, a checkout that belongs to the POS with split payments and card readers at the till, registers and a cash drawer in the free plugin, a customer-facing display, and receipts built for fiscal rules. - [What's new in WCPOS 2.0](/getting-started/whats-new.md): WCPOS 2.0 brings a new register, a checkout that belongs to the POS with split payments and card readers at the till, registers and a cash drawer in the free plugin, a customer-facing display, and receipts built for fiscal rules. ## pos Find your way around the POS: the menu, the bar at the top, the products and the cart, the phone layout, keyboard shortcuts and what to do when a warning appears. - [The POS Screen](/pos.md): Find your way around the POS: the menu, the bar at the top, the products and the cart, the phone layout, keyboard shortcuts and what to do when a warning appears. ### cart The cart holds the order you're ringing up: who it's for, what's on it, extra charges and discounts, the totals, and how the cart looks. - [The Cart](/pos/cart.md): The cart holds the order you're ringing up: who it's for, what's on it, extra charges and discounts, the totals, and how the cart looks. - [Cart Discounts](/pos/cart/discounts.md): Take money off at the till: a quick discount key or a new price on one item, a discount or a coupon on the whole order, and a new coupon made on the spot. - [Cart Line Items](/pos/cart/line-items.md): Change a cart line's quantity or price, split it, edit or remove it, add custom fields, and set how the cart sorts its lines. - [Open Orders](/pos/cart/open-orders.md): Keep several sales going at once: switch between open orders, start a new one, hand an order to another cashier, register or store, print a bill and void what you no longer need. - [Order Actions](/pos/cart/order-actions.md): Order details at the till: add a note for the customer, hand the order to another cashier, change its currency, sync it to your store, print it or void it. ### checkout Ring up a sale from start to finish: build the cart, take the payment, give change, hand over the receipt and start the next sale. - [Make a Sale](/pos/checkout.md): Ring up a sale from start to finish: build the cart, take the payment, give change, hand over the receipt and start the next sale. - [Cancelling a Payment](/pos/checkout/cancelling-a-payment.md): Undo the payments taken so far on an order that isn't finished, or just one of them, and see what has to go back to the customer. - [The Legacy Tab](/pos/checkout/legacy-tab.md): Take payment on your store's own payment page inside the POS, for payment methods that have no tile on the Payments tab. - [The Payment Screen](/pos/checkout/payment-methods.md): Choose how the customer pays at checkout: which methods give change, what the pay button does for each, and what changes when you're offline. - [Split Payments](/pos/checkout/split-payments.md): Pay one order with more than one payment: part in cash and the rest another way, shared evenly, a set amount first, a percent, or item by item. - [Taking a Payment](/pos/checkout/taking-a-payment.md): Take cash and give change, record a card from your own terminal, take part of the balance, and send the amount to a card reader. - [Tips](/pos/checkout/tips.md): How a tip the customer adds on a card reader lands on the order, which readers ask for one, and how to pay cash tips out of the drawer. - [Checkout Troubleshooting](/pos/checkout/troubleshooting.md): What to do when a payment method isn't available, the store doesn't answer, a payment or order is refused, or a gateway's payment page looks wrong. ### product-panel Find a product at the till: search, filters, tiles and rows, Browse by, barcode scans and variations. - [Product Panel](/pos/product-panel.md): Find a product at the till: search, filters, tiles and rows, Browse by, barcode scans and variations. - [Barcode Scanning](/pos/product-panel/barcode-scanning.md): Scan products into the cart with a scanner or the camera, read what each scan message means, and set up scan sounds. - [Display Settings](/pos/product-panel/display-settings.md): Set up the Product Panel on this device: grid or table, tile size, Browse by, sort order, variations, tile fields, columns and the filter bar. - [Custom Fields](/pos/product-panel/meta-data-keys.md): Copy a product's extra fields onto the cart line with Meta Data Keys, and add, change or remove a custom field on one line. - [Search & Filtering](/pos/product-panel/search-filtering.md): Find a product by name, SKU or barcode, narrow the list with the filter bar, and reset it with Clear all. - [Variable Products](/pos/product-panel/variations.md): Pick the size, colour or other option of a variable product: open it in place, choose from a popover or an expanded row, or scan the option's own barcode. ### reconciliation Close the day at the till: check the drawer, count it, file the numbered closure, match the card terminal and sign out. - [End-of-Day Reconciliation](/pos/reconciliation.md): Close the day at the till: check the drawer, count it, file the numbered closure, match the card terminal and sign out. ### refunds Give a customer their money back from the POS: open the order, choose what to refund, pick where the money goes and confirm. - [Refunds at the Till](/pos/refunds.md): Give a customer their money back from the POS: open the order, choose what to refund, pick where the money goes and confirm. ### register Start the day with a float, see what the drawer should hold, and move cash in and out of it. - [Open the Register](/pos/register.md): Start the day with a float, see what the drawer should hold, and move cash in and out of it. ## products The Products screen: find, sort and filter your catalogue, edit stock and prices in the list, edit a product or variation in its dialog, and choose the columns. - [Products Management](/products.md): The Products screen: find, sort and filter your catalogue, edit stock and prices in the list, edit a product or variation in its dialog, and choose the columns. ### pos-only-products Choose which products sell at the till, online, or both: switch on POS visibility, set it per product, in bulk or per variation, and see what the POS and your website show. - [POS Only Products](/products/pos-only-products.md): Choose which products sell at the till, online, or both: switch on POS visibility, set it per product, in bulk or per variation, and see what the POS and your website show. ### sync How products reach each till: the boot screen, the first download on a new device, keeping up with changes in your store, and refreshing the product list. - [Download & Sync](/products/sync.md): How products reach each till: the boot screen, the first download on a new device, keeping up with changes in your store, and refreshing the product list. ## orders Find past sales in WCPOS, open an order to reprint its receipt, refund, re-open, sync or delete it, and settle sales that need attention. - [Orders](/orders.md): Find past sales in WCPOS, open an order to reprint its receipt, refund, re-open, sync or delete it, and settle sales that need attention. ### refunds Refund an order from WCPOS in full or in part: the refund form line by line, where the money goes, what happens if a refund fails, and how refunds show on the order. - [Refund Rules](/orders/refunds.md): Refund an order from WCPOS in full or in part: the refund form line by line, where the money goes, what happens if a refund fails, and how refunds show on the order. ## customers Find, add, edit and delete your store's customers from the Customers screen in WCPOS. - [Customers](/customers.md): Find, add, edit and delete your store's customers from the Customers screen in WCPOS. ## coupons Find, make, change and delete your store's WooCommerce coupons from the Coupons screen in WCPOS Pro. - [Coupons](/coupons.md): Find, make, change and delete your store's WooCommerce coupons from the Coupons screen in WCPOS Pro. ### applying-coupons Put one of your store's coupons on a sale: find it, apply it, remove it, and what to do when the till refuses it. - [Applying Coupons](/coupons/applying-coupons.md): Put one of your store's coupons on a sale: find it, apply it, remove it, and what to do when the till refuses it. ## stores What a WCPOS Pro store is, what each store sets for itself, how cashiers pick and switch stores, and how orders, reports, prices and stock follow the store. - [Stores](/stores.md): What a WCPOS Pro store is, what each store sets for itself, how cashiers pick and switch stores, and how orders, reports, prices and stock follow the store. ### registers-and-devices What a store, a register and a device are in WCPOS, how a device picks and switches them, what several devices on one register see, and which setups need WCPOS Pro. - [Stores, Registers and Devices](/stores/registers-and-devices.md): What a store, a register and a device are in WCPOS, how a device picks and switches them, what several devices on one register see, and which setups need WCPOS Pro. ### setup Create a store in WCPOS Pro, add its registers and cash rules, choose who can use it, and see what cashiers get at sign-in. - [Setting Up Stores](/stores/setup.md): Create a store in WCPOS Pro, add its registers and cash rules, choose who can use it, and see what cashiers get at sign-in. ## reports Read a day's or a month's sales in WCPOS: the total and how it compares, payments, products, cashiers, taxes and refunds, then print or export any of them. - [Reports](/reports.md): Read a day's or a month's sales in WCPOS: the total and how it compares, payments, products, cashiers, taxes and refunds, then print or export any of them. ### reconciliation Balance the day in WCPOS: set the close rules, run the day at the till, then check, recount and export the numbered closures in Reports, and track down a variance. - [Register Closures](/reports/reconciliation.md): Balance the day in WCPOS: set the close rules, run the day at the till, then check, recount and export the numbered closures in Reports, and track down a variance. ## payment The ways your store takes payment at the till: Cash and Card in every store, card readers and other gateways with WCPOS Pro, cash rounding, why a tile can't be used, and what to do when a payment gets stuck. - [Payment Methods](/payment.md): The ways your store takes payment at the till: Cash and Card in every store, card readers and other gateways with WCPOS Pro, cash rounding, why a tile can't be used, and what to do when a payment gets stuck. ### gateways The WCPOS payment gateways: card terminals, phone payments and invoices. Where each one shows at checkout, how to add one to your store, and what to do when it doesn't show. - [Payment Gateways](/payment/gateways.md): The WCPOS payment gateways: card terminals, phone payments and invoices. Where each one shows at checkout, how to add one to your store, and what to do when it doesn't show. - [Email Invoice Gateway](/payment/gateways/email-invoice.md): Send the customer an invoice by email instead of taking payment at the till, then follow it up from the Orders screen: send it again, cancel it, or take payment in the store. - [Mercado Pago Terminal Gateway](/payment/gateways/mercadopago-terminal.md): Take card payments on a Mercado Pago Point Smart terminal from the POS checkout, and set up the Mercado Pago Terminal extension in WP Admin. - [Mollie Terminal Gateway](/payment/gateways/mollie-terminal.md): Take card payments on a Mollie terminal from the POS: send a sale to the terminal, cancel, refund, show an iDEAL or Bancontact QR code, and set it up. - [PayArc Terminal Gateway](/payment/gateways/payarc-terminal.md): Take card payments on a PayArc PAX terminal from the WCPOS checkout, refund them, and set the gateway up - [PayPal Reader (Zettle) Gateway](/payment/gateways/paypal-reader.md): Take card payments on a PayPal Reader (Zettle) from the POS checkout, and set up the PayPal Reader extension in WP Admin. - [Square Terminal Gateway](/payment/gateways/square-terminal.md): Take card payments on a Square Terminal from the POS checkout, and set up the Square Terminal extension in WP Admin. - [Stripe Terminal Gateway](/payment/gateways/stripe-terminal.md): Take card payments on a Stripe reader at the till: set up the extension, connect a smart reader or a Bluetooth reader, and take the payment. - [SumUp Terminal Gateway](/payment/gateways/sumup-terminal.md): Take card payments on a SumUp reader at the till: set up the extension, pair a Solo over the cloud or connect a Bluetooth reader in the app, and take the payment. - [Vipps MobilePay Gateway](/payment/gateways/vipps-mobilepay.md): Take a Vipps or MobilePay payment at the till: the customer scans a QR code or approves a request sent to their phone. - [Web Checkout Gateway](/payment/gateways/web-checkout.md): Let the customer pay for a POS order on your online store's payment page with the payment methods your web store offers, then press Process Payment for the receipt. - [Windcave Terminal Gateway](/payment/gateways/windcave-terminal.md): Take card payments on a Windcave terminal from the POS checkout, and set up the Windcave Terminal extension (HIT) in WP Admin. ## receipts Choose the receipt WCPOS prints: add a template from the gallery, make it the default, send it to the right printer, and see where each part of the receipt comes from. - [Receipt Templates](/receipts.md): Choose the receipt WCPOS prints: add a template from the gallery, make it the default, send it to the right printer, and see where each part of the receipt comes from. ### at-checkout What the paid screen tells you after a sale, how to print, email or download the receipt, and how to open a receipt again later. - [Receipts and the Paid Screen](/receipts/at-checkout.md): What the paid screen tells you after a sale, how to print, email or download the receipt, and how to open a receipt again later. ### cloud-printing Send receipts to a printer that isn't connected to the till, and print orders automatically: Star CloudPRNT, Epson Server Direct Print, Star Online and PrintNode. - [Cloud Printing](/receipts/cloud-printing.md): Send receipts to a printer that isn't connected to the till, and print orders automatically: Star CloudPRNT, Epson Server Direct Print, Star Online and PrintNode. ### customise Change how your WCPOS receipt looks: pick a ready-made template, ask AI to tweak one, or edit it by hand, then choose which ones cashiers can print. - [Customise Your Receipt](/receipts/customise.md): Change how your WCPOS receipt looks: pick a ready-made template, ask AI to tweak one, or edit it by hand, then choose which ones cashiers can print. ### html-templates Write and edit HTML receipt templates with Mustache placeholders, check them on a real order, and fix the common mistakes. - [HTML Templates](/receipts/html-templates.md): Write and edit HTML receipt templates with Mustache placeholders, check them on a real order, and fix the common mistakes. ### receipt-data Every field a receipt template can print, from the store name to the totals, with copy-ready snippets for HTML and thermal templates. - [Receipt Data Reference](/receipts/receipt-data.md): Every field a receipt template can print, from the store name to the totals, with copy-ready snippets for HTML and thermal templates. ### storefront Let online customers download their own receipt or invoice from My Account, made from your WCPOS receipt template. - [Receipts on Your Online Store](/receipts/storefront.md): Let online customers download their own receipt or invoice from My Account, made from your WCPOS receipt template. ### thermal-templates Write XML receipt templates for ESC/POS and Star thermal printers: every element, column layout, the preview, and what changes on paper. - [Thermal Printer Templates](/receipts/thermal-templates.md): Write XML receipt templates for ESC/POS and Star thermal printers: every element, column layout, the preview, and what changes on paper. ## 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. ### card-readers Choose a smart reader or connect a Bluetooth reader in Settings → Card readers, and fix a reader the till can't find. Tap to Pay comes in an app update. - [Card Readers](/hardware/card-readers.md): Choose a smart reader or connect a Bluetooth reader in Settings → Card readers, and fix a reader the till can't find. Tap to Pay comes in an app update. ### customer-display Pair a second screen with a till in Settings → Customer Display so the customer sees the cart and total, choose what it shows for each store, and fix a display that can't connect. - [Customer Display](/hardware/customer-display.md): Pair a second screen with a till in Settings → Customer Display so the customer sees the cart and total, choose what it shows for each store, and fix a display that can't connect. ### printers Add a receipt printer in WCPOS, change its settings, test it, and choose which printer each template prints to. - [Receipt Printers](/hardware/printers.md): Add a receipt printer in WCPOS, change its settings, test it, and choose which printer each template prints to. - [Printer permissions on Android](/hardware/printers/android-permissions.md): Allow Nearby devices so WCPOS on an Android phone or tablet can find your Bluetooth printer, and what to check when a Wi-Fi printer still isn't found. - [Pairing a Bluetooth receipt printer](/hardware/printers/bluetooth-pairing.md): Your Bluetooth printer isn't on the list when you add it, or its test page doesn't print: where each app looks, Classic versus Low Energy, and pairing on Android. - [Printing from the browser: permissions and certificates](/hardware/printers/browser-permissions.md): Chrome's local network permission, mixed content and the printer's certificate — the three things that stop a browser reaching a printer. - [Connect a Cash Drawer](/hardware/printers/cash-drawer.md): Plug the cash drawer into the receipt printer, turn on Auto-open cash drawer, and test it. What opens the drawer, and what to check when it stays shut. - [Let the app find printers on your iPad or iPhone](/hardware/printers/ios-local-network.md): On an iPad or iPhone, a refused 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): The receipt printer prints everything but the store logo, and only from a browser. The logo's address is the cause; here is how to check it and fix it. - [Connect a network printer by its address](/hardware/printers/network-address.md): Why a network printer isn't found, or stops working after weeks: another network, guest Wi-Fi, or an address that moved. Read the address, fix it, and add the printer by its address. - [Receipts in Chinese, Thai, Arabic or Cyrillic](/hardware/printers/non-latin-receipts.md): Question marks, boxes or the wrong letters on a printed receipt mean the printer is using the wrong character table. Set the receipt language, or print the receipt as an image. - [Epson printed once and then stopped: restart it first](/hardware/printers/printed-once-then-stopped.md): An Epson that is holding a job it won't print refuses every other job too. Switching it off and on clears it in under a minute. - [Getting the receipt width right](/hardware/printers/receipt-width.md): Read the test page's ruler, pick 32, 42, 48 or 64 characters per line, and fix receipts that wrap, stop short of the edge or cut the logo off. - [Epson Secure Printing: what it blocks and how to turn it off](/hardware/printers/secure-printing.md): New Epson printers sold in the EU and UK ship with Secure Printing on. When the app can print with it on, when it can't, 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 Server Direct Print is on, an Epson turns away every job the POS sends while its own web page and self-test still work. Turn it off, or print through Cloud Print. - [Printer Setup Wizard](/hardware/printers/setup-wizard.md): Add a receipt printer in the app, print the test page, and answer a few questions to fix it if nothing comes out. - [Supported receipt printers](/hardware/printers/supported-printers.md): Which receipt printers are tested, which are expected to work and which are not supported yet, what the Vendor setting does, and how to report your printer. - [USB printer permissions on Linux](/hardware/printers/usb-linux.md): On Linux the desktop app needs your permission to use a USB receipt printer. One udev rule gives it, and the printer then prints. - [USB receipt printers on Windows](/hardware/printers/usb-windows.md): On Windows the desktop app prints to a USB receipt printer through Windows. If the app can't find it, install the printer in Windows first, with the Generic / Text Only driver if it has no driver of its own. ### scanners Plug in or pair a barcode scanner, check it in Barcode Scanning, test a scan, and connect it directly when keyboard mode isn't enough. - [Barcode Scanners](/hardware/scanners.md): Plug in or pair a barcode scanner, check it in Barcode Scanning, test a scan, and connect it directly when keyboard mode isn't enough. - [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 Open Settings in the POS, find its seven pages, and know which settings stay on this device and which the store owner sets in WordPress for every till. - [Where Settings Live](/settings.md): Open Settings in the POS, find its seven pages, and know which settings stay on this device and which the store owner sets in WordPress for every till. ### store Open Settings in the POS and find the right page: General, Tax, Printing, Card readers, Customer Display, Barcode Scanning and Theme. - [Open Settings in the POS](/settings/store.md): Open Settings in the POS and find the right page: General, Tax, Printing, Card readers, Customer Display, Barcode Scanning and Theme. - [Scanner Settings](/settings/store/barcode.md): Set how this device tells a scan from typing, pick a scan sound theme and volume, connect a scanner, and test a scan in Settings, Barcode Scanning. - [Store Defaults on This Device](/settings/store/general.md): Set the store name, language, default customer and money format the POS uses on this device, and restore the values from your WooCommerce store. - [Keyboard Shortcuts](/settings/store/hotkeys.md): Ring up a sale from the keyboard: Alt shortcuts for search, checkout, carts, discounts and voids, and the list that shows them all. - [Tax Settings](/settings/store/tax.md): What each row on the POS Tax settings page does, which values come from WooCommerce, and how to check the tax rates on this device. - [Theme](/settings/store/theme.md): Change how the POS looks on this device: ten themes, the Scale of buttons and text, and the icons and fonts it draws. ### wp-admin Find every WCPOS setting in WP Admin → POS → Settings: the General, Checkout, Cloud Print, Access, Sessions and Extensions screens, the Tools and Account pages, store details, Force SSL, and what the receipt font warning means. - [Settings in the WordPress Admin](/settings/wp-admin.md): Find every WCPOS setting in WP Admin → POS → Settings: the General, Checkout, Cloud Print, Access, Sessions and Extensions screens, the Tools and Account pages, store details, Force SSL, and what the receipt font warning means. - [Access: What Each Role Can Do](/settings/wp-admin/access.md): Choose what each WordPress role can do in the POS: the Access screen's tasks, the Cashier defaults, till permissions, the no-permission hints and Restore defaults. - [Checkout Settings](/settings/wp-admin/checkout.md): Choose which payment methods the till offers and in what order, set the order status each one gives a sale, stop the POS selling stock you don't have, and pick which emails POS orders send. - [Customer Tax IDs](/settings/wp-admin/customer-tax-ids.md): Add a customer's VAT number, ABN, CPF or other tax ID in the POS, print it on their receipts, and choose which WordPress field it is saved in. - [Email Notifications](/settings/wp-admin/email-notifications.md): Choose which WooCommerce emails go out for POS sales: to the admin, to the customer and to the cashier who made the sale. - [General Settings](/settings/wp-admin/general.md): The General screen in WP Admin: store details, the register, POS-only products, decimal quantities, the barcode field, the default customer, customer receipts, privacy and HTTPS. - [Register Settings](/settings/wp-admin/registers.md): Turn on opening and closing the register, set the opening float, the manager approval limit and the closing time. The free plugin has one register; more registers come with WCPOS Pro. - [Sessions](/settings/wp-admin/sessions.md): See who is signed in to the POS and on which devices, and sign a lost device or a departed cashier out from WP Admin. - [Store Tax IDs](/settings/wp-admin/store-tax-ids.md): Add the VAT, ABN, GSTIN, EIN or company-registry numbers that WCPOS prints on POS receipts and invoices, for the whole site or, with Pro, for each store. ## integrations Which WooCommerce plugins WCPOS works with, what WCPOS does for each one, and what you need to do. - [Integrations](/integrations.md): Which WooCommerce plugins WCPOS works with, what WCPOS does for each one, and what you need to do. ### woocommerce-tax Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how to set it up, what to expect at the till, and how POS orders get their rates. - [WooCommerce Tax](/integrations/woocommerce-tax.md): Use WooCommerce Tax automated taxes (TaxJar) with WCPOS: how to set it up, what to expect at the till, and how POS orders get their rates. ## extensions Add card terminals, multilingual catalogs, store credit and inventory locations to WCPOS. Install, update and turn off extensions from WP Admin, and list your own. - [Extensions](/extensions.md): Add card terminals, multilingual catalogs, store credit and inventory locations to WCPOS. Install, update and turn off extensions from WP Admin, and list your own. ### atum Give each WCPOS Pro store the stock, prices and SKUs of its own ATUM Multi-Inventory location. - [WCPOS ATUM Integration](/extensions/atum.md): Give each WCPOS Pro store the stock, prices and SKUs of its own ATUM Multi-Inventory location. ### polylang Show each product once in the POS, in one Polylang language, and pick that language per store with WCPOS Pro. - [WCPOS Polylang](/extensions/polylang.md): Show each product once in the POS, in one Polylang language, and pick that language per store with WCPOS Pro. ### storeapps-smart-coupons Keep StoreApps Smart Coupons store-credit balances right for POS orders, with the balance left on the receipt and a note on the order. - [WCPOS StoreApps Smart Coupons](/extensions/storeapps-smart-coupons.md): Keep StoreApps Smart Coupons store-credit balances right for POS orders, with the balance left on the receipt and a note on the order. ### wp-multilang Show the POS only the products sold in one WP Multilang language, chosen per store with WCPOS Pro. - [WCPOS WP Multilang](/extensions/wp-multilang.md): Show the POS only the products sold in one WP Multilang language, chosen per store with WCPOS Pro. ### wpml Show each product once in the POS, in one WPML language, instead of once per translation. - [WCPOS WPML](/extensions/wpml.md): Show each product once in the POS, in one WPML language, instead of once per translation. ## support Get help with WCPOS: ask in Discord from the POS, copy your debug info from Store health, and know when to email support. - [Support](/support.md): Get help with WCPOS: ask in Discord from the POS, copy your debug info from Store health, and know when to email support. ### logs Read the activity log on your till, find an error and its code, send the details to support, and check your store's own log in WP Admin. - [Logs](/support/logs.md): Read the activity log on your till, find an error and its code, send the details to support, and check your store's own log in WP Admin. ### notifications The bell in the POS: plugin updates, licence notices and news from WCPOS, how to read them, and how to clear the red number. - [Notifications](/support/notifications.md): The bell in the POS: plugin updates, licence notices and news from WCPOS, how to read them, and how to clear the red number. ### performance Find out why the POS is slow: read Store health first, then fix a slow checkout, slow updates or a struggling server. - [Performance](/support/performance.md): Find out why the POS is slow: read Store health first, then fix a slow checkout, slow updates or a struggling server. - [Checkout Performance](/support/performance/checkout.md): Find out why checkout is slow: where the till waits for your store, how to measure it, and what to change on your website and the Legacy tab's payment page. - [Order Storage (HPOS)](/support/performance/order-storage.md): Fix slow checkout in WCPOS on a large store: check which order storage WooCommerce uses and switch from legacy storage to HPOS with WooCommerce's own tool. - [Server Performance](/support/performance/server.md): See how your WordPress server is coping in Store health, what the POS does when it struggles, and what to change on your hosting. ### store-health Check what is on this till, what has not reached your store yet, how hard the POS is working your server, and the activity log. - [Store Health](/support/store-health.md): Check what is on this till, what has not reached your store yet, how hard the POS is working your server, and the activity log. ### translations Fix a word in the POS, the plugin or these docs in your language: see it on screen, find it on GitHub, and open a pull request. - [Contributing Translations](/support/translations.md): Fix a word in the POS, the plugin or these docs in your language: see it on screen, find it on GitHub, and open a pull request. ### troubleshooting - [Clear All Local Data](/support/troubleshooting/clear-local-data.md): Delete everything the POS stores on this device and download it again from your store: what to try first, how to check for unsent sales, and what happens after. - [Cloudflare](/support/troubleshooting/cloudflare.md): Stop Cloudflare's security checks from blocking the WCPOS app's connection to your store. - ["There has been a critical error on this website"](/support/troubleshooting/critical-error.md): What WordPress's critical error means at the till, where the POS shows it, and how to find the PHP error behind it. - [Plugin Conflicts](/support/troubleshooting/plugin-conflicts.md): Find the WordPress plugin that is breaking the POS, and fix the plugins known to clash with WCPOS. - [Response Error: an Empty or Broken Reply from Your Store](/support/troubleshooting/response-error.md): What to do when your store answers the POS with an empty reply, an error page or stray text instead of data, including the old "Cannot read properties of undefined (reading 'data')" message. - [Your Store and the POS Disagree on Totals](/support/troubleshooting/totals-disagree.md): What it means when the POS says your store changed an order's totals, how to bring the POS back in line with your store, and what to send support. ## error-codes Reference guide for every WCPOS error code, grouped by domain, with what each one means for your data and how to troubleshoot it. - [Error Codes](/error-codes.md): Reference guide for every WCPOS error code, grouped by domain, with what each one means for your data and how to troubleshoot it. ### 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. ### AUTH341 This store reports the same identity as a store already saved on this device. - [AUTH341: Store identity clash](/error-codes/AUTH341.md): This store reports the same identity as a store already saved on this device. ### 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. ### CLIENT161 This browser tab does not currently run the register, so it did not send a new payment request. - [CLIENT161: This tab does not run the register](/error-codes/CLIENT161.md): This browser tab does not currently run the register, so it did not send a new payment request. ### 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. ### DISPLAY101 The customer display could not build the cart snapshot and shows the idle screen until the next change. - [DISPLAY101: Customer display snapshot failed](/error-codes/DISPLAY101.md): The customer display could not build the cart snapshot and shows the idle screen until the next change. ### 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. ### PAYMENT111 The store recorded this payment, but the till could not save its own copy. - [PAYMENT111: Payment recorded, till copy not saved](/error-codes/PAYMENT111.md): The store recorded this payment, but the till could not save its own copy. ### PAYMENT113 The store sent or cancelled the invoice, but this till could not save its copy of the order. - [PAYMENT113: Invoice sent, but this till's copy did not save](/error-codes/PAYMENT113.md): The store sent or cancelled the invoice, but this till could not save its copy of the order. ### PAYMENT121 The card was charged, but the order did not finish. - [PAYMENT121: Card charged, order not finished](/error-codes/PAYMENT121.md): The card was charged, but the order did not finish. ### 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. ### PAYMENT211 The terminal did not take this payment. - [PAYMENT211: Terminal refused the payment](/error-codes/PAYMENT211.md): The terminal did not take this payment. ### PAYMENT212 The gateway did not accept this payment. - [PAYMENT212: Gateway refused the payment](/error-codes/PAYMENT212.md): The gateway did not accept this payment. ### PAYMENT221 A payment could not be voided, so that money is still held. - [PAYMENT221: Void refused](/error-codes/PAYMENT221.md): A payment could not be voided, so that money is still held. ### 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. ### PAYMENT501 The order had already been paid online, so the payment taken at the till is an additional one. - [PAYMENT501: Order already paid online](/error-codes/PAYMENT501.md): The order had already been paid online, so the payment taken at the till is an additional one. ### PAYMENT511 More was taken at the till than the order still owed. - [PAYMENT511: More taken than the order owed](/error-codes/PAYMENT511.md): More was taken at the till than the order still owed. ### 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. ### REGISTER101 Your store refused a paid in, paid out or no sale that the till has already recorded. - [REGISTER101: Cash movement refused](/error-codes/REGISTER101.md): Your store refused a paid in, paid out or no sale that the till has already recorded. ### REGISTER111 Your store would not reverse a cash movement, so the original one still counts. - [REGISTER111: Cash movement reversal refused](/error-codes/REGISTER111.md): Your store would not reverse a cash movement, so the original one still counts. ### REGISTER201 Your store refused to open this register session, so nothing is being counted against it. - [REGISTER201: Register could not be opened](/error-codes/REGISTER201.md): Your store refused to open this register session, so nothing is being counted against it. ### REGISTER211 Your store refused this register's count, so the session is still open there. - [REGISTER211: Register count refused](/error-codes/REGISTER211.md): Your store refused this register's count, so the session is still open there. ### REGISTER212 The drawer carry did not complete on this device. The store was not switched. - [REGISTER212: Drawer carry failed](/error-codes/REGISTER212.md): The drawer carry did not complete on this device. The store was not switched. ### REGISTER221 Another device already had this register open, so this till joined that session instead of starting its own. - [REGISTER221: Register already open on another device](/error-codes/REGISTER221.md): Another device already had this register open, so this till joined that session instead of starting its own. ### REGISTER301 Your store would not accept the manager approval for this count, so the register is still open. - [REGISTER301: Manager approval refused](/error-codes/REGISTER301.md): Your store would not accept the manager approval for this count, so the register is still open. ### 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. ### SYNC203 Your store no longer has this order, so this device settled its own copy. - [SYNC203: Record gone on store](/error-codes/SYNC203.md): Your store no longer has this order, so this device settled its own copy. ### 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 How WCPOS is built: the plugin on your WordPress site, the POS app on each till, the database the till sells from, how the two stay in step, and how checkout records payments. - [Architecture](/reference/architecture.md): How WCPOS is built: the plugin on your WordPress site, the POS app on each till, the database the till sells from, how the two stay in step, and how checkout records payments. ### declaring-pos-fields For gateway developers: two filters let the POS draw your gateway's checkout fields on the tender pane with its own controls, then run your gateway's process_payment() with what the cashier enters. - [Declaring Fields for the Tender Pane](/reference/declaring-pos-fields.md): For gateway developers: two filters let the POS draw your gateway's checkout fields on the tender pane with its own controls, then run your gateway's process_payment() with what the cashier enters. ### fiscal-compliance Where WCPOS stands on fiscal till laws country by country (France NF525, Spain VeriFactu, Norway, Chile, EU OSS), what 2.0 already records, and what 2.1 adds. - [Fiscal Compliance & Certification](/reference/fiscal-compliance.md): Where WCPOS stands on fiscal till laws country by country (France NF525, Spain VeriFactu, Norway, Chile, EU OSS), what 2.0 already records, and what 2.1 adds. ### gateway-template Build your own POS-only payment gateway for WCPOS from the gateway template: one PHP file, a setup script and automatic GitHub releases. - [Gateway Template](/reference/gateway-template.md): Build your own POS-only payment gateway for WCPOS from the gateway template: one PHP file, a setup script and automatic GitHub releases. ### pos-discounts Developer reference for how WCPOS records a price changed at the till and an Add Discount line on the WooCommerce order, how both interact with coupons, and the filter and receipt fields that expose them. - [POS Discounts](/reference/pos-discounts.md): Developer reference for how WCPOS records a price changed at the till and an Add Discount line on the WooCommerce order, how both interact with coupons, and the filter and receipt fields that expose them. ### role-endpoint-access Developer reference: which WCPOS REST endpoints the administrator, shop_manager and cashier roles can reach, how a refused request is answered, and how to tell a role problem from a sign-in problem. - [Role Endpoint Access](/reference/role-endpoint-access.md): Developer reference: which WCPOS REST endpoints the administrator, shop_manager and cashier roles can reach, how a refused request is answered, and how to tell a role problem from a sign-in problem. ### search Which fields each search box in WCPOS looks at, how the words you type are matched, phone numbers, and the wcpos_search_fields filter for a store's own fields. - [What Search Matches](/reference/search.md): Which fields each search box in WCPOS looks at, how the words you type are matched, phone numbers, and the wcpos_search_fields filter for a store's own fields. ### sync-engine Developer reference for the WCPOS 2.x sync engine: one database per store and cashier, background lanes, the change check, coverage, the write queue, one live browser tab and local storage. - [How the Sync Engine Works](/reference/sync-engine.md): Developer reference for the WCPOS 2.x sync engine: one database per store and cashier, background lanes, the change check, coverage, the write queue, one live browser tab and local storage. ### sync-performance The numbers behind Store health's Performance tab: what each sync setting costs your server, how the POS backs off when your server struggles, and how the till stays responsive. - [Sync Performance: How the POS Protects Your Server](/reference/sync-performance.md): The numbers behind Store health's Performance tab: what each sync setting costs your server, how the POS backs off when your server struggles, and how the till stays responsive. ### wc-rest-api How WCPOS reads your store through the WooCommerce REST API, how to see the data the POS holds on the JSON tab, and why plugins that change prices or products on the fly don't reach the till. - [The WooCommerce REST API](/reference/wc-rest-api.md): How WCPOS reads your store through the WooCommerce REST API, how to see the data the POS holds on the JSON tab, and why plugins that change prices or products on the fly don't reach the till. ## 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