> ## Documentation Index
> Fetch the complete documentation index at: https://help.kuverbooks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage and Organize Your Customer Records in Kuvera Arc

> Create, import, categorize, and manage customer records in Kuvera Arc to power your sales orders, invoices, payments, and reporting workflows.

The Customers module is the central database for sales activity in Kuvera Arc. Before you raise a sales order, issue an invoice, or record a payment, create a customer record so sales documents and customer history stay organized.

<Info>
  The Customers module is core master data. Clean customer records flow into sales orders, invoices, payment tracking, and financial reports.
</Info>

## Access Customers

<Frame caption="Customers in the Sales sidebar" />

<Steps>
  <Step title="Open Sales">
    In the left navigation panel, click **Sales**.
  </Step>

  <Step title="Select Customers">
    Click **Customers** from the submenu. The Customers Listing Page opens.
  </Step>
</Steps>

## Customers listing page

The Customers Listing Page is the command center for customer management. Use it to search, filter, export, control display count, view inactive customers, and open customer profiles.

<Frame caption="Customers Listing Page" />

<CardGroup cols={2}>
  <Card title="Search customers" icon="magnifying-glass">
    Find customer records by customer name.
  </Card>

  <Card title="Filter records" icon="filter">
    Narrow the listing by customer type, credit limit, or status where available.
  </Card>

  <Card title="Export data" icon="file-export">
    Download customer records for reporting or external use.
  </Card>

  <Card title="Inactive customers" icon="eye">
    Toggle or open the inactive customer view when you need historical records.
  </Card>
</CardGroup>

## Customer table

The customer table shows key customer information at a glance.

<Frame caption="Customer table" />

<CardGroup cols={2}>
  <Card title="Customer Name" icon="user">
    Full name of the customer.
  </Card>

  <Card title="Credit Limit" icon="credit-card">
    Maximum credit exposure allowed for the customer.
  </Card>

  <Card title="Customer Type" icon="users">
    Category or group assigned to the customer.
  </Card>

  <Card title="Customer Phone" icon="phone">
    Primary customer contact number.
  </Card>

  <Card title="Customer Email" icon="envelope">
    Primary customer email address.
  </Card>

  <Card title="Option" icon="eye">
    Opens the Customer Details Page for that record.
  </Card>
</CardGroup>

<Note>
  The listing page is read-only. It provides access to management actions but does not let you edit customer data directly from the table.
</Note>

## Create a customer

Use **Add Customer** to create a new customer record manually. Once saved, the customer is available across sales workflows.

<Frame caption="Add Customer button" />

<Steps>
  <Step title="Open Customers">
    Go to **Sales > Customers**.
  </Step>

  <Step title="Click Add Customer">
    Click **Add Customer** in the top-right area of the listing page.
  </Step>

  <Step title="Enter customer information">
    Fill in the required fields and any relevant optional fields.

    <Frame caption="Add Customer form" />
  </Step>

  <Step title="Save the customer">
    Click **Save Customer** to create the record. The new customer appears in the listing.
  </Step>
</Steps>

## Customer fields

<AccordionGroup>
  <Accordion title="Required fields">
    **Customer Name** — Full name of the customer.

    **Customer Phone Number** — Primary contact number.

    **Customer Email** — Primary email address.
  </Accordion>

  <Accordion title="Optional fields">
    Optional fields help create a more complete customer profile:

    * **Customer landline number** — alternate contact number
    * **Customer location** — physical or mailing address
    * **PAN number** — tax identification for compliance
    * **Credit limit** — maximum allowable outstanding balance
    * **Payment terms** — default terms applied to orders and invoices
    * **Customer type** — category used for segmentation and discounting
    * **Notes** — freeform notes about the customer
  </Accordion>
</AccordionGroup>

<Tip>
  Setting **Credit Limit** and **Payment Terms** at the customer level allows those values to be suggested when creating orders or invoices.
</Tip>

## Import customers

Use **Import Customers** to upload multiple customer records at once.

<Frame caption="Import Customers button" />

<Steps>
  <Step title="Open Customers">
    Go to **Sales > Customers**.
  </Step>

  <Step title="Click Import Customers">
    Click **Import Customers**. The import workflow page opens.
  </Step>

  <Step title="Upload your file">
    Upload your customer data file. Supported formats are **CSV**, **XLSX**, and **XLS**.

    <Frame caption="Upload customer file" />
  </Step>

  <Step title="Match column headers">
    Map each spreadsheet column header to the corresponding Kuvera Arc customer field.

    <Frame caption="Match customer headers" />
  </Step>

  <Step title="Verify field mappings">
    Review mapped fields and adjust any mismatches.

    <Frame caption="Match customer fields" />
  </Step>

  <Step title="Finalize the import">
    Confirm the import. Valid records are added to the Customers Listing Page.
  </Step>
</Steps>

<Tip>
  Click **Download Sample** on the import page before uploading your own file. The sample shows the expected columns and format.
</Tip>

