Screens & actions
A tour of every screen in the app and what each button does — including the exact confirmation message you'll see.
Dashboard
Your home screen. It shows how many products are synced, pending and failed, and lets you kick off the main background jobs:
| Button | What it does | You'll see |
|---|---|---|
| Sync orders | Queues new store orders to go to your ERP. | Order sync triggered |
| Sync inventory | Queues a stock refresh from your ERP. | Inventory sync triggered |
| Sync customers | Queues customer records to your ERP. | Customer sync triggered |
If you haven't connected an ERP yet, these report "ERP not configured" — set it up in Settings first.
Products
The main workspace. It lists your products with their sync status, a search box, and status filters (All / Synced / Pending / Failed). The top of the page has the catalog-wide actions:
| Button | What it does | Notes / message |
|---|---|---|
| Pull from ERP | Fetches your whole catalog, groups it, and pushes new & changed products to your store. Shows a live progress bar. | New items arrive as drafts. Only one can run at a time — otherwise "A sync is already running". |
| Sync to Shopify | Re-sends products already pulled that are still waiting, without re-fetching from your ERP. | "Sync to Shopify queued — pushing pending products (no re-fetch)" |
| Refresh stock | Updates inventory for the whole catalog from your mapped warehouse. | "Refreshed N SKU(s) …". Needs a location mapping. |
| Pull images from store | Copies images from your Shopify products into Matat, catalog-wide, as a background job. | "Store image pull queued for the whole catalog" |
You can also set a "modified since" date to pull only recent changes (ERPs that support it). An invalid date reports "Invalid date: … Use YYYY-MM-DD".
Product detail
Click any product to open its detail page. It shows the hero image and thumbnails, price, SKU, variant options, the full variant table, sync state, platform IDs, and links to view it in your storefront or Shopify admin. Its actions act on just this one product:
| Action | What it does | Message |
|---|---|---|
| Sync to Shopify / Re-sync | Pushes this product to your store immediately. | Success or "<sku>: <reason>" on failure. |
| Re-pull from ERP | Fetches this product fresh from your ERP and updates its local data. | "<sku> was not found locally" if it isn't in Matat yet. |
| Refresh stock | Updates just this product's inventory. | "Asked N SKU(s) from location … " |
| Pull images from store | Copies this product's store images into Matat. | "Pulled from store for <sku>: N product image(s)…", or "No store product matched <sku>'s SKU(s)". |
| Re-queue for catalog sync | Puts the product back in line for the next full sync. | "<sku> re-queued — next catalog sync will push it" |
Orders
Lists recent store orders and their ERP sync state. Actions:
| Action | What it does | Message |
|---|---|---|
| Sync order to ERP | Sends a single order to your ERP (creates the invoice/sales doc). | "Order synced to ERP". If it's already sent: "Already synced — ERP doc exists". |
| Retry failed | Re-attempts all orders that previously failed to sync. | "Retry done: N synced, M still failing" |
| Push refund | Sends a refund/credit to your ERP for a refunded order. | "Refund pushed — credit doc …". The original order must already be synced. |
An order that's mid-sync reports "Order is not in a syncable state (already synced or syncing)".
Inventory
A focused view for stock. The main action refreshes quantities from your ERP for the mapped location and pushes them to your store — "Refreshed N SKU(s) from location …". If no mapping exists yet, you'll be pointed to set one up.
Customers
Lets you push customer records to your ERP, individually or in bulk — "Customer synced to ERP" / "Customers synced to ERP". Availability depends on whether your ERP supports customer records (some create customers automatically as part of the order, with no separate step).
Variant attributes
Controls how your ERP's option values (like colors and sizes) are presented in your store. The screen discovers the color/size values in your catalog, shows how each currently appears on your storefront (its swatch), and lets you adjust the mapping — for example, which base color a custom shade belongs to. Changes are saved to Matat with Save; a separate action applies them to your store's swatches. See Variants & swatches for the full picture.
Editing and saving mappings only updates Matat's records — your storefront doesn't change until you choose to apply them.
Onboarding
The first-run, guided setup. It walks you through connecting your ERP, discovering and mapping locations, and choosing sync preferences — the same settings described in the Settings reference, just in a step-by-step flow. You must finish onboarding before the other screens unlock.