The Customers screen holds the businesses you ship goods to. In SolaStock, a customer is used by fulfillment: you pick it on sales orders and sales returns, its name is stamped on shipped serial numbers, and recalls use it to show who received affected stock.
SolaStock customers are fulfillment contacts only. They hold no balances, invoices or payments. Billing happens in SolaCount (see How it connects).
Who uses it: sales coordinators and warehouse managers who create sales orders, and anyone who records customer returns.
Where to find it
| Screen | How to open it | URL |
|---|---|---|
| Customer list | Sidebar Sales / Fulfillment → Customers | /inventory/customers |
| New customer | New customer (top-right of the list) | /inventory/customers/new |
| Customer detail | Click a customer code in the list | /inventory/customers/{id} |
| Edit customer | Edit (top-right of the detail page) | /inventory/customers/{id}/edit |
The Sales / Fulfillment group is shown when:
- your organization's plan includes sales fulfillment. Without it, actions are refused with "This SolaStock feature is not available for the current plan or entitlement state."
- your role has View sales orders & fulfillment.
Creating and editing customers uses the sales order permission, Create / edit / confirm / cancel sales orders. Without it, New customer and Edit are greyed out. Hover them to see "You do not have permission for this action."
Screen tour
The customer list
The page title is Customers.
| Area | What you see |
|---|---|
| Header, right | New customer (primary button). |
| Toolbar | Search box "Search customers by name or code…". The list filters as you type and matches part of the name or the code. |
| Table | One row per customer, sorted by name. The list shows up to 50 customers; use the search box to find others. |
| Column | Meaning |
|---|---|
| Code | Your short reference for the customer. Click it to open the customer. |
| Name | The customer's name. |
| The contact email, or — if none. | |
| Status | Active or Inactive. |
There are no row menus, bulk actions or export on this screen.
Empty and error states
| You see | Meaning |
|---|---|
| No customers — "Add customers for sales orders, returns, and recall impact." | No customers yet, or none match your search. |
| Customers could not be loaded — "Try loading the customer list again." with Try again | The list failed to load. Click Try again. |
| Sample data badge next to the title | No organization is selected, so example rows are shown. Select your organization. |
The customer detail page
The heading shows the customer name with an Active or Inactive badge, and Edit on the right. The panel below lists Code, Email, Phone, Address, Tax number, Currency, Payment terms and Notes (— when empty).
If the customer cannot be opened you see Customer unavailable — "The customer could not be found or loaded for this organization."
Add a customer
-
Go to Sales / Fulfillment → Customers and click New customer.
-
Fill in the form:
Field Required Rules / defaults Notes Code Yes Up to 50 characters. Must be unique in your organization. A short reference such as CUS-GULFSTAR. Shown first in pickers ("CUS-GULFSTAR · Gulf Star Supermarkets LLC").Name Yes Up to 191 characters. Copied to sales orders and returns as the customer name. Email No Must be a valid email address. Up to 191 characters. Shown in the list. Phone No Up to 50 characters. Address No Up to 500 characters. For reference. It is not copied to shipments automatically; you type the ship-to address on the shipment. Tax number No Up to 100 characters. The customer's TRN. Currency No Free text, up to 10 characters. For example AED. For reference only; the order currency is chosen on the sales order.Payment terms No Free text, up to 100 characters. For example "30 days". For reference only. Status — Active is ticked by default. Untick to make the customer inactive. Notes No Internal notes. -
Click Create customer. You see "Customer created." and the customer's detail page opens.
To leave without saving, click Cancel.
If saving fails
| Message | Cause | Fix |
|---|---|---|
| "Customer code must be unique." | Another customer already uses this code. | Choose a different code. |
| The field is highlighted (for example the email) | The value breaks a rule in the table above. | Correct the field and save again. |
| "The customer could not be saved." | Any other failure. | Check your connection and try again. |
| Banner "Select an organization to create or update records." | No organization is selected. | Select your organization first. |
Edit a customer
- Open the customer and click Edit (top-right).
- Change any field.
- Click Save changes. You see "Customer updated."
If the customer cannot be loaded for editing you see Customer could not be loaded — "Try loading the customer again before editing it." with Try again.
Changing a customer's name does not rename existing sales orders or returns. Each document keeps the name it was saved with.
Deactivate a customer
There is no delete. To stop using a customer:
- Open the customer and click Edit.
- Untick Active under Status.
- Click Save changes.
Inactive customers are no longer offered in the Customer picker on sales orders and returns. Existing orders, shipments and returns keep showing the customer. Tick Active again to bring the customer back.
Statuses
| Status | What it allows |
|---|---|
| Active | Offered in the Customer picker on new sales orders and returns. |
| Inactive | Kept for history. Not offered in pickers. You can still open and edit it. |
Permissions
Customers are shared across the organization. They are not limited by warehouse, so everyone who can open the screen sees every customer.
| Role | See customers | Add / edit customers |
|---|---|---|
| Organization Owner | Yes | Yes |
| SolaStock Administrator | Yes | Yes |
| Inventory Manager (scoped) | Yes | No |
| Warehouse Manager (scoped) | Yes | No |
| Warehouse Operator (scoped) | Yes | No |
| Inventory Viewer (scoped) | Yes | No |
| Custom role | With View sales orders & fulfillment | With Create / edit / confirm / cancel sales orders |
Custom roles are set up in Settings → Custom Roles and assigned in Admin → Team access. See Team access.
Worked examples
Example 1: add a new customer (everyday)
Sara Khan, sales coordinator at Al Noor Trading LLC, receives a first order from a new supermarket.
- Sales / Fulfillment → Customers → New customer.
- Code
CUS-GULFSTAR, Name "Gulf Star Supermarkets LLC", Emailorders@gulfstar.ae, Phone+971 4 555 0142, Address "Warehouse 7, Al Quoz Industrial 3, Dubai", Tax number100234567800003, CurrencyAED, Payment terms "30 days". Active stays ticked. - Create customer → "Customer created."
The list now shows CUS-GULFSTAR · Gulf Star Supermarkets LLC · orders@gulfstar.ae · Active, and the customer appears in the Customer picker on New sales order.
Example 2: a customer through the whole fulfillment cycle
- Sara creates sales order
SO-000031for CUS-GULFSTAR · Gulf Star Supermarkets LLC: 40 cartons of Water 500ml x24 and 2 Barcode Scanner BS-200 (serial-tracked) from Dubai Main. The order's Customer shows "Gulf Star Supermarkets LLC". See Sales Orders. - On the shipment she types the ship-to address from the customer card ("Warehouse 7, Al Quoz Industrial 3, Dubai"), sets Warranty months to 24, and posts it on 6 October 2026.
- The two scanners' serial numbers (
BS200-0091,BS200-0092) now show Owner "Gulf Star Supermarkets LLC" and Warranty until 2028-10-06 on their serial detail pages (Traceability → Serial Numbers). - A month later Gulf Star returns one scanner. Sara creates a sales return, picks CUS-GULFSTAR as Customer, and the return list shows "Gulf Star Supermarkets LLC" in the Customer column. See Sales Returns.
- Gulf Star closes its Dubai branch. Sara edits the customer, unticks Active and saves. Old orders still show the customer; new orders cannot select it.
How it connects
| Where | What happens |
|---|---|
| Sales Orders | The Customer picker lists active customers ("Code · Name"). The customer's name is copied to the order and can be overridden per order. |
| Shipments | A draft shipment's Ship to name starts as the order's customer name. Posting stamps that name as the owner of shipped serial numbers. |
| Sales Returns | Pick the customer on the return. The list shows the customer name. |
| Traceability | A serial's detail page shows the customer as Owner. A recall's impact table lists the Customers who received affected lots and serials. |
| Fulfillment Requests | Invoices sent from SolaCount arrive with their customer already matched; approving one creates a sales order for that customer. |
| SolaCount | When SolaStock is connected to SolaCount, each customer used on orders must be matched to a SolaCount contact during setup (Business records → Customers). Until it is, confirming or reserving that customer's orders is refused with a mapping review message. See SolaCount integration. Invoices, payments and customer balances live in SolaCount: see SolaCount customers. |
Tips and common problems
| Problem | Cause | Fix |
|---|---|---|
| New customer is greyed out | Your role lacks Create / edit / confirm / cancel sales orders, or no organization is selected. | Ask the owner or a SolaStock Administrator, or select your organization. |
| A customer is missing from the sales order picker | The customer is Inactive. | Edit the customer and tick Active. |
| "Customer code must be unique." | The code is already used, possibly by an inactive customer. | Search the list by code, reuse or rename. |
| The customer is not in the list | The list shows 50 customers at a time. | Type part of the name or code in the search box. |
| The ship-to address is empty on a shipment | Customer addresses are not copied to shipments. | Type the address on the shipment's Carrier tab. |
| Confirming an order says a mapping review is required | SolaStock is connected to SolaCount and this customer is not matched yet. | Finish Business records → Customers on the SolaCount integration page. |