Tässä artikkelissa kuvataan automaattisen perintä- ja viivästyskulujen laskennan käyttö Finago Procountorin API-rajapinnan kautta.
Procountorissa on mahdollista ottaa käyttöön automaattinen perintä- ja viivästyskulujen laskenta, jonka myötä ohjelma laskee automaattisesti kertyvät kulut myöhässä maksetuista laskuista ja ehdottaa niitä lisättäväksi kyseisen asiakkaan seuraavalle laskulle.
Automaattisen perintä- ja viivästyskululaskennan käyttöönoton vaiheista lisää tässä artikkelissa.
Perintäkumppaneiden huomautus- ja perintäpalveluiden käytöstä kerrotaan tarkemmin täällä.
Viivästyskorkojen ja maksumuistutusmaksujen lisääminen laskulle
Kun lasku luodaan POST /invoices -rajapintakutsulla, mahdolliset perintä- ja viivästyskulut voidaan lisätä laskulle automaattisesti asettamalla URL-parametri addCollectionPenalCosts arvoon true. Jos parametri jätetään pois tai sen arvo on false (oletusarvo), kuluja ei lisätä laskulle.
POST /invoices/?addCollectionPenalCosts=true
Lasku on kohdistettava asiakasrekisterin asiakkaaseen partnerId:llä eli kannan ID arvolla.
PartnerId:n ("id") saa haettua GET /businesspartners -rajapintakutsulla:
"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"
}
]
Jos asiakkaalle on kertynyt perintäkuluja tai viivästyskuluja, ne lisätään automaattisesti laskun tuoteriviksi:
"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"
}
]
Viivästyskulujen laskesta, kun lasku merkitään maksetuksi API-rajapinnan kautta
Kun perintä- ja viivästyskuluominaisuus on käytössä, Procountor laskee automaattisesti mahdolliset viivästyskulut ohjelmaan määritettyjen asetusten perusteella. Laskenta tapahtuu, jos PUT /invoices/{invoiceId}/paymentevents/markpaid -kutsussa parametrin addPenalExpense arvoksi annetaan true. Parametrin oletusarvo on false.
PUT /invoices/54676579/paymentevents/markpaid?addPenalExpense=true
Tieto viivästyskuluista jää ohjelmaan muistiin.
Huomioitavaa
Kertyneitä perintä- ja viivästyskuluja ei saa haettua rajapinnan kautta. Procountorin Perintä- ja viivästyskuluraportti näyttää asiakkaittain veloittamattomat ja veloitetut perintä- ja viivästyskulut.
Raportille pääsee ohjelman kohdasta Raportointi > Perintä- ja viivästyskuluraportti.