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
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
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.
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
referenceNumber to link to the case in your system.
Complete a debt collection with the status