FR ENAR
User Manual Customer Master Data Version 1.0 · Stable

Customers manual

The Customer record is the central master data of the business relationship. It carries the tax identity (tax ID / CIN), the currency, the pricing terms, the credit limit, and feeds quotes, orders, delivery notes, invoices and payments received.

2
Entity types (individual / company)
2
Types (customer / reseller)
3
Search criteria
1
Statement / outstanding balance
1

Overview

The Customers module maintains your company's file of buyer third parties. Each customer has a unique code, a company name / name, an entity type (individual or company), a type (final customer or reseller), a billing currency and a geolocated address. This record is the foundation of every sales document: it is selected as early as the quote, and it automatically propagates the currency, payment terms and credit limit.

Business goal

  • Centralize the customer's identity and contact details
  • Carry the tax identity (tax ID / CIN)
  • Set currency, payment terms and credit limit
  • Track the outstanding balance and account statement

Target audience

  • Sales reps / Order admin — create and qualify customers
  • Accounting — sets limits and tracks the outstanding balance
  • Field sellers / mobile sales — SmartSeller customers, routes

Position in the cycle

The customer is upstream of the entire sales cycle. It is consumed by Quotes, Purchase orders, Delivery notes, Invoices and Collections, and appears in Complaints.

2

Access and navigation

Left-hand side menu: Third parties / CustomersCustomers. The submenu also gives access to Categories, Groups, Contacts and the Account statement.

Swifto ERP — Customers menu
Global dashboard
Customers
Customers
Customer Categories
Customer groups
Contacts
Customer account statements
Settings
Sales
Need help? Click here...
The list of customers opens on the right after the click.
3

List of customers

The page lists all of the company's customers. The table is paginated and filterable column by column; a Search dialog lets you filter by customer code, CIN, tax ID, category, type, entity type, location…

Customers › List
Global dashboard
Customers
Customers
Customer Categories
Customer groups
Customer account statements
Settings
Sales
071 Mr Amine ABDELKEFI
Need help? Click here...
Customer management
New Search
LabelCategoryDateNatureTypeCurrencyCredit limit
EL MAZRAAWholesaler12/02/2026CompanyCustomerDinars50,000.000TND
ECARReseller South28/01/2026CompanyResellerDinars25,000.000TND
BEN AMMAR FouedRetail05/01/2026IndividualCustomerDinars0.000TND

Table columns

ColumnDescription
LabelCustomer's company name / name (filterable, sortable).
CategoryClassification category (Wholesaler, Retail, Reseller South…).
DateRecord creation date.
Entity typeIndividual (CIN) or Company (tax ID).
TypeFinal Customer or Reseller.
CurrencyCustomer's billing currency (Dinars, EUR, USD…).
Credit limitAuthorized credit limit, in the customer's currency.

Multi-criteria search

The Search button opens a dialog filtering by Customer code, Type, Category, Entity type, then depending on the entity type by Tax ID (company) or CIN (individual), and by Country / Governorate / Delegation.

Excel import / export

The action bar offers a downloadable import template, bulk import of an .xls / .xlsx file and Excel export of the list.

4

Create / edit a customer

Click New. The form is organized in two columns (identity & classification on the left, commercial terms on the right), followed by the geolocated address and GPS coordinates.

New customer
Customer
CLI-00128
EL MAZRAA
Customer
Company
1234567 A/M/000
B01234562026
Wholesaler
Key account
30 days
Dinars
50,000.000
No
— (parent)
Address & GPS coordinates
Tunisia
Sfax
3000
Route de Gabès Km 4, Sfax
+216 74 000 000
contact@elmazraa.tn
34.7406
10.7603

Main fields

FieldRoleMandatory
CodeUnique identifier of the customer within the company.Yes
LabelCompany name / name displayed everywhere.Yes
TypeFinal customer or Reseller (affects pricing).Yes
Entity typeIndividual or company (drives CIN vs tax ID).Yes
Tax IDTax identifier — company.Depends on entity type
CINIdentity card — individual (8 digits in TN).Depends on entity type
CategoryBusiness classification (can be created on the fly).Yes
CurrencyBilling currency; drives the number of decimals.Yes
Payment termsTerm (15 / 30 / 45 / 60 / 90 days).
Credit limitAuthorized outstanding balance ceiling, in the customer's currency.
Country / Governorate / AddressGeolocated address (Google Maps).Yes

Entity type → tax field

Choosing Company displays Tax ID + Trade register; choosing Individual displays the CIN (8 digits validated in Tunisia). Both blocks display dynamically based on your choice.

5

Customer categories & groups

Two levels of classification complete the customer record:

Customer categories

Mandatory classification of each customer (Wholesaler, Retail, Reseller South…). Used as a filter and a pricing criterion. A category can be created directly from the customer form ( button).

Customer groups

Cross-cutting grouping (by name, potentially by category / governorate / sales reps) used for bulk actions: promotions, campaigns, sales assignment.

Additional classifications

ConceptDescription
General classificationShared scale (e.g. Key account, SME, Individual).
Internal classificationCompany-specific scale, can be created on the fly.
Billing customer (parent)Links a customer to a central billing account (subsidiary → parent company).

Category and classification can be created without leaving the customer record ( button next to the dropdown menu), avoiding back-and-forth data entry.

6

Contacts & delivery addresses

A customer (often a company) has several contacts and can be delivered to several addresses different from its head office.

Customers › Contacts
Contacts
New Search
ContactPositionCustomerMobile phoneEmail
BEN SALEM KarimPurchasing managerEL MAZRAA+216 98 111 222k.bensalem@elmazraa.tn
TRABELSI RaniaAccountantECAR+216 22 333 444r.trabelsi@ecar.tn

Contacts

Each contact has a last name / first name, a position (Purchasing manager, Accountant…), a mobile number and an email, and remains linked to its customer.

Delivery addresses

Additional addresses (warehouse, point of sale, job site) selectable on the delivery note, distinct from the head office / billing address.

7

Customer statement / outstanding balance

The Account statement screen consolidates, by customer and by period, the total invoiced, paid, the balance due and the outstanding balance. A customer's detail view also shows the total advances.

Outstanding balance = the amount of documents not yet paid by the customer at a given time. Compared against the credit limit to decide whether to authorize a new sale.

Balance due = total invoiced − total paid over the period. Exportable as PDF (official account statement).

The statement is automatically fed by the customer's invoices, delivery notes and collections / advances.

8

Lifecycle (workflow)

flowchart LR
  A([Customer creation
code + tax identity]):::s --> B[Quote / Proforma invoice]:::p B --> C[Purchase order]:::p C --> D[Delivery note
stock decremented]:::st D --> E[Sales invoice]:::p E --> F([Collection / Advance]):::ok F --> G[(Statement & outstanding
updated)]:::ok E -.->|outstanding > limit| K([Credit limit alert]):::ko classDef p fill:#f3f1ff,stroke:#7366fe,color:#1f1c3d; classDef s fill:#E0F2FE,stroke:#0284C7,color:#075985; classDef st fill:#FEF3C7,stroke:#F59E0B,color:#92400E; classDef ok fill:#D1FAE5,stroke:#10B981,color:#065F46; classDef ko fill:#FEE2E2,stroke:#EF4444,color:#991B1B;
9

Business rules

Uniqueness of the code — the customer code must be unique within the company; it identifies the third party in all documents.

Tax identity based on entity type — company ⇒ tax ID + trade register; individual ⇒ CIN (8 digits in Tunisia).

Fixed currency — the customer's currency propagates to its documents and sets the number of decimals; the credit limit is expressed in this currency.

Multi-tenant isolation — each company only sees its own customers; access by identifier is controlled (anti-IDOR) and multi-domain setups can separate customer files by domain.

10

Roles & permissions

ActionSales rep / Order adminAccountantField sellerAdmin
View
Create / edit
Set the credit limit
Assign (sales rep / zone)
Reset / activate password
Bulk import
Delete

Indicative matrix — each action is governed by the GClient privilege (creation, deletion, activation, reset…) of the profile defined in your company.

11

FAQ & Tips

The Tax ID field isn't showing?

It only appears for the Company entity type. For an individual, the CIN field is offered instead.

Can't save: "code already in use"?

The customer code must be unique. First search for the existing customer via the code before creating a new one.

Finding a specific customer

Use the Search by code, CIN or tax ID — more reliable than filtering by name in case of similarly named customers.

Tip — create your categories first

Define your categories and classifications upfront, then import your customers via Excel: your dashboards and pricing will be consistent from the start.

Swifto

Swifto ERP · Customer Master Data · User Manual v1.0

Customers — Home