Buckaroo Support

CM validaties

Validation error messages

 

If a CM scheme action could not be performed due to a validation error, then it will be communicated with an invoice push. For each validation error we encounter in a scheme step, a ValidationErrorMessage will be provided in the push message (e.g. ValidationErrorMessage0 for a first one, ValidationErrorMessage1 for a second one, ValidationErrorMessage2 for a third one, and so on). This will be marked as a CmSchemeValidationError event.

 

In addition to this, Buckaroo will pause the invoice with invoice status code 23 (PausedDueToValidation) in the following situations:

 

  • The initial payment invitation (step 0) could not be performed due to a validation error
  • 0 reminder messages in a scheme step could be performed due to a validation error
  • The invoice could not be transferred to the collection agency due to a validation error

 

In these cases, we mark the event as InvoicePausedDueToValidationErrors.

 

List of actions and possible validation errors:

 

Reminder action:

  • "Required active subscription missing: {service}"
  • "Required data {missingData} missing."

 

Invoice specification:

  • "Attach invoice specification is selected in the scheme version, but no invoice lines exist on the invoice."

 

Stop subscription action:

  • "Invoice {invoiceNumber} (key: {invoiceKey}) does not have a subscription."

 

Transfer to collection agency:

  • "Invoice with no collection agency cannot be transferred to one."
  • "Active subscription missing (that allows {currency}): any collection agency."
  • "Required data is missing. Missing: {missingData1, missingData2, ...}"
  • "For CIB a debtor cannot be younger than 2 years old. Debtor birth date is {birthdate}."
  • "For CIB a debtor cannot be older than 120 years old. Debtor birth date is {birthdate}."
  • "Invoice number is too long. It can only contain a maximum of 20 characters when using Intrum Justitia as collection agency."

 

Furthermore:

 

  • Missing debtor information can be updated with the AddOrUpdateDebtor call or submitted via the Plaza.
  • Missing product lines can be updated with the AddOrUpdateProductLines call.
  • An invoice with invoice status 23 (PausedDueToValidation) can be unpaused at any time and will resume by re-executing the last scheme step.

 

Documentation on https://dev.buckaroo.nl/ updated: