A recall is a process where a client chooses to withdraw a claim, either partially or entirely, from the debt collection process. This allows clients to stop further collection actions on specific invoices or the entire claim, depending on their requirements. Recalls are crucial for cases where clients have resolved issues directly with the debtor or need to make adjustments for any reason. There are two types of recalls available:
POST {{collection_api_base_url}}/v1/claims/{claimNumber}/recalls
When a client opts for a total recall, all invoices associated with the specified claim are recalled. This action ceases all collection efforts for that claim.Upon a total recall, clients can expect to receive a confirmation of type recall
. If they check the transaction status via the transaction endpoint immediately after the recall, it will eventually show the claim as closed with the closing type recalled_by_client
.
A client recalls the entire claim amount of €400. A confirmation of type recall
is generated as shown below:
{}
[
...
{
"sortNumber": 27,
"id": "4d5983ed-526f-45f2-bde9-15746da13584",
"type": "CONFIRMATION",
"customerNumber": "K508647",
"claimNumber": "DE-S242243704005",
"confirmation": {
"date": "2024-08-07",
"type": "RECALL",
"number": "K508647",
"contractNumber": "",
"amount": 400
}
}
]
This option allows clients to selectively recall specific invoices tied to a claim. The remaining invoices continue through the collection process. Clients will receive confirmation of the partial recall and can track the status of each invoice via the transaction endpoint.
A client recalls €100 of a €400 remaining debt, relating only to specific invoices. A confirmation of type partial_recall
is generated as shown below:
{
"invoiceNumber": "I0417211448",
"contractNumber": "166271782837",
"type": "CREDIT_WAIVER",
"date": "2023-06-23",
"description": "Quia molestias voluptates vero harum ea ea iste animi est.",
"amount": 100,
"currency": "EUR"
}
{
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Once a claim is recalled, the client will receive two responses:
"recall"
indicates the recall request has been successfully processed."recalled_by_client"
, indicating that the claim has been recalled and the collection process is inactive.Find below sample transaction responses for confirmation and closing of claim previously recalled by a client:
{
"sortNumber": 0,
"id": "de51a3d6-fead-4a92-b613-e79057c12319",
"type": "CLOSING",
"customerNumber": "brak008-45544456",
"claimNumber": "DE-S242243747003",
"closing": {
"date": "2024-09-11",
"type": "RECALLED_BY_CLIENT"
}
},
{
"sortNumber": 1,
"id": "e7f49fa3-3ebd-49aa-b71e-92411489b329",
"type": "CONFIRMATION",
"customerNumber": "brak008-45544456",
"claimNumber": "DE-S242243747003",
"confirmation": {
"date": "2024-09-11",
"type": "RECALL",
"number": "brak008-45544456",
"contractNumber": "",
"amount": 0
}
}
"recalled_by_client"
, Riverty will send a rejection of type: "recall"
, with a "description"
explaining that the recall was rejected due to the previous client-initiated recall.Find below sample transaction response when a client recalls a previosly recalled claim with closing type: "recalled_by_client"
:
{
"sortNumber": 2,
"id": "1b142099-32a6-4c05-8416-3d465fd423a7",
"type": "REJECTION",
"customerNumber": "brak008-45544456",
"claimNumber": "DE-S242243747003",
"rejection": {
"date": "2024-09-11",
"type": "RECALL",
"description": "Das Verfahren ist bereits eingestellt.",
"number": "brak008-45544456",
"contractNumber": "",
"reason": "OTHER"
}
}
Please Note: The confirmation, closing, and other relevant responses can only be retrieved when the client proactively calls the transaction endpoint. Make sure to check the transaction endpoint regularly for status updates.
An accounting document is automatically generated whenever a recall is initiated, whether it is partial or total. This document records the transaction details and helps maintain accurate financial records. An accounting document with the type will be associated with the recall action to ensure proper tracking and compliance. Read our documentation on accounting document to learn more.