Use Add customer in the Sell cart. Search starts after two characters, waits briefly while typing, ranks the best matches, and shows at most ten combined people/company bill-to results. Creating a customer from this control immediately attaches the new record. Removing the attachment does not delete the customer.
Step by step
- Choose Add customer in the cart. On phones the search opens full screen; on wider screens it opens a dropdown and closes when you click outside.
- Type at least two characters. The visible prompt supports name, customer code, email, and phone. The underlying lookup also matches company, contact role, address components, imported/source code, alternate phone lines, and enabled company bill-to names, then ranks the strongest matches.
- Wait for Searching… to finish and inspect every candidate. Results show name, All customers or Company bill-to, company, customer/customer-source code, phone, flags, and whether a company requester is required or optional. Similar names are not proof of identity.
- Select the exact customer only after comparing a stable identifier such as customer code, phone, email, company, or address. The selected customer chip replaces Add customer and displays its avatar/company icon, name, type, company, code, phone/source code, and alert indicators.
- Read the selected chip before continuing. A colored flag dot means a flagged customer note exists; a warning dot indicates pending duplicate candidates; an amber dot indicates internal notes; a saved-card badge reports vault cards. Open the profile instead of guessing what an indicator means.
- For an enabled Company bill-to result, choose Requested by when members are available. The selector states whether requester selection is required or optional. A required requester must be selected before an account invoice or company workflow that enforces it can continue.
- Click the attached customer chip to open the profile. Use the profile to review/edit contact details, addresses, notes/flags, duplicate matches, saved cards, groups/associations, sales/account activity, and saved sales according to permissions. Edits returned from the profile refresh the attached cart identity.
- If no existing record is correct, choose Add “query” as a new customer / Create new customer. The typed query seeds the Name field; correct it before saving. A name is required.
- Complete the new profile deliberately: primary email plus CC/BCC routing when needed, labeled primary and additional phone lines, company and contact role, address, tax-exempt status, active customer groups, and any configured accounting fields. Avoid entering temporary delivery-only information as permanent customer data unless the customer asked for it.
- Save the new customer. CentriPOS normalizes email routing and phone values, checks email/phone duplicates unless duplicate customers are allowed in tenant settings, assigns the customer ID/code, saves group memberships, reports Customer created, closes the creation panel, and attaches the new record to the cart.
- If a duplicate warning appears, stop and search again. Do not create a second record merely because two people share a name; compare email, phone, code, company, and address. Use the profile’s duplicate review/merge workflow when authorized.
- After attachment, verify any price-book changes, customer tax-exempt state, fulfillment options, account/layaway eligibility, and customer-facing contact/destination information. Attachment can change the effective cart price and tax context, so reconcile every line and the total again.
- To switch customers, remove the current attachment with the trash/remove control, then search and attach the correct record. Remove only detaches it from this active cart; it does not delete the customer profile. Recheck prices, tax, fulfillment, and account eligibility after removal or replacement.
- For a true walk-in, leave the cart unattached or use Walk-in. Do not detach a known customer merely to bypass an account limit, requester requirement, tax rule, or delivery contact requirement.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Add customer | Opens customer lookup for the active cart. |
| Search query | Requires at least two characters and debounces briefly before lookup. |
| Search results | Ranked tenant matches from people plus enabled company bill-to associations. |
| All customers | Normal customer/contact result. |
| Company bill-to | Enabled association result that attaches its designated billing customer. |
| Requested by | Company member selector labeled required or optional from association settings. |
| Customer flag dot | Color-coded pinned flag note; open the profile for its content. |
| Duplicate dot | Pending possible duplicate-record alert. |
| Internal-note dot | Indicates at least one customer note exists. |
| Saved-card badge | Count of vaulted cards; open the profile to review authorized card details. |
| Customer code / Imported code | Stable identifiers useful when names collide. |
| Create new customer | Opens the new profile form and seeds Name from the search query. |
| Duplicate check | Blocks a new/edited profile matching existing email or phone unless tenant settings allow duplicates. |
| Customer created | Successful creation outcome; the new profile is attached automatically. |
| Customer profile | Details, addresses, notes/flags, history, accounts, groups/associations, duplicates, saved cards, and communications according to permissions. |
| Remove attached customer | Detaches the record from the cart without deleting it. |
| Walk-in | Keeps a true walk-in sale unattached. |
| Cart recalculation | Customer attachment/removal can change price-book prices, tax exemption, fulfillment, and account actions. |
| No exact screenshot | The approved Amelia Grant / Harbor & Hearth manifest rejected /register/sell as rejected-loading, so this guide publishes no fabricated or mismatched customer-cart image. |
Expected result
The correct customer name appears on the cart and the sale inherits only that customer’s intended addresses, account options, receipt destinations, and history context.
Troubleshooting
- Confirm the active location, register, and register-session status before repeating the action.
- Do not refresh or retry while a card terminal shows a payment in progress.
- If totals differ, review every cart line, discount, fulfillment charge, and tax before payment.
CentriPOS API explorer · API Center administration