1. Home
  2. Documentation
  3. Debt collection (voucher status)

Debt collection (voucher status)

If your integration is listed as a debt collector with Tripletex you will gain access to the voucherStatus endpoint. This in turn allows your integration to fetch invoices via the invoice endpoint and then set status on the invoice voucher if/when debt collection is started via voucherStatus.

This makes it possible for you to communicate updates along the debt collection process to the customer directly in Tripletex. Note that the customer can not start the debt collection in Tripletex in these cases, and you need to fetch all invoices using the existing parameters in the invoice endpoint. Access to voucherStatus does not mean your debt collection agency will be visible in the list of debt collection agencies within Tripletex.

When debt collection is initiated on an invoice you should mark the invoice as such, this is explained further below. As soon as a status is sent to an invoice voucher it will look like this in GUI:

A new line is added below the invoice itself showing that debt collection has started, your debt collection agency and the statuses you have posted to the invoice voucher.

This is achieved by posting a status on the voucher connected to the invoice. The status must be of type DEBT_COLLECTION and normally you would start with the status PROCESSING.

To be able to post voucher status on a client you need to have an api consumerId and you need to be registered in our api debt collector list.

You also need an employee token from the customer created for your api consumer.

VoucherStatuses are immutable to keep track of history internally. The latest voucherStatus is the one that is relevant to you and the one you get in the API. Therefore we use POST not UPDATE.

Error handling:
If a invoice is missing data or for some other reason you are not able to process the invoice, you should post a voucherStatus back with status ERROR and use the comment field to give a helpful message to the customer. When this is done the debt collection case will be deleted from our system, the customer will be notified and the comment will be shown to the customer.

Communicating with the customer:

The status field of the latest voucherStatus will be shown to the customer and comments from all voucherStatuses. You can use externalObjectUrl and referenceNumber to link to the case in your system.

Complete a debt collection with the status DONE.