What is Quarantine?

Quarantine is a mechanism that allows temporarily excluding specific statement lines that contain Data Errors which cannot be resolved immediately.

Quarantined lines are removed from the royalty calculation workflow without blocking the processing of the remaining valid data.

This ensures that Royalty Statement processing can continue while preserving full traceability and auditability of unresolved issues.

Quarantine is a deliberate, explicit decision.

It does not fix errors, normalize data, or create Rules.

It simply postpones their resolution.

Purpose of Quarantine

Quarantine exists to solve a practical problem:

Some Data Errors cannot be resolved at the time of processing because:

required assets do not yet exist
contracts are missing or not finalized
identifiers are incomplete or unknown
third-party data is ambiguous or unreliable

Without Quarantine, a single blocking error could prevent an entire Royalty Statement from being processed.

With Quarantine:

valid data is processed immediately
unresolved lines are safely excluded
accounting integrity is preserved
issues can be revisited later

Where Quarantine is used

Quarantine is available during step “Handling Data Errors” of the Royalty Statement processing workflow.

It applies only to Data Errors.

Quarantine is not available for:

Amount Errors
Mapping configuration
Calculation steps

Putting Errors in Quarantine

To quarantine one or more Data Errors:

Go to the Handling Data Errors step
Locate the error lines to exclude
Right-click the line or open the contextual menu
Select the “Quarantine” action
Confirm the action

The selected errors immediately switch to “Quarantined” status.

Quarantined lines are excluded from:

royalty calculations
Operations generation
Contract balances
Rights Holder balances

Impact on Income Processing

When at least one line is quarantined:

The Income can still be processed
Only corrected lines are calculated
Quarantined lines are ignored
The Income status becomes “Partially Processed”

This status explicitly indicates that:

the Income is valid
calculations were performed
some data was intentionally excluded

No silent data loss occurs.

What Quarantine does not do

Quarantine does not:

modify source data
normalize values
create Error Rules
generate Operations
affect historical calculations

Quarantined lines remain fully visible and auditable.

Unquarantining Errors

Quarantined errors can be reactivated at any time.

To unquarantine errors:

Open the Handling Data Errors step
Select one or more quarantined lines
Open the contextual menu
Click “Unquarantine”

The selected lines return to “To correct” status.

They must then be corrected or re-quarantined before processing can continue.

Quarantine and Reprocessing

Quarantine interacts directly with Reprocessing.

When an Income is reprocessed:

quarantined lines remain excluded
unquarantined and corrected lines are recalculated
new Operations are generated accordingly

To include previously quarantined lines in calculations:

they must first be unquarantined
corrected during the Data Errors step
then included via Reprocessing

Best Practices

Use Quarantine intentionally, not as a shortcut
Prefer correction whenever possible
Avoid quarantining large volumes of data permanently
Periodically review quarantined lines
Combine Quarantine with Reprocessing once missing data becomes available

Quarantine is a safety valve, not a data cleaning strategy.

Relationship with Other Concepts

Quarantine is tightly linked to:

Handling Data Errors
Error Rules
Reprocessing
Royalty Statement Processing statuses

It ensures that incomplete or ambiguous data never corrupts financial calculations while remaining fully traceable and recoverable.