Settings
Manage accounts, users, notifications, product categories, and SKU sync.
The Settings area controls how the app connects to ShipHero and who can use it. Some screens are admin-only.
The sidebar lists up to five screens: Notifications, Accounts, Product Categories, SKU Sync, and Users. Non-admins see fewer of them.
Account means ShipHero connection
An Account is one connection to ShipHero. The database calls it a brand. Each account holds its own ShipHero tokens, users, and data.
Who can see what
The app checks access at three layers: the middleware, a guard on the page, and each API call.
- Every signed-in user can open Notifications, Product Categories, and SKU Sync.
- Admins can also open Accounts and Users. An admin holds the admin role on at least one account.
- Super admins can create new ShipHero connections. A server-only list names them.
Notifications
This screen sets your own email preferences. A master switch turns all emails on or off.
Below it, you choose which emails you want:
- Draft PO created — when someone creates a draft purchase order.
- Inbound PO issue — when an inbound order has a problem.
- Shipping cost alert — when a shipment runs over its threshold.
New users start with every email off. The sub-settings stay greyed out until you turn the master switch on.
Accounts (admin)
This screen manages your ShipHero connections. It lists the accounts you administer with their connection status and active user count.
Connection status
Each account shows one of three states:
- Not Connected (red) — a ShipHero token is missing.
- No Credentials (amber) — tokens exist, but no saved login.
- Connected (green) — tokens and login both exist.
What you can do
Open an account to manage it:
- Rename the connection.
- Manage credentials — save the ShipHero login and tokens.
- Regenerate tokens — refresh the ShipHero tokens.
- Connect a user — add someone to this account.
- Revoke or re-enable a user's access.
- Delete the connection — remove the account and all its data.
Delete removes everything
Deleting a connection cascades. It removes the account's orders, shipments, SKUs, purchase orders, and user links. It cannot be undone.
Only super admins see the Create New Connection button. It opens a wizard that connects ShipHero, invites users, and starts the account.
Users (admin)
This screen manages the people across the accounts you administer. It lists each user with their status, accounts, and join date.
What you can do
- Invite or connect users — add one or more emails to an account.
- Ban or unban a user — block or restore their sign-in.
- View a user — see their full profile and per-account access.
How invites resolve
When you add emails, the app checks each one and picks the right action:
- A brand-new email gets an invitation email.
- A banned user gets unbanned and added.
- A user with revoked access gets restored.
- An existing user joins the account directly.
You review these actions before you confirm them.
Product Categories
This screen manages the categories you assign to products. Categories belong to one account.
Pick an account, then add, rename, or delete its categories. Deleting a category marks its products as uncategorized.
SKU Sync
New SKUs from ShipHero do not enter the system on their own. They land in a review queue first. A person classifies each one before it becomes real.
The screen has two tabs: Queue and Sync history.
How new SKUs arrive
The app pulls new SKUs from ShipHero two ways:
- A daily cron runs at 07:00 UTC.
- A Sync Now button runs one account on demand.
Each run records how many SKUs it found, queued, and skipped. A SKU that already exists gets skipped.
The queue
The queue lists each pending SKU with a suggested type — Base, Case, or Product. You filter by status, account, or search.
For each SKU you can:
- Review it and classify it.
- Reset a classified SKU to reclassify it.
- Dismiss a SKU that should not exist.
Classify a SKU
The review dialog offers several choices:
- Create a new Base, Case, or Product SKU.
- Link to an existing SKU of any of those three types.
- Dismiss the SKU entirely.
When you create a Product SKU, every component must map to an existing Base SKU. The app tries to match them for you.
Sync history
The history tab lists past runs with their status and counts. Open a run to see each SKU it processed.
SKU sync talks to ShipHero directly
SKU sync reads from ShipHero's own API. Only account creation and user invites route through N8N.