Official Documentation (Prime Overdue)

Short operator / setup guide for Prime Overdue. Screenshots and detailed CSV layouts remain on Prime Overdue Explanations.

App hub: Prime Overdue · Needs: Prime Billing

Onboarding: On Boarding Steps (Prime Overdue)

Enable and choose import mode

1. Enable the Overdue package (nmsprime-overduedebts) with Billing active.

2. Choose one debt-management mode for the tenant:

• MT940 / STA — NMS Prime parses the bank file and maintains debt history.

• CSV — Import open debts from financial accounting.

3. Set the mode in the Overdue environment config (DEBT_MGMT_TYPE=sta or csv).

4. Open Overdue config: return-debit fee, payment period, dunning charges/texts 1–3, and internet-block thresholds.

Internet block thresholds

Automatic block sets the customer's modem internet_access flag during debt import when thresholds are exceeded.

Germany — § 61 TKG (default for onboarding)

Suggested config: import_inet_block_amount = 100 (EUR)

Law: § 61 TKG · BNetzA: Neue Kundenrechte

Use test CSV upload to preview who would be blocked without applying.

MT940 workflow

1. Run settlement in Billing so open amounts become debts.

2. Menu → Overdue → Debt import → upload SWIFT/MT940 (.sta).

3. Review Logs tab for matched and unmatched transactions.

4. Customer transfers should include the invoice number in the transfer reason.

CSV workflow

1. Export open debts in supported column layout.

2. Debt import → upload CSV; optionally enable Test CSV upload.

3. Confirm Debt list shows imported open items.

Clear a debt manually

1. Debt list → debt → Contract → Billing.

2. Create debt, select debt to clear.

3. Enter paid amount with negative sign for a payment clearing a positive debt.

When something looks wrong

• Import stuck → queue worker for low queue must be running

• Unmatched MT940 lines → missing invoice number in transfer reason

• CSV rejects → wrong columns; use test mode first

Related