# DB02002: Record Not Found

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

The requested record does not exist in the local database. The POS tried to access a product, customer, order, or other record that isn't stored locally.

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

* **Not yet synced** — Data hasn't been downloaded yet
* **Deleted on server** — Record was removed in WooCommerce
* **Sync not complete** — Initial sync is still running
* **Filter applied** — Record excluded by active filters

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

### 1. Wait for Sync[​](#1-wait-for-sync "Direct link to 1. Wait for Sync")

If recently started:

* Wait for initial sync to complete
* Check sync progress indicator
* The record should appear once synced

### 2. Refresh/Re-sync[​](#2-refreshre-sync "Direct link to 2. Refresh/Re-sync")

Trigger a data refresh:

* Use the refresh/sync button () - short press for sync
* **Long press** the sync button for Clear and Refresh option
* Pull latest data from server
* Wait for completion

### 3. Check WooCommerce[​](#3-check-woocommerce "Direct link to 3. Check WooCommerce")

Verify the record exists on the server:

* Log into WordPress Admin
* Check Products, Orders, or Customers
* Confirm the item still exists

### 4. Check Filters[​](#4-check-filters "Direct link to 4. Check Filters")

The record might be filtered out:

* Review active filters in the POS
* Check category filters
* Verify visibility settings

### 5. Clear and Re-sync[​](#5-clear-and-re-sync "Direct link to 5. Clear and Re-sync")

If sync seems stuck:

1. Clear local data
2. Login again
3. Complete a fresh sync

## Common Scenarios[​](#common-scenarios "Direct link to Common Scenarios")

* **Product not showing:** Check if it's published and visible
* **Customer not found:** May not have been synced yet
* **Order missing:** Could be outside the sync date range

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

* [DB02001](/error-codes/DB02001.md) — Duplicate Record
* [API04004](/error-codes/API04004.md) — Missing Response Data