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:

ButtonWhat it doesYou'll see
Sync ordersQueues new store orders to go to your ERP.Order sync triggered
Sync inventoryQueues a stock refresh from your ERP.Inventory sync triggered
Sync customersQueues 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:

ButtonWhat it doesNotes / message
Pull from ERPFetches 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 ShopifyRe-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 stockUpdates inventory for the whole catalog from your mapped warehouse."Refreshed N SKU(s) …". Needs a location mapping.
Pull images from storeCopies 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:

ActionWhat it doesMessage
Sync to Shopify / Re-syncPushes this product to your store immediately.Success or "<sku>: <reason>" on failure.
Re-pull from ERPFetches this product fresh from your ERP and updates its local data."<sku> was not found locally" if it isn't in Matat yet.
Refresh stockUpdates just this product's inventory."Asked N SKU(s) from location … "
Pull images from storeCopies 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 syncPuts 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:

ActionWhat it doesMessage
Sync order to ERPSends 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 failedRe-attempts all orders that previously failed to sync."Retry done: N synced, M still failing"
Push refundSends 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.

✓ Safe to explore

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.