Use case
In Finago Procountor, it is possible to enable automatic calculation of collection and penal costs. With this feature, the program automatically calculates the fees accrued from overdue invoices and suggests adding them to the customer’s next invoice.
You can find more information about the steps to enable automatic calculation of collection and penal costs in this article.
Information about using payment reminder and debt-collection services can be found here.
Adding collection and penal expenses to an invoice
When you create an invoice using the POST /invoices API cendpoint, you can automatically add the customer's accrued collection and penal expenses to the invoice by setting the URL parameter addCollectionPenalCosts to true. If the parameter is omitted or set to false (the default), the fees will not be added to the invoice.
POST /invoices/?addCollectionPenalCosts=true
The invoice must be linked to a customer in the customer register using the partnerId (the database ID value).
You can retrieve the partnerId ("id") with the GET /businesspartners API endpoint:
"results": [
{
"id": 7189371,
"name": "Jannen Jalkineet Oy",
"billingAddress": {
"name": "Jannen Jalkineet Oy",
"street": "Purokatu 5",
"zip": "22300",
"city": "Pori"
},
"invoicingInfo": {
"customerNumber": "10",
"identifier": "2528842-6",
"identifierType": "FI"
},
"registryInfo": {
"active": true
},
"type": "CUSTOMER",
"version": "2025-09-16T15:53:57"
},
{
"id": 7189372,
"name": "Suksivuokraamo Oy",
"billingAddress": {
"name": "Suksivuokraamo Oy",
"street": "Metsäpolku 2",
"zip": "90100",
"city": "Kuusamo"
},
"invoicingInfo": {
"customerNumber": "11",
"identifier": "8054400-7",
"identifierType": "FI"
},
"registryInfo": {
"active": true
},
"type": "CUSTOMER",
"version": "2025-09-16T15:58:37"
}
]
If the customer has accrued collection and penal expenses, they will be automatically added as an invoice row on the invoice.
"invoiceRows": [
{
"id": 1425157503,
"productId": 41155111,
"product": "Muistilehtiö",
"productCode": "1234",
"quantity": 10.000000,
"unit": "PIECE",
"unitPrice": 23.00,
"discountPercent": 0.0000,
"vatPercent": 25.50
},
{
"id": 1425157505,
"productId": 43955585,
"product": "Perintäkulut (Laskunumero 4)",
"quantity": 1.000000,
"unit": "NO_UNIT",
"unitPrice": 5.000000,
"discountPercent": 0.0000,
"vatPercent": 0.00,
"comment": "Syyskuu"
}
]
Calculation of penal costs when an invoice is marked as paid via the API
When the automatic handling of collection and penal costs is enabled, Procountor automatically calculates late payment fees based on the settings defined in the sowtware. The calculation takes place if the parameter addPenalExpense is set to true in the PUT /invoices/{invoiceId}/paymentevents/markpaid request. The default value of the parameter is false.
PUT /invoices/54676579/paymentevents/markpaid?addPenalExpense=true
Procountor automatically calculates the number of days the payment was late and this data is recorded in the database.
Other requirements
Accrued collection and penal expenses cannot be retrieved via the API. Invoiced and uninvoiced collection and penalty costs can be inspected on the Collection and penalty fees report.
The report can be accessed in the program under Reports > The collection and penalty fees report.