Supplier user guide
This guide covers working with Tandem as a supplier, where your team manages the catalog, customers, pricing, and company settings.
Getting started
- Register to create your company and owner account.
- After sign-in, your workspace URL is
/app/{your-company-slug}(for example/app/acme-wholesale). - Use Company settings to update your company name, logo, and portal branding.
Staff members receive an email invitation and set their password at /app/accept-invite/{token} before they can sign in.
Dashboard
The dashboard shows an at-a-glance view of catalog health:
- Draft products waiting to be completed and published
- Low stock items that may need attention
- Pending invitations for staff and B2B customers
- Image storage usage against your plan quota
Catalog
Products
Go to Catalog → Products (/app/{slug}/products) to manage your range.
Each product has a SKU, name, description, category, product group, base price, stock quantity, VAT, and custom attributes. Products move through draft and published states — only published products appear in customer portals and APIs.
Before publishing, the system checks readiness: required fields, VAT, category, mandatory attributes, and more. Fix any issues shown on the product form, then publish when ready.
Categories
Catalog → Categories lets you build a hierarchical category tree. Customers and APIs see full path labels (for example Tools / Hand tools).
Attributes
Define attribute groups and attribute definitions under Company settings to capture structured data (text, numbers, selects, and more). Assign attribute values per product.
Product groups
Product groups link related products for merchandising on customer product detail pages.
Images
Add multiple images per product, set a primary image, and reorder them. Thumbnails are generated automatically. Storage counts against your plan quota.
For bulk onboarding, use CSV image import (map image URLs by SKU). For desktop or DAM workflows, see the Supplier image API.
Bulk import
Import products via CSV when launching or updating a large catalog. Combine with image import for faster onboarding.
Pricing and tax
Under Company settings:
- VAT rates — define tax rates and assign defaults
- Price lists — create lists with customer-specific pricing and adjustments
When you invite a B2B customer, assign them a price list so they see their contract prices in the portal and API.
Customers
Go to Customers → Customers to manage trading partners.
- Create a customer record with company details.
- Assign a price list.
- Invite a portal user — they receive an email to set a password and access
/customer.
Invited customers only see your published products at their prices.
Sales orders (optional)
If your subscription includes sales orders and you enable them under Company settings → Sales orders, you and your customers can manage orders:
- Customers → Sales orders in your workspace
- Customers see Ordering → Sales orders and Delivery addresses in their portal when enabled
You can allow orders without sufficient stock if that fits your business rules.
Staff
Company settings → Staff (/app/{slug}/users) is for inviting team members.
- Owner — full access including staff management and billing
- Staff — catalog and customer work; cannot manage other staff
Resend invitations from the staff list if someone has not accepted yet.
Billing
Manage your subscription under Company settings → Billing. Checkout and the Stripe customer portal handle plan changes and payment methods.
Activity log
Each product records changes to price, stock, status, VAT, and category — useful for support and internal audit.
Image sync API
For desktop tools syncing a local folder structure with the cloud, use the Supplier image API. Authenticate with supplier staff credentials, then list, upload, update, and delete images by SKU.
Quick reference
| Task | Where |
|---|---|
| Publish a product | Catalog → Products → open product → Publish |
| Invite a customer | Customers → Customers → Invite |
| Invite staff | Company settings → Staff → Invite |
| Change contract pricing | Company settings → Price lists, then assign to customer |
| Enable sales orders | Company settings → Sales orders |