Elbuz calculates a customer's debt across all their documents, net of payments and returns, and shows it as a card in the document and contact cards.
When you need this:
- A wholesale customer buys on credit — the “They owe” card shows what was charged and paid.
- You owe a supplier — the same card is called “We owe”.
- A customer paid an invoice — mark the payment in the document, and the debt goes down.
- An invoice in dollars — the amount is converted to the base currency at the document rate.
Where to start: open any customer document — the card is in the top stats bar.
What debt calculation does
- Contact debt — a card in the document card and “Customer debt” in the contact card, with a breakdown of the amount.
- Payment in the document — the “Paid” payment status or the “Paid” field reduces the debt.
- Cash receipts and payments — money coming in and going out in the “Finance” workspace, separate from the debt.
- Document exchange rate — a dollar invoice is calculated in the base currency at the rate on the document date.
How contact debt is calculated
The “They owe” card shows the customer's debt across all documents, net of payments. It's in the stats bar of any of their documents, next to the total and item count. It appears only when there is a debt; all paid — no card. When we owe (an unpaid purchase invoice from a supplier), it's called “We owe”.
Clicking the card opens the contact card, where the same amount appears as the “Customer debt” or “We owe” card, and the contact list has a “Has debt” quick filter. The card doesn't depend on the “Working scheme”: it's calculated the same way for dropshipping, your own warehouse and wholesale.
The card's tooltip breaks the amount down: “charged”, “paid” and, if any, “cash received”, “returns” and “unpaid documents”. Debt is charged minus paid minus returns from the customer.
- Charges come from documents whose type has the “Settlement role” set to “Customer charge”: customer order, sales invoice, certificate of completion, sales receipt.
- A document counts as paid by the “Paid” payment status (then the whole amount counts) or by its “Paid” field (then the amount entered there).
- A cash receipt has the “Cash in” role: its amount appears as a separate “cash received” line and does not reduce the debt — to clear the debt, mark the payment in the charge document itself.
- Not included: documents with a canceled status, and an order that already has a sales invoice created from it — so the same amount isn't charged twice.
- Amounts in another currency are converted to the base currency at the document's exchange rate; with no rate, at 1:1 (document exchange rate).
The role is set per document type: the “Document types” window, “Settlement role” column, with the values “Not involved”, “Customer charge”, “Our liability”, “Cash in”, “Cash out”, “Return from customer”, “Return to supplier”. So your own document type can add to the debt too — just give it the “Customer charge” role (document types).
How to mark a document as paid
You mark payment in the charge document itself: with the “Paid” field (the part of the amount entered) or with the “Paid” payment status (the whole amount). After that, the debt card goes down; if everything is paid, the card disappears.
A fiscal receipt is issued separately: with a button in the document or on payment by link, via Vchasno.Kasa or Checkbox (software POS (PRRO)). Payment in an order is marked by the “Paid” field or the payment status.
How to record incoming money with a cash receipt
Cash receipts and payments live in the document list, in the “Finance” workspace — “Cash receipts and payments, cash flow and settlements”. Click “Add” → “Cash receipt” when money came in, or “Cash payment” when money was paid out; then choose the contact and enter the amount. These documents don't move stock.
A cash receipt is a document with a contact, an amount and a currency, with no split by cash registers or expense items: Elbuz has no directories for them and doesn't track cash balances by register. A cash receipt doesn't close a customer's debt — it's a separate “cash received” line in the calculation.
For PrivatBank, incoming payments can be pulled automatically: in the “Import” window (Operations → Data import), create a template with the “API - privatbank.ua account transactions” source. It creates a “Cash receipt” in the “Finance” workspace from each incoming completed payment, without matching it to invoices or orders. Bank statement files can't be imported, and other banks aren't supported — enter their payments as cash receipts manually.
How amounts in another currency are calculated
The “Currency rate” field is in the “Additional” section of the document card, with the hint “Rate as of the document date” under it. The rate is filled in automatically from the “Currencies and rates” directory for the document date — when the document is created and when it's posted, if the field is still empty.
If the directory has no rate for that date, the field stays empty with “Rate is empty - reports count this amount as base currency” under it. The stats bar, dashboard and contact debt then count it at 1:1: 100 dollars become 100 hryvnias. Add the rate for that date in “Currencies and rates” or enter it manually; unpost a posted document first.
The “Sales analytics” report ignores the rate entirely — amounts there aren't converted (sales analytics).
Scenarios
A customer paid an invoice by card transfer
What to do. Open the charge document — order, sales invoice or certificate of completion — and set the “Paid” payment status or enter the amount in the “Paid” field.
What you get. The “They owe” card goes down by that amount, or disappears if everything is paid.
What won't happen. A cash receipt for the same amount won't reduce the debt: it's a separate line in the calculation.
Pull incoming payments from PrivatBank automatically
What to do. In the “Import” window, create a template with the “API - privatbank.ua account transactions” source.
What you get. Each incoming completed payment becomes a cash receipt in the “Finance” workspace.
What won't happen. Payments aren't allocated to invoices automatically: you mark payment of a specific document in that document manually.
Your own document type should add to the debt
What to do. In the “Document types” window, set your type's “Settlement role” to “Customer charge”.
What you get. Documents of this type are added to the customer's debt just like orders or invoices.
What won't happen. You can't change the role of system types — their behavior is fixed.
FAQ
There's no debt card in the document card. Why?
The card appears only when there is a debt. If everything charged has been paid or returned, there's no card.
Does the debt depend on the “Working scheme”?
No. Debt is calculated the same way for dropshipping, your own warehouse and wholesale.
A dollar invoice was counted as hryvnias. Why?
The document has no exchange rate, so the amount is counted at 1:1. Add the rate for the document date in “Currencies and rates” or enter it in the card — see amounts in another currency.
Can I import a Privat24 statement so payments are allocated to invoices automatically?
Not from a file. PrivatBank has automatic transaction import: it creates cash receipts but doesn't match them to invoices or orders — see cash receipts.
Does Elbuz have cash registers and expense items?
No. A cash receipt or payment is a document with a contact, an amount and a currency, with no split by registers or items. Money from these documents shows in the “Finance” workspace and in settlements with the contact.
Where to find it and who has access
- Menu
- Directories → Documents → your area's entry point → the customer's document card
- Other ways in
- contact card, “Customer debt” card; the “Has debt” quick filter in the contact list
- Prepare
- a settlement role for your own document types
Related topics
- If you need the big picture of the documents window — Document list.
- If you need the full customer card: turnover, average order value, COD pickup rate — Customer base and customer card.
- If the exchange rate isn't filled in on a document — Currencies and rates.
- If you're choosing order management software — what it gives your store.
