OPOS Case Dunning (New)

🚧

Draft — not yet generally available.
Until rollout for your tenant, use Document-based Dunning.

OPOS Case Dunning runs on the OPOS Case (open items case). You configure tenant-wide settings, a default dunning configuration (levels and optional fees), and matching rules. When an OPOS Case is created and plan creation is enabled, instellix builds a Dunning Plan snapshot for that case from the matching configuration.

Configuration to Dunning Plan

Concepts

ConceptMeaning
SettingsTenant switches: plan creation, issuance, PDF, deposit invoices
Default configurationFallback levels, intervals, optional fees
Matching rulesSpecific configurations selected by case attributes (priority order)
Dunning PlanCase-specific snapshot of planned levels, due dates, and fees
Dunning ActionScheduled step on the plan, executed by a dunning job when due
Issued dunningPersisted issuance for one action (optional fee on the case)
Dunning blockPauses dunning for a case and/or customer — see Dunning Block

Where to configure

Go to: Configuration > Billing > Dunning configuration

The page groups:

  1. Legacy / document-based dunning (only if still enabled for the tenant)
  2. Settings (OPOS Case Dunning)
  3. Dunning Configuration (default levels + fees)
  4. Matching Rules (attribute-based overrides)

Document-based and OPOS Case dunning can run in parallel for a tenant; there is no automatic migration of the old configuration into the new one.


1. Settings

SettingWhat it does
Enable Dunning Plan CreationWhen enabled, instellix creates dunning plans for eligible OPOS Cases from the configurations below. When disabled, no plans are created and no dunning notifications are sent.
Activate dunning for deposit invoicesWhen enabled, deposit invoices are included in the dunning process.
PDF CreationEnables PDF generation for dunning documents. Enable only if you use the default template or a tenant-specific template is available.
Pause Dunning issuanceTemporary operational hold: plans continue to be created and tracked, but no notifications are sent. When the pause ends, cases can advance again.
📘

Pause issuanceDunning block. Pause is tenant-wide for issuance. A dunning block is per customer or per OPOS Case — see Dunning Block.


2. Matching rules

Matching rules let you apply a specific level/fee configuration when case attributes match. Rules are evaluated in priority order (reorderable). The first matching rule wins; otherwise the default configuration is used.

Match criteria (combinable per rule)

CriterionExample use
Billing GroupDifferent escalation for a product line
Customer TypeB2B / B2C / Affiliated
Operating SiteCountry/entity-specific process
Invoice address countryJurisdiction-specific intervals or fees
Customer Tax ClassificationTax-segment-specific handling
Currency

Each rule has its own levels (payment reminder + max. four levels) and optional fees.


How the Dunning Plan is created

  1. An invoice (or eligible document) opens or updates an OPOS Case.
  2. If Dunning Plan Creation is enabled, instellix evaluates matching rules (in order).
  3. Matching uses attributes of the initial invoice on the case.
  4. A Dunning Plan is stored on the case: planned levels, timing, fees.
  5. Later changes to tenant configuration do not change existing plans (snapshot for auditability).
  6. A dunning job processes due Dunning ActionsIssued dunning (and optional fee assignment on the case).

When a dunning block is active, planned actions are deferred; when the block is removed, remaining plan dates are adjusted (see Dunning Block).


Fees on the OPOS Case

When a level with a fee is issued:

  • The fee is booked on the OPOS Case as an assignment related to issued dunning (not as an OPOS Case decision).
  • Fee currency must match the case currency; otherwise the fee is skipped.

Document generation for issued dunning may depend on PDF Creation and template provisioning for your tenant.


Related articles


Did this page help you?