Customers

Customer Management

Customer records hold who owes you what. This is the list, the detail drawer, and the tools for chasing debt.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/customers

Requires subscriptioncustomer.manage3,000 IQD / month

Overview

A customer record is needed for credit sales, statements and debt tracking. Anonymous cash sales do not need one — those go against the default General Customer that every business starts with, which cannot be deactivated.

Customers — Customer list
Customer list
Customer list — Customers with their balances, payment types and the search and filter controls.

The list

Four figures sit above the list: total customers, how many are postpaid, the total outstanding, and how many are new this month. Search by name or phone, filter to customers with debt, sort by name, balance or last purchase, and switch between Cards and a Tablethat shows each customer's sales, cash total, postpaid total, total paid and debt side by side.

The customer drawer

Selecting a customer opens a drawer on the right with four tabs — five when sub-customers are subscribed. The drawer is the main working surface — most customer tasks are done without leaving the list.

Status tab

A summary of the trading relationship.

GET /api/v1/customers/{id}/stats
ParameterTypeRequiredDescription
cash_sales_totaldecimalOptionalEverything this customer has bought and paid for at the counter.
postpaid_sales_totaldecimalOptionalEverything bought on credit.
total_payments_madedecimalOptionalSum of all payments recorded against the account.
total_sales_amountdecimalOptionalCash plus postpaid — everything ever sold to them.
sales_countintegerOptionalNumber of invoices raised.
customer_sincetimestampOptionalWhen the record was created.
sales_debtdecimalOptionalWhat remains unpaid on postpaid invoices.
old_debtdecimalOptionalDebt carried in from before they were on the system.
total_debtdecimalOptionalSales debt plus old debt — the full amount owed.
Notetotal_debt deliberately separates debt built up in the system from old_debt brought in from your previous books, so migrated balances never get mistaken for recent trading.

Sales tab

Every invoice for this customer, newest first. Selecting one opens it, and it can be reprinted if invoice printing is subscribed.

Info tab

The stored details, read-only, with the actions that apply to the record: edit, print a statement, and deactivate.

WarningA customer can only be deleted while they owe nothing. If there is an outstanding balance the option is unavailable — settle the debt first, or deactivate the customer instead to keep the history. A deleted customer goes to the recycle bin, where the owner can restore them. Switching a customer on or off needs Switch customers on/off in the permission matrix.

Payments tab

Where a payment is taken, corrected, and where the payment history is read. See Recording Payments.

People tab

The people this customer's debt is split across, with what each one owes. Only shown with the sub-customers feature — see Sub-Customers.

Requires subscriptioncustomer.sub_accounts1,500 IQD / month

Debt schedule

The debt schedule lists everyone who owes money, ordered by when they said they would pay, so the collections list is driven by promises rather than by size alone.

GET /api/v1/customers/debt-schedule
ParameterTypeRequiredDescription
total_debtorsintegerOptionalHow many customers currently owe money.
overdue_countintegerOptionalHow many are past their expected payment date.
total_debtdecimalOptionalTotal outstanding across all customers.
schedule[].current_balancedecimalOptionalWhat this customer owes.
schedule[].next_payment_datedateOptionalWhen they are expected to pay.
schedule[].days_remainingintegerOptionalDays until that date. Negative means overdue.
Requires subscriptioncustomer.debt_alerts1,000 IQD / month

Customer portal

Customers can be given a login to see their own invoices and statement, which reduces the number of “what do I owe” phone calls.

Requires subscriptioncustomer.portal5,000 IQD / month
Portal account
ParameterTypeRequiredDescription
phonestringRequiredThe phone number the customer signs in with.
passwordstringRequiredInitial password, at least 8 characters; easily guessed ones such as 12345678 are refused. Shown once — send it before closing the window. Can be reset later.
is_activebooleanOptionalWhether the portal login currently works.
last_login_attimestampOptionalWhen they last signed in. Read-only.
portal_slugstringOptionalThe business's portal address. Read-only.

From Manage Portal Account you can copy the portal link, send the login details or just the link over WhatsApp, reset the password, and disable or re-enable the login. In the portal the customer sees their account, invoices, payments and statement — their own records only.

NoteA one-off share link can also be produced for a single invoice, statement or receipt without creating a portal account at all — useful for a customer who only needs one document. The link shows the date it stays valid until.

In this section