# SY02002: Service Unavailable

## What This Means[​](#what-this-means "Direct link to What This Means")

A required service or component is not available. The POS depends on various services to function, and one of them is currently inaccessible.

## Common Causes[​](#common-causes "Direct link to Common Causes")

* **Background service stopped** — A required service isn't running
* **System resource issue** — Not enough resources to start the service
* **Dependency failure** — A service this depends on failed
* **Startup issue** — Service failed to start properly
* **Server error** — The WooCommerce server returned a 5xx error

## Server Error Mapping[​](#server-error-mapping "Direct link to Server Error Mapping")

This error code is triggered when the server returns:

| Server Code | Source                                               |
| ----------- | ---------------------------------------------------- |
| HTTP 5xx    | Any server error response (500, 502, 503, 504, etc.) |

## How to Fix[​](#how-to-fix "Direct link to How to Fix")

### 1. Restart the Application[​](#1-restart-the-application "Direct link to 1. Restart the Application")

Close and reopen the POS:

1. Fully close the application
2. Wait a few seconds
3. Start it again

### 2. Restart Your Device[​](#2-restart-your-device "Direct link to 2. Restart Your Device")

A full restart often resolves service issues:

1. Save any important work
2. Restart your computer
3. Try the POS again

### 3. Check System Resources[​](#3-check-system-resources "Direct link to 3. Check System Resources")

Ensure system resources are available:

* Close unnecessary applications
* Check memory usage
* Check disk space

### 4. Update the Application[​](#4-update-the-application "Direct link to 4. Update the Application")

Ensure you're on the latest version:

* Check for available updates
* Install any pending updates
* Restart after updating

### 5. Reinstall if Necessary[​](#5-reinstall-if-necessary "Direct link to 5. Reinstall if Necessary")

Check for unsaved work first

Clearing local data or reinstalling the app deletes anything on this device that hasn't reached your store — including sales taken while offline, open carts, and edits that didn't save. Before you clear anything, open **Store health → Database** and check nothing is listed as held or as never having reached your server, then **Store health → Logs** for **0 stuck records** and **0 changes waiting to send**; then finish or note every open cart. If your WCPOS has no Store health page, update WCPOS first, then check. If anything is listed or waiting, or you can't check, don't clear — ask your store owner or contact support.

Only if your store's site opens normally in a browser, the steps above didn't help, and only after the check above:

1. Uninstall the application
2. Restart your device
3. Download the latest version
4. Install fresh

## Browser-Specific (Web Version)[​](#browser-specific-web-version "Direct link to Browser-Specific (Web Version)")

For the web version:

* Ensure JavaScript is enabled
* Check that required browser features aren't blocked
* Try a different browser
* Disable browser extensions that might interfere

## When to Contact Support[​](#when-to-contact-support "Direct link to When to Contact Support")

If this error persists:

* Note when it occurs
* Check if specific actions trigger it
* Report with details for investigation

## Related Errors[​](#related-errors "Direct link to Related Errors")

* [SY02001](/error-codes/SY02001.md) — Invalid Configuration
* [API01008](/error-codes/API01008.md) — Website Unavailable
