> For the complete documentation index, see [llms.txt](https://docs.rishvi.co.uk/linnworks/llms.txt).
> Use it to discover all available pages before exploring further.
# HYPER Linnworks POS
Configure and operate HYPER Linnworks POS for synchronized products, inventory, warehouses, categories, pricing, shipping services, customers, payments, and point-of-sale orders between Linnworks and HYPER POS.
## Overview
The _HYPER Linnworks POS_ integration connects Linnworks with HYPER POS for retail and service-based sales operations.
The integration supports:
- Linnworks warehouse synchronization
- Product-category synchronization
- Individual inventory import by SKU
- Bulk inventory synchronization
- Warehouse-level inventory availability
- Pricelist management
- Shipping-service synchronization
- POS warehouse selection
- Customer and product selection
- Discounts and internal notes
- Payment processing
- Automatic Linnworks order creation
- Linnworks order-reference storage
- Scheduled inventory synchronization
Linnworks is the operational source for warehouse and inventory information. HYPER POS provides the interface used by cashiers and sales teams to process customer sales.
### Architecture at a glance
Provides warehouses, product categories, inventory quantities, prices,
shipping services, and operational order records.
Retrieves Linnworks data, updates HYPER POS records, sends validated POS
orders to Linnworks, and runs scheduled inventory processes.
Provides product selection, customer management, discounts, payments,
shipping selection, order validation, and receipt generation.
Once configured, the integration reduces manual POS setup, improves
warehouse-level inventory accuracy, and provides traceable Linnworks order
synchronization.
---
## Who Should Use HYPER POS
Process customer purchases, select products, apply discounts, accept
payments, and validate POS orders.
Monitor POS sessions, review sales activity, control cash handling, and
verify warehouse and product availability.
Synchronize warehouses, categories, products, quantities, and pricing from
Linnworks.
Configure system parameters, warehouse mappings, POS settings, automated
inventory processing, and Linnworks Mode.
---
## Key Features
Browse, search, scan, and add products to a POS order.
Process configured payment methods such as cash, card, and digital
payments.
Apply eligible discounts to individual products or the complete order.
Retrieve Linnworks inventory changes and update POS stock availability.
Generate printable or digital customer receipts using the configured POS
layout.
Link a sale to an existing customer or create a new customer.
Display and deduct stock using the Linnworks warehouse selected for the POS
configuration.
Send validated POS orders to Linnworks and store the returned Linnworks
order number.
---
## Installation Guide
### System Installation Overview
HYPER Linnworks POS can be installed and configured from the **Application
Store** within Linnworks.
During the first-time setup, HYPER prepares the required modules and system
dependencies, including:
- Point of Sale
- Dashboard
- Sales
- CRM
- Inventory
- Logistics and metrics
- User access
- Base system dependencies
The setup normally takes approximately **5–10 minutes**.
If HYPER Linnworks POS has already been installed centrally, open it from
**Apps → My applications** and continue from **Step 2 — Start Setup**.
### Before You Begin
Confirm that you have:
- Access to an authorized Linnworks account
- Permission to install and authorize applications
- Administrator credentials for HYPER Linnworks POS
- Access to the correct test or production environment
- A stable internet connection
- Permission to review and accept the application terms
- Contact details for the integration administrator
### Installation Steps
**Open HYPER Linnworks POS**
1. Sign in to Linnworks.
2. Open **Apps** from the main navigation menu.
3. Select **Application Store**.
4. Locate **HYPER Linnworks POS** or **Rishvi POS**.
5. Review the application details, requested permissions, and terms.
6. Click **Install**, **Authorize**, or the equivalent action.
7. After installation, open **Rishvi POS** from **My applications**.
Install the application only from an approved Linnworks account and
confirm that you are working in the correct test or production
environment.
**Start the system setup**
When the setup page opens:
1. Confirm that the page displays **Start Your Setup**.
2. Click **Start Setup**.
3. Keep the browser tab open while the setup runs.
4. Do not navigate away from the application.
The setup configures:
- POS
- Dashboard
- Sales
- CRM
- Inventory
- Logistics and metrics
- User access
- Base system dependencies
Do not refresh or close the page after starting the setup.
**Monitor the setup progress**
The setup page displays a progress bar while the required modules are
configured.
The process normally takes **5–10 minutes**, depending on the environment
and the modules being installed.
Wait until:
- The progress bar reaches **100%**
- A green confirmation message appears
- The page displays **Setup Complete! Please reload.**
Refresh the page only after the progress reaches 100% and the
setup-complete message appears.
**Reload and verify the dashboard**
After the setup-complete message appears:
1. Refresh the browser or use the available reload action.
2. Reopen **Rishvi POS** if required.
3. Confirm that the dashboard loads successfully.
4. Confirm that the **POS**, **Sales**, **CRM**, and **Inventory** menus are
available.
5. Check that no setup or loading error is displayed.
The installation is successful when the Rishvi POS dashboard loads and the
authorized user can access the required modules.
**Sign in when prompted**
If the login page appears after reloading:
1. Enter the authorized administrator email address.
2. Enter the account password.
3. Click **Log in**.
4. Confirm that the dashboard opens successfully.
Additional login options can include:
- **Choose a user**
- **Reset Password**
Contact the integration administrator if you do not have an authorized
account. Never share login credentials or API tokens through
documentation, screenshots, or support messages.
HYPER Linnworks POS is installed successfully when the dashboard loads and
the authorized user can access the POS and Inventory modules.
### Installation Verification
Before continuing with integration configuration, confirm the following:
| Check | Expected Result |
| ------------------ | ---------------------------------------------------- |
| Application access | Rishvi POS opens from **Apps → My applications** |
| Setup status | Setup reached **100%** without an error |
| Dashboard | The Rishvi POS dashboard loads after reloading |
| Module access | POS, Sales, CRM, and Inventory menus are visible |
| Authentication | The authorized user can sign in successfully |
| Environment | The correct test or production environment is active |
| Permissions | The user can access the required configuration areas |
Do not begin production configuration or process POS orders until every
installation check has completed successfully.
---
## Initial Configuration
After installation, complete the system and integration configuration required for HYPER Linnworks POS.
The recommended configuration process is:
1. Create the required system parameters.
2. Verify the Linnworks connection.
3. Synchronize warehouses.
4. Synchronize product categories.
5. Import inventory.
6. Configure pricelists.
7. Import shipping services.
8. Select the Linnworks warehouse.
9. Test a POS sale.
10. Verify the resulting order in Linnworks.
### Before You Begin
Confirm that you have:
- Administrator access to HYPER POS
- Access to technical system parameters
- An authorized Linnworks account
- The Linnworks customer or account identifier
- A secure Linnworks API token
- The integration-service URL
- Permission to synchronize warehouses, categories, inventory, and orders
- The required POS warehouse configuration
- The required payment methods
- The required pricelist and discount settings
---
## Configure System Parameters
System parameters are key-value settings used to control integration behavior without modifying the application source code.
Each parameter follows this format:
`Key = Value`
### Navigation Path
`Settings → Technical → Parameters → System Parameters`
### Required Parameters
| Parameter | Purpose | Example Value |
| --------------------- | ------------------------------------------ | ---------------------------------- |
| `rishvi_app` | Controls the enabled application mode | `CRM/POS` |
| `lw_customer_id` | Identifies the connected Linnworks account | `` |
| `lw_token` | Authorizes Linnworks API operations | `` |
| `rishvi_base_app_url` | Defines the integration-service URL | `` |
Use the exact parameter keys required by the application. Replace the example
values with the secure values supplied by an authorized integration
administrator.
### Configuration Steps
**Navigate to the system-parameter list**
1. Open **Settings**.
2. Open **Technical**.
3. Open **Parameters**.
4. Select **System Parameters**.
5. Confirm that you have permission to create and edit parameter records.
**Configure the application mode**
1. Locate or create the `rishvi_app` parameter.
2. Set the value to the application mode supplied by the administrator.
3. Save the record.
Example:
`rishvi_app = CRM/POS`
**Configure the Linnworks account identifier**
1. Locate or create the `lw_customer_id` parameter.
2. Enter the authorized Linnworks customer or account identifier.
3. Save the record.
Example:
`lw_customer_id = `
**Configure the Linnworks API token**
1. Locate or create the `lw_token` parameter.
2. Enter the secure Linnworks API token.
3. Save the record.
Example:
`lw_token = `
**Configure the integration-service URL**
1. Locate or create the `rishvi_base_app_url` parameter.
2. Enter the secure integration-service URL.
3. Save the record.
Example:
`rishvi_base_app_url = `
**Confirm the parameter values**
Review each required parameter and confirm that:
- The parameter key is spelled correctly
- The value belongs to the correct environment
- The Linnworks token is active
- The Linnworks account identifier is correct
- The integration-service URL is reachable
- Secret values are not exposed to unauthorized users
Contact the authorized integration administrator when a required parameter
value is unavailable.
---
## Inventory Operations
Inventory Operations provides tools for synchronizing warehouses, categories, products, quantities, and prices between Linnworks and HYPER POS.
The dashboard includes:
- Linnworks warehouse synchronization
- Linnworks product-category synchronization
- Inventory import by SKU
- Inventory-count comparison
- Bulk inventory synchronization
- On-hand quantity review
- Pricelist management
- Automated inventory synchronization
Import and update Linnworks warehouse records.
Import Linnworks categories and subcategories.
Retrieve and update one product using its Linnworks SKU.
Import products and quantities using controlled page ranges.
---
## Warehouse Synchronization
The **Linn Warehouse Details** function retrieves Linnworks stock locations and creates or updates the corresponding HYPER warehouse records.
### Synchronize Warehouses
Open the HYPER Inventory Operations dashboard.
Find the warehouse-synchronization section.
Click **Sync Now**.
The integration retrieves all configured Linnworks stock locations.
Missing HYPER warehouses are created and existing warehouse records are
updated.
Confirm that the Linnworks warehouse identifiers are stored correctly.
### When to Run Warehouse Synchronization
Run warehouse synchronization when:
- Adding a new Linnworks warehouse
- Updating an existing warehouse
- Correcting a warehouse mapping
- Preparing a new POS configuration
- Resolving a missing warehouse in POS
---
## Product-Category Synchronization
The **Linn Product Category Details** function imports Linnworks categories and subcategories.
### Synchronize Product Categories
Open the Product Import section.
Find **Linn Product Category Details**.
Click **Sync Now**.
The integration retrieves Linnworks categories and subcategories.
Linnworks categories are mapped to the corresponding HYPER product
categories.
Confirm that the required product groups are available in POS.
Synchronize product categories before performing a large product or inventory
import.
---
## Add Inventory by Linnworks SKU
The **Add Inventory by Linn SKU** function retrieves and updates one product using its Linnworks SKU.
### Steps
Enter the required SKU in the inventory input field.
Start the individual-product import.
The integration retrieves the matching Linnworks product and inventory
information.
The corresponding product and quantity records are created or updated.
Confirm the product, category, warehouse, price, and quantity information.
This function is useful for:
- Refreshing one product
- Correcting one SKU
- Testing a product mapping
- Updating one quantity without a complete bulk import
- Recovering a missing product
---
## Refresh Inventory
The **Refresh Inventory** function recalculates the high-level inventory totals displayed for HYPER and Linnworks.
It can display:
- Inventory records stored in HYPER
- Product-quantity records available in Linnworks
- Differences between the displayed totals
### Refresh Flow
Navigate to the inventory-count area.
Retrieve the current high-level totals.
Compare the displayed HYPER and Linnworks values.
Use individual-SKU or bulk synchronization when records are missing.
Inventory counts provide a high-level comparison. They do not perform a
complete product-by-product reconciliation.
---
## Bulk Inventory Synchronization
The **Sync My Inventory** or **Sync All Inventory** function imports Linnworks inventory using a selected page range.
### Page Selection
The interface uses:
- Start Page
- End Page
- Number of selected pages
- Estimated maximum number of products
Example:
`Pages 1–20 × 30 products per page = up to 600 products`
### Bulk Synchronization Flow
Enter the first Linnworks inventory page to retrieve.
Enter the final Linnworks inventory page to retrieve.
Confirm the selected page count and estimated product total.
Click **Sync My Inventory**.
The integration retrieves Linnworks products and quantities in controlled
batches.
Product and warehouse-quantity records are created or updated.
Check imported products, quantities, categories, prices, and failed records.
Use small page ranges during the first synchronization. Increase the range
only after reviewing the imported records.
---
## On-Hand Quantity
On-hand quantity represents the physical inventory currently available for a product in a warehouse.
The inventory list can display:
- Inventory location
- Product reference
- On-hand quantity
- Reserved quantity
- Unit of measure
- Quantity history
- Replenishment information
On-hand quantity supports:
- Product-availability review
- Warehouse-level stock monitoring
- Sales planning
- Replenishment decisions
- POS product availability
- Stock verification
Linnworks remains the operational source for inventory. HYPER POS quantities
depend on the latest successful synchronization.
---
## Pricelists
Pricelists control the selling prices used during POS order creation and customer billing.
Pricelists help ensure that:
- Linnworks prices are synchronized correctly
- HYPER and Linnworks use consistent selling prices
- Future POS orders use the correct price
- Customer-specific pricing can be applied
- Promotional prices can be maintained
- Multiple currencies can be supported
Authorized users can:
- Create new pricelists
- Configure pricing rules
- Define discounts
- Define markups
- Assign currencies
- Assign pricelists to customers
- Assign pricelists to customer groups
Configure and enable pricelists before processing POS orders that depend on
Linnworks or customer-specific pricing.
---
## Automated Inventory Synchronization
HYPER POS includes a scheduled inventory synchronization process.
The Automation Settings window shows:
- Whether automated synchronization is enabled
- The configured hourly frequency
- The next scheduled execution time
- The manual **Sync Now** action
- The recent-inventory synchronization period
The automated inventory process:
- Runs every hour
- Retrieves stock changes from the previous two days
- Retrieves recent quantity updates
- Updates HYPER inventory records
- Maintains recent inventory consistency
- Displays the next scheduled execution time
Use **Sync Now** when an immediate inventory update is required.
Manual synchronization is useful after:
- Stock corrections
- Warehouse transfers
- Product imports
- Purchase receipts
- Linnworks quantity changes
- A failed scheduled execution
Avoid starting an unnecessary manual synchronization while the scheduled
process is already running.
---
## Point of Sale Overview
A Point of Sale system is used to process retail or service-based sales transactions.
HYPER POS helps users:
- Select products
- Record customer purchases
- Process payments
- Apply discounts
- Update inventory
- Generate receipts
- Validate orders
- Link sales to customers
- Synchronize sales with Linnworks
---
## Core POS Features
Browse, search, scan, and add products to an order.
Process configured cash, card, or digital payment methods.
Apply eligible discounts to one product or the complete order.
Update warehouse inventory after a completed sale.
Produce printable or digital receipts for customers.
Confirm that products, payment, customer, and shipping details are complete.
Link a sale to an existing customer or create a new customer.
Synchronize supported sales and inventory information with Linnworks.
---
## Advanced POS Features
Allows multiple POS terminals or sessions to operate independently.
Tracks opening cash, cash movements, closing balance, and cash differences.
Adds products using a compatible barcode scanner.
Maintains previous POS orders for operational review.
Restricts discounts, order changes, session closing, and administrative
actions to authorized users.
Supports configured logos, contact information, terms, and barcode or QR
content.
Posts supported sales and payment information to configured accounting
journals.
Applies configured product and regional taxes during order calculation.
Summarizes sales, payment methods, and cash differences at session close.
---
## Linnworks POS Integration Dashboard
The POS Shipping Management dashboard provides the main actions used to import supporting Linnworks configuration into HYPER POS.
From this dashboard, authorized users can:
- Import or refresh POS shipping services
- Import Linnworks product categories
- Prepare shipping options for POS checkout
- Prepare product groups for the POS product interface
Retrieves shipping-service information from Linnworks.
Activates pricelist support for POS pricing.
Retrieves Linnworks product categories for POS product grouping.
Supports configured POS discount rules.
---
## Import Shipping Services
The **Import Shipping Services** function retrieves Linnworks shipping-service details through the integration API.
After starting the import, open the shipping-service list to review the imported records.
The imported list can display:
- Postal service name
- Service country
- Carrier or vendor
- Configured amount
- Active status
After import:
- Shipping services become available in HYPER POS
- Cashiers can select the applicable service during checkout
- Services can be displayed as selectable buttons
- The selected shipping service is included with the synchronized order
### Import Flow
Navigate to the Linnworks POS configuration dashboard.
Find the shipping-service import action.
Click **Import Shipping Services**.
The integration retrieves the configured Linnworks shipping services.
Confirm that the required services appear in the POS interface.
Reimport shipping services after a service is added, renamed, disabled, or
assigned to a different carrier in Linnworks.
---
## Enable Pricelists in POS
Enabling pricelists allows POS to use different selling prices according to configured pricing rules.
Pricelists can support:
- Customer-specific pricing
- Customer-group pricing
- Seasonal pricing
- Promotional pricing
- Multiple currencies
- Discounts
- Markups
Enable pricelists before processing sales that require anything other than the
default product price.
---
## Import Product Categories for POS
Product-category import retrieves Linnworks product groups and saves them as HYPER POS categories.
This helps:
- Organize products in the POS interface
- Improve product search and navigation
- Reduce manual category setup
- Maintain consistent category structures
- Prepare products for POS display
---
## POS Category Settings
To make products from all synchronized categories available in POS, review the Product and POS category settings.
Open the Point of Sale settings and locate **Product & POS categories**.
### Required Setting
Do not enable:
`Restrict Categories`
When category restriction is disabled:
- Products from all available POS categories can be displayed
- Synchronized Linnworks categories remain selectable
- Products are less likely to be hidden by POS category restrictions
- Newly synchronized categories do not require separate POS assignment
Enabling **Restrict Categories** can hide products that belong to categories
not explicitly assigned to the POS configuration.
---
## Configure the Linnworks Warehouse
Each POS configuration must use the appropriate Linnworks warehouse.
Open the required Point of Sale configuration and locate the **Linn Warehouse** field.
The selected warehouse controls:
- Where the POS order is created in Linnworks
- Which warehouse quantity is shown in POS
- Which warehouse stock is deducted
- Which warehouse is associated with the synchronized order
### Warehouse Selection
Open the required Point of Sale configuration.
Find the **Linn Warehouse** selection field.
Choose the Linnworks warehouse used by this POS.
Save the POS settings before opening a session.
Confirm that POS displays quantities from the selected warehouse.
### Example Behavior
When **Pre-Sales** is selected:
- POS orders are created against the Pre-Sales warehouse
- Stock is deducted from Pre-Sales
- POS displays Pre-Sales inventory availability
When **Main Warehouse** is selected:
- Orders are created against Main Warehouse
- Stock is deducted from Main Warehouse
- POS displays Main Warehouse inventory availability
Stock from other Linnworks warehouses is not automatically combined with the
warehouse selected for the POS session.
---
## POS Sales Flow
The POS sales workflow follows a defined sequence from session opening to Linnworks order verification.
### Complete Sales Process
Confirm that the correct Linnworks warehouse is selected in the POS
configuration.
Open a new POS session to begin processing sales.
Product availability is displayed using stock from the selected Linnworks
warehouse.
Select an existing customer or create a new customer.
Linking a customer supports order tracking and Linnworks synchronization.
Browse, search, or scan the required products and add them to the order.
Review the displayed price, category, and available stock.
Apply a configured order-level or product-level discount when required and
permitted.
Enter operational notes or instructions that need to accompany the order.
Select one of the shipping services imported from Linnworks.
Choose the payment method and confirm that the customer, products,
quantities, discounts, notes, shipping service, and payment details are
correct.
After validation, the order is sent automatically to Linnworks.
Linnworks returns an order number that is stored against the HYPER POS
order.
Use the Linnworks order number to locate the synchronized order and review
its customer, products, quantities, discounts, notes, shipping service, and
warehouse.
---
## Open a POS Session
Opening a POS session initializes the cashier interface and allows sales transactions to begin.
The POS session provides access to:
- Product categories
- Product search
- Product selection
- Customer selection
- Internal notes
- Shipping-service selection
- Quantity controls
- Price controls
- Payment processing
During the session:
- Product availability uses the selected warehouse
- Stock from other warehouses is not combined
- Cash and payment activity is tracked
- Validated orders are recorded
- Session totals can be reviewed at closing
Confirm the Linnworks warehouse before opening the session. Changing the
warehouse after transactions begin can create operational inconsistencies.
---
## Customer Selection
A customer can be selected before completing the POS order.
Click **Customer** to open the customer-selection window.
Search for the customer and select the correct record.
Customer selection helps:
- Link the sale to the correct customer
- Maintain purchase history
- Apply customer-specific pricelists
- Support customer-specific discounts
- Synchronize accurate customer information with Linnworks
- Improve order traceability
---
## Product Selection and Barcode Scanning
Products can be added to the cart by:
- Browsing categories
- Searching by name
- Searching by SKU
- Using a compatible barcode scanner
- Selecting products from the product grid
Before adding a product, review:
- Available warehouse stock
- Selling price
- Product category
- Unit of measure
- Tax
- Applicable pricelist
---
## Discounts
Discounts can be applied when the feature is enabled and the user has the required permission.
After adding products to the cart, use the available discount or price controls to apply the required adjustment.
Discounts can apply to:
- One product line
- Multiple product lines
- The complete POS order
After applying the discount, verify:
- Original unit price
- Discount percentage
- Discount amount
- Updated line total
- Updated order total
- User authorization
Review the final order total after applying a discount and before validating
payment.
---
## Internal Notes
Internal notes allow the cashier to include operational instructions with the order.
Click **Internal Note** to open the note-selection window.
Select or enter the required note and click **Apply**.
Notes can be used for:
- Delivery instructions
- Collection information
- Product-handling notes
- Customer requests
- Warehouse instructions
- Support information
Do not enter payment credentials or unnecessary sensitive customer
information in internal notes.
---
## Shipping-Service Selection
Shipping services imported from Linnworks are displayed as selectable options in POS.
Click **Shipping Service** to open the service-selection window.
Select the service that matches the customer’s delivery requirements and click **OK**.
The selected service can affect:
- Shipping cost
- Order total
- Linnworks postal service
- Fulfilment workflow
- Customer delivery expectations
The selected service is included when the order is sent to Linnworks.
Reimport shipping services after a service is added, renamed, or disabled in
Linnworks.
---
## Validate the POS Order
After reviewing the customer, products, quantities, discounts, notes, shipping service, and taxes, continue to the payment screen.
Select the required payment method and confirm that the remaining balance is zero.
Before validation, confirm:
- A valid customer is selected when required
- The correct products are in the cart
- Quantities are correct
- Prices are correct
- Discounts are correct
- Taxes are correct
- Internal notes are appropriate
- The shipping service is correct
- The payment method is correct
- The Linnworks warehouse is correct
Click **Validate** to complete the sale.
After validation:
- The POS sale is completed
- Inventory is updated
- The order is sent to Linnworks
- A Linnworks order number is returned
- The order number is stored in the backend POS order record
Validate the order only after confirming that payment and order totals are
correct.
---
## Linnworks Order Synchronization
After a POS order is validated, HYPER sends the completed order to Linnworks.
Open the HYPER order list to confirm that a Linnworks order number was returned.
The order list can display:
- HYPER order reference
- Linnworks order number
- Invoice reference
- Order date
- Point of Sale
- Receipt number
- Customer
- Cashier
- Total
- Payment status
The synchronized order can contain:
- Customer details
- Product lines
- Quantities
- Prices
- Discounts
- Taxes
- Internal notes
- Shipping service
- Selected Linnworks warehouse
- POS order reference
### Synchronization Result
When the request succeeds:
- Linnworks creates the order
- Linnworks returns an order number
- HYPER stores the Linnworks order number
- The order can be located and reviewed in Linnworks
A stored Linnworks order number confirms that HYPER received a Linnworks order
reference for the synchronized sale.
---
## Verify the Order in Linnworks
Use the stored Linnworks order number to locate the exact order in Linnworks.
### Verification Checklist
Confirm that Linnworks displays:
- The correct customer
- The correct delivery information
- The correct products
- The correct quantities
- The correct prices
- The correct discount
- The correct internal note
- The correct shipping service
- The correct warehouse
- The correct shipping cost
- The correct tax values
- The correct payment status
- The correct order total
A missing Linnworks order number can indicate that synchronization did not
complete successfully.
---
## Linnworks Mode
Linnworks Mode controls whether users can access the HYPER Linnworks POS application.
The toggle is available from the top-right user menu.
When Linnworks Mode is enabled:
- The application icon is hidden or disabled
- Normal users cannot open the application from the standard interface
- Access to the Linnworks POS interface is restricted
When Linnworks Mode is disabled:
- The application icon is visible
- Authorized users can access HYPER POS
- Normal POS operation is available
Confirm the required user-access state before changing Linnworks Mode.
---
## Warehouse-Level Inventory Behavior
The selected Linnworks warehouse is applied throughout the POS workflow.
| POS Operation | Warehouse Behavior |
| -------------------- | ---------------------------------------------------------- |
| Product availability | Displays inventory from the selected warehouse |
| Order submission | Creates the order against the selected warehouse |
| Inventory deduction | Reduces inventory from the selected warehouse |
| Inventory review | Uses quantities synchronized for the selected warehouse |
| Order verification | Displays the warehouse associated with the Linnworks order |
---
## Production-Readiness Features
Linnworks tokens, account identifiers, and integration URLs are stored in
controlled system parameters.
Hourly synchronization retrieves recent Linnworks inventory changes.
Individual-SKU imports and manual synchronization provide immediate
correction options.
Page ranges allow large inventory imports to be processed in manageable
batches.
POS inventory and orders are associated with the selected Linnworks
warehouse.
The returned Linnworks order number links each POS order to its operational
Linnworks record.
---
## Validation Errors and Common Causes
| Validation Error | Common Cause |
| ------------------------------------ | ----------------------------------------------------------------- |
| Linnworks connection failed | The customer ID, token, or service URL is missing or invalid |
| Warehouse not found | Linnworks warehouses have not been synchronized |
| Product category missing | Category synchronization has not completed |
| SKU not found | The entered SKU does not exist in Linnworks |
| Inventory was not updated | The selected page range or SKU did not match the required product |
| Product is hidden in POS | Restrict Categories is enabled or the POS category is unavailable |
| Price is incorrect | Pricelists are disabled or the pricing rule is incomplete |
| Shipping service is missing | Linnworks shipping services have not been imported |
| Warehouse inventory is incorrect | The wrong Linnworks warehouse is selected |
| Product is unavailable | The selected warehouse has no synchronized inventory |
| Discount is unavailable | Discounts are disabled or the user lacks permission |
| Order validation failed | Required customer, product, payment, or order data is incomplete |
| Linnworks order was not created | The Linnworks connection or order request failed |
| Linnworks order number is missing | Order synchronization did not complete successfully |
| Scheduled inventory sync did not run | The scheduled process or integration connection is unavailable |
| Application icon is missing | Linnworks Mode is enabled |
---
## Troubleshooting Guide
### Linnworks Connection Failed
**Symptom:** Warehouse, category, inventory, or order synchronization fails.
**Likely cause:** A required system parameter is missing, incorrect, or expired.
**Resolution:** Review `lw_customer_id`, `lw_token`, and the integration-service URL without exposing their values.
### Warehouse Was Not Imported
**Symptom:** A Linnworks warehouse is unavailable in HYPER POS.
**Likely cause:** Warehouse synchronization has not completed.
**Resolution:** Run **Sync Now** from Linn Warehouse Details.
### Product Category Is Missing
**Symptom:** An expected product category is unavailable.
**Likely cause:** Product-category synchronization has not completed.
**Resolution:** Run **Sync Now** from Linn Product Category Details.
### Product Is Not Visible in POS
**Symptom:** A synchronized product cannot be selected in the POS interface.
**Likely cause:** Restrict Categories is enabled, the category is unavailable, or the product is not configured for sale.
**Resolution:** Disable category restriction, synchronize the category, and review the product configuration.
### Individual-SKU Import Failed
**Symptom:** Add Inventory does not create or update the product.
**Likely cause:** The SKU is incorrect or does not exist in Linnworks.
**Resolution:** Confirm the exact Linnworks SKU and run the import again.
### Bulk Inventory Is Incomplete
**Symptom:** Only part of the Linnworks inventory appears in HYPER.
**Likely cause:** The selected page range did not include all products.
**Resolution:** Synchronize the missing pages using smaller controlled ranges.
### Inventory Totals Do Not Match
**Symptom:** Linnworks and HYPER show different high-level inventory counts.
**Likely cause:** The latest inventory changes have not been synchronized.
**Resolution:** Refresh the counts and run **Sync Now** when required.
### POS Displays the Wrong Warehouse Inventory
**Symptom:** Product availability does not match the expected warehouse.
**Likely cause:** The POS configuration uses a different Linnworks warehouse.
**Resolution:** Review the Linn Warehouse field and reopen the POS session after saving the correct warehouse.
### Pricelist Was Not Applied
**Symptom:** A product uses an unexpected selling price.
**Likely cause:** Pricelists are disabled or the applicable customer and product rule is incomplete.
**Resolution:** Enable pricelists and review the pricing configuration.
### Shipping Service Is Unavailable
**Symptom:** The required Linnworks shipping service is not shown in POS.
**Likely cause:** Shipping services have not been imported or the service was changed in Linnworks.
**Resolution:** Run Import Shipping Services again.
### Discount Cannot Be Applied
**Symptom:** The discount action is unavailable.
**Likely cause:** Discounts are not enabled or the cashier lacks permission.
**Resolution:** Review the POS feature settings and user access rights.
### Order Cannot Be Validated
**Symptom:** POS does not complete the sale.
**Likely cause:** Required customer, product, payment, or order information is incomplete.
**Resolution:** Review all cart lines, payment values, customer details, and required POS fields.
### Linnworks Order Was Not Created
**Symptom:** The POS order is completed but cannot be found in Linnworks.
**Likely cause:** The order synchronization request failed.
**Resolution:** Review the Linnworks connection, selected warehouse, order details, and available integration logs.
### Linnworks Order Number Is Missing
**Symptom:** The POS backend order does not display a Linnworks reference.
**Likely cause:** Linnworks did not accept the order or the response was not stored.
**Resolution:** Review the synchronization result before creating another order.
### Automatic Inventory Sync Did Not Run
**Symptom:** Recent Linnworks quantities do not appear in HYPER POS.
**Likely cause:** The scheduled process failed or has not reached its next execution time.
**Resolution:** Review the next execution time and use **Sync Now** when an immediate update is required.
### Application Icon Is Missing
**Symptom:** Users cannot locate HYPER POS.
**Likely cause:** Linnworks Mode is enabled.
**Resolution:** Review the Linnworks Mode toggle in the top-right user menu.
---
## Best Practices
Import Linnworks warehouses before configuring the POS warehouse.
Synchronize categories before running a large inventory import.
Test bulk inventory imports with small page ranges before increasing the
volume.
Confirm the selected Linnworks warehouse before opening a POS session.
Review pricing rules whenever Linnworks or customer pricing changes.
Synchronize shipping services after they are changed in Linnworks.
Use the stored Linnworks order number when checking synchronized sales.
Store tokens, account identifiers, and service URLs only in secure system
parameters.
---
## Privacy and Data Protection
HYPER POS can process customer, contact, product, inventory, payment, order, warehouse, note, and shipping information.
To protect this information:
- Restrict POS and configuration access to authorized users
- Use secure Linnworks API tokens
- Store integration secrets in system parameters
- Do not expose customer details in screenshots
- Do not enter payment credentials in internal notes
- Avoid including personal data in public support messages
- Mask sensitive values in operational logs
- Review user access when roles change
- Use only the data required for order processing
- Follow the configured data-retention policy
---
## FAQ
**What does HYPER Linnworks POS synchronize?**
It supports Linnworks warehouses, product categories, inventory quantities, pricelists, shipping services, and POS orders.
**Which system is the inventory source?**
Linnworks is the operational source for inventory and warehouse stock.
**How are Linnworks warehouses imported?**
Open Linn Warehouse Details and click **Sync Now**.
**How are product categories imported?**
Open Linn Product Category Details and click **Sync Now**.
**Can one product be synchronized without a bulk import?**
Yes. Enter its Linnworks SKU and use **Add Inventory**.
**How does bulk inventory synchronization work?**
Select a start page and end page, review the estimated product count, and click **Sync My Inventory**.
**How often does automated inventory synchronization run?**
The documented scheduled process runs every hour and retrieves changes from the previous two days.
**Can inventory be synchronized immediately?**
Yes. Use the **Sync Now** option in Automation Settings.
**What is on-hand quantity?**
It is the physical quantity currently available for a product in a warehouse.
**Why does POS show stock from only one warehouse?**
POS displays stock from the Linnworks warehouse selected in the POS configuration. Stock from other warehouses is not combined automatically.
**What does enabling pricelists do?**
It allows POS to apply configured product, customer, customer-group, currency, discount, or promotional pricing rules.
**How are shipping services added to POS?**
Use the Import Shipping Services action to retrieve them from Linnworks.
**Why are some products hidden in POS?**
Restrict Categories may be enabled, the product category may be missing, or the product may not be configured for sale.
**Can discounts be applied in POS?**
Yes, when discounts are enabled and the user has the required permission.
**What information is sent to Linnworks after a sale?**
The synchronized order can include the customer, products, quantities, prices, discounts, taxes, notes, shipping service, warehouse, and POS reference.
**How can I verify that a POS order reached Linnworks?**
Use the Linnworks order number stored against the backend POS order.
**What happens when the Linnworks order number is missing?**
The synchronization may not have completed successfully. Review the connection and available integration logs before retrying.
**What is Linnworks Mode?**
It is an administrator-controlled toggle that hides or displays the HYPER POS application icon.
---
## Legal Information
- **Privacy Policy:** [https://rishvi.co.uk/privacy-policy/](https://rishvi.co.uk/privacy-policy/)
- **Terms and Conditions:** [https://rishvi.co.uk/terms-conditions/](https://rishvi.co.uk/terms-conditions/)
Please review these pages to understand how data is handled and the terms governing the use of this application.
---
## Summary
The _HYPER Linnworks POS_ integration provides a synchronized retail interface for products, inventory, warehouses, pricing, customers, shipping services, payments, and sales orders.
Linnworks warehouses, categories, products, and quantities can be imported
into HYPER POS.
POS product availability and inventory deduction use the selected Linnworks
warehouse.
Cashiers can select customers and products, apply discounts, add notes,
select shipping, and process payments.
Validated POS orders are sent to Linnworks automatically.
The returned Linnworks order number links the POS order to its corresponding
Linnworks record.
Hourly inventory synchronization keeps recent warehouse quantities updated.
The recommended setup sequence is:
`Install HYPER POS → Configure System Parameters → Synchronize Warehouses → Synchronize Categories → Import Inventory → Configure Pricelists → Import Shipping Services → Select the POS Warehouse → Test a POS Sale`
The POS order flow is:
`Open POS Session → Select Customer → Add Products → Apply Discount → Add Note → Select Shipping → Process Payment → Validate Order → Send to Linnworks → Store Linnworks Order Number`
The inventory flow is:
`Read Linnworks Inventory → Synchronize Warehouse Quantities → Display Selected-Warehouse Availability in POS → Deduct Inventory After Sale`