Sign in

d0dcc5024bd1

latestOpenAPI 3.0.42026-08-104969330.3 KB
Cases

Update case fees and/or principal

Updates the interest, reminder, and collection fees — and optionally the principal (GrossAmount) — on a case.

All provided values replace the current values. The grossAmount field is optional and backward-compatible: omitting it leaves the principal unchanged.

Fees typically change over time as collection activity progresses — for example due to legal costs, attorney fees, investigation charges, or other events.

When grossAmount is supplied:

  • Both increases and decreases are allowed (no restriction on direction)
  • The pre-legal success fee (commission) is silently recalculated and returned in the response
  • The outstanding remainder is recalculated to reflect the new principal
  • A timeline audit event is written recording the change (From/To principal and fees)

Prerequisites:

  • The case must be assigned to this collection partner
  • The case must not be Closed or Merged (returns 400 otherwise)
  • All amounts must be ≥ 0 (negative values rejected)
put/cases/{id}/fees

Path parameters

idstring uuid required

Request body

grossAmountnumber double nullable

Principal claim amount (gross amount) in the case currency. Optional — omit to leave the principal unchanged (fees-only update, backward-compatible). Both increases and decreases are allowed; must be ≥ 0.

interestFeesnumber double

Interest fees on this case, in the case currency.

reminderFeesnumber double

Reminder fees on this case, in the case currency.

collectionFeesnumber double

Collection fees on this case, in the case currency.

confirmPriceChangeboolean

The "Change to standard" resolution. When a principal edit on a <em>standard-rate</em> case would move the success fee by more than 0.1 percentage points (a bracket crossing), the first request returns HTTP 409 with the proposed old/new rate instead of applying the change. Resubmit the same request with this set to true to confirm and apply the re-price. Leaving it false (the default) on an unaffected edit has no effect. See partner-rules.md (price change confirmation required if the success fee changes by >0.1%).

IMPORTANT (DEB-4765 (b)): on a case with a deliberately-set rate (an accepted quote or a manual override), partners can never override a special agreement via this API. Sending this flag on such a case is REJECTED with HTTP 400 — resubmit with Debitura.Web.ExternalApi.Contracts.V1.Cases.Requests.UpdateCaseFeesRequest.KeepIntentionalRate=true to apply the edit and keep the special rate. Only the admin (internal) surface can change a special rate.

keepIntentionalRateboolean

The "Keep special rate" resolution. When the case carries a deliberately-set rate (an accepted quote or a manual override) that the edit would otherwise prompt about, resubmit with this set to true to apply the edit while preserving the existing rate. On this external Partner API a special rate is preserve-only: this is the ONLY way to apply an edit to such a case — sending Debitura.Web.ExternalApi.Contracts.V1.Cases.Requests.UpdateCaseFeesRequest.ConfirmPriceChange instead is rejected with HTTP 400. Ignored for a plain bracket crossing on a non-intentional rate (use Debitura.Web.ExternalApi.Contracts.V1.Cases.Requests.UpdateCaseFeesRequest.ConfirmPriceChange there).

Example request

{
  "grossAmount": 1000,
  "interestFees": 25.5,
  "reminderFees": 10,
  "collectionFees": 50
}

Response

Fees updated successfully

caseIdstring uuid

The case ID.

grossAmountnumber double

Updated principal claim amount (gross amount), in the case currency.

interestFeesnumber double

Updated interest fees, in the case currency.

reminderFeesnumber double

Updated reminder fees, in the case currency.

collectionFeesnumber double

Updated collection fees, in the case currency.

totalAddedFeesnumber double

Sum of all fee types.

recalculatedSuccessFeenumber double nullable

Recalculated success fee after the principal update. Null if no collection partner is assigned or if the principal was not changed.

remaindernumber double

Outstanding remainder after the update (principal + fees − payments).