<AccordionGroup>
  <Accordion title="Import behavior and rules">
    * File structure is validated before records are processed.
    * Invalid or unmapped columns may block import completion.
    * Successfully imported customers appear on the Customers Listing Page.
    * Existing records are not overwritten unless your system configuration supports that behavior.
    * The import process does not affect unrelated customer data.
  </Accordion>
</AccordionGroup>

## Customer types

Customer Types group customers into reusable categories. A type can include a discount percentage that applies during sales transactions for customers in that group.

<Frame caption="Customer Types management page" />

<Steps>
  <Step title="Open Customers">
    Go to **Sales > Customers**.
  </Step>

  <Step title="Click Add Customer Type">
    Click **Add Customer Type**. The Customer Types management page opens.
  </Step>

  <Step title="Click Add New Customer Type">
    Click **Add New Customer Type**.

    <Frame caption="Add New Customer Type button" />
  </Step>

  <Step title="Fill in type details">
    Enter a **Customer Type** name and optionally set a **Discount Percentage (%)**.

    <Frame caption="Add Customer Type form" />
  </Step>

  <Step title="Save the customer type">
    Click **Save Customer Type**. The type becomes available when creating or editing customers.
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="Customer Type" icon="users">
    Name of the category, such as Wholesale, Retail, or VIP.
  </Card>

  <Card title="Discount Percentage" icon="percent">
    Default discount applied to customers in this group during sales transactions.
  </Card>
</CardGroup>

<Info>
  Customer Types are reusable. Assign the same type to multiple customers. Changes to a type apply going forward for new transactions.
</Info>

## Customer details page

The Customer Details Page gives a complete view of one customer, including profile data, sales history, transactions, and logs.

<Steps>
  <Step title="Open Customers">
    Go to **Sales > Customers**.
  </Step>

  <Step title="Locate the customer">
    Find the customer in the listing table using search or filters.
  </Step>

  <Step title="Open the details page">
    Click the **Option** field on the customer row.

    <Frame caption="Open Customer Details" />
  </Step>
</Steps>

<Frame caption="Customer Details Page" />

<CardGroup cols={2}>
  <Card title="Customer Basic Details" icon="address-card">
    Customer ID, name, phone, email, PAN number, credit limit, address, and assigned customer type.
  </Card>

  <Card title="Customer Activity & Transactions" icon="clock-rotate-left">
    Sales orders, transactions, logs, and recent customer activity.
  </Card>
</CardGroup>

## Customer activity tabs

<Tabs>
  <Tab title="Overview">
    Shows recent sales orders, recent transactions, and quick-access links to logs and history.
  </Tab>

  <Tab title="Sales Orders">
    Shows every sales order linked to the customer. Select any order to open its details.
  </Tab>

  <Tab title="Transactions">
    Shows customer financial transaction history, including invoice payments and balance movements.
  </Tab>

  <Tab title="Logs">
    Shows the system audit log for changes, actions, and events recorded against the customer profile.
  </Tab>
</Tabs>

## Customer actions

Actions are available from the Customer Details Page.

<Frame caption="Customer actions menu" />

<AccordionGroup>
  <Accordion title="Create Sales Order">
    Opens the Sales Order creation page with the customer field pre-filled.
  </Accordion>

  <Accordion title="Edit Customer Details">
    Opens the customer record for editing. Changes are reflected across sales modules and future transactions.
  </Accordion>

  <Accordion title="Disable Customer">
    Marks the customer as inactive.

    Disabled customers:

    * Cannot be selected in new transactions
    * Remain accessible for historical reporting and audit purposes
    * Move to the inactive customers view on the listing page
  </Accordion>
</AccordionGroup>

<Warning>
  Disabling a customer removes them from active workflows immediately. Historical sales orders, invoices, transactions, and logs remain intact.
</Warning>

## Filter customers

Use **Filter Data** to refine the Customers Listing Page without changing customer records.

<Frame caption="Customer filter panel" />

<CardGroup cols={2}>
  <Card title="Customer Type" icon="users">
    Filter customers by assigned customer group.
  </Card>

  <Card title="Credit Limit Range" icon="credit-card">
    Filter customers by minimum or maximum credit limit.
  </Card>

  <Card title="Status" icon="circle-check">
    Filter by active or inactive status where available.
  </Card>
</CardGroup>

<Note>
  Filters apply only to the listing view. Clear filters to return to the full list.
</Note>

## Export customers

Use **Export Data** to download customer records.

<Frame caption="Export Customers panel" />

<Tabs>
  <Tab title="Full Export">
    Downloads every customer record in the system, regardless of active filters.
  </Tab>

  <Tab title="Current View Export">
    Downloads only the records currently visible, including filter or search conditions.
  </Tab>
</Tabs>

<CardGroup cols={3}>
  <Card title="XLSX" icon="file-excel">
    Export customer records for spreadsheet use.
  </Card>

  <Card title="PDF" icon="file-pdf">
    Export customer records for document sharing.
  </Card>

  <Card title="CSV" icon="file-csv">
    Export customer records for data processing or integrations.
  </Card>
</CardGroup>

<Note>
  Exported files reflect the listing view at the time of export. Exporting never modifies or deletes customer data.
</Note>
