Tässä artikkelissa kuvataan, miten kuluttajaverkkolaskuja ja suoramaksuja (e-laskuja) voidaan luoda ja lähettää Finago Procountorin API-rajapinnan kautta.
Kuluttajaverkkolaskujen ja suoramaksujen vastaanottoilmoitukset käsitellään Procountorissa. Kuluttajaverkkolaskujen ja suoramaksujen lähettämistä varten Procountorissa on tehtävä tietyt valmistelutoimenpiteet. Tarkemmat ohjeet löydät täältä.
Ennen kuluttajaverkkolaskutuksen ja/tai suoramaksujen käyttöönottoa kuluttaja-asiakkaiden tulee olla luotuna Procountorin asiakasrekisteriin.
Kuluttajaverkkolaskun laatiminen API-rajapinnan kautta
Asiakasrekisterissä ei ole erillistä merkintää tai tunnistetta kuluttajaverkkolaskuja vastaanottaville asiakkaille. Kun vastaanottoilmoitus on käsitelty ja kohdistettu, asiakasrekisteriin tallentuu asiakkaan laskukanavaksi verkkolasku ja vastaanottoilmoituksella tullut verkkolaskuosoite.
Esimerkki asiakkaan tiedoista GET /businesspartners/{id} endpointilla haettuna:
{
"id": 5598778,
"name": "Assi Asiakas",
"type": "CUSTOMER",
"address": {
"name": "Assi asiakas",
"street": "Aleksanterinkatu 32 B",
"zip": "33100",
"city": "Tampere",
"country": "FINLAND"
},
"billingAddress": {},
"deliveryAddress": {},
"invoicingInfo": {
"customerNumber": "4324",
"invoiceChannel": "ELECTRONIC_INVOICE",
"language": "FINNISH",
"denyEinvoiceReminders": false,
"einvoiceAddress": "FI1442143459000095",
"einvoiceOperator": "ITELFIHH"
},
"additionalInfo": {
"invoiceLedger": "INVOICE_LEDGER"
},
"paymentInfo": {
"factoringContractId": null,
"paymentMethod": "BANK_TRANSFER",
"paymentTermDays": "21",
"paymentTermPercentage": 0.0000,
"penalInterestRate": 8.0000,
"discountPercentage": 0.0000,
"currency": "EUR"
},
"registryInfo": {
"active": true,
"reportGroup": "Vuosialennus",
"reportGroupId": 35322,
"partnerGroups": [
{
"id": 34974,
"name": "Opiskelija",
"type": "CUSTOMER",
"active": true
}
]
},
"version": "2025-11-07T18:07:12"
}
Kun uusi lasku luodaan kuluttajaverkkolaskuasiakkaalle API:n kautta, lasku kohdistetetaan asiakasrekisterin asiakkaaseen partnerId:llä (suositeltavin), asiakasnumerolla (customerNumber) tai henkilötunnuksella (identifier).
Laskulle merkitään laskukanavaksi (invoiceChannel) verkkolasku (ELECTRONIC_INVOICE) sekä lisätään asiakkaan verkkolaskuosoite.
Esimerkki kuluttajaverkkolaskuasiakkaalle lähetettävästä laskusta:
{
"partnerId": 5598778,
"type": "SALES_INVOICE",
"status": "UNFINISHED",
"date": "2025-11-07",
"counterParty": {
"customerNumber": "4324",
"counterPartyAddress": {
"name": "Assi asiakas",
"street": "Aleksanterinkatu 32 B",
"zip": "33100",
"city": "Tampere",
"country": "FINLAND"
},
"einvoiceAddress": {
"operator": "ITELFIHH",
"address": "FI1442143459000095"
}
},
"billingAddress": {
"name": "Assi asiakas",
"street": "Aleksanterinkatu 32 B",
"zip": "33100",
"city": "Tampere",
"country": "FINLAND"
},
"deliveryAddress": {},
"paymentInfo": {
"paymentMethod": "BANK_TRANSFER",
"currency": "EUR",
"bankAccount": {
"accountNumber": "xxxx"
},
"dueDate": "2025-11-28",
"currencyRate": 1.00000000,
"paymentTermPercentage": 0.0000,
"bankReferenceCode": ""
},
"deliveryTermsInfo": {},
"extraInfo": {
"accountingByRow": true,
"unitPricesIncludeVat": false
},
"discountPercent": 0.0000,
"invoiceRows": [
{
"productId": 24419285,
"product": "testituote",
"productCode": "TESTPRO",
"quantity": 1.000000,
"unit": "PIECE",
"unitPrice": 88.400000,
"discountPercent": 0.0000,
"vatPercent": 25.50,
"vatStatus": 1
}
],
"vatStatus": 1,
"invoiceChannel": "ELECTRONIC_INVOICE",
"penaltyPercent": 8.0000,
"language": "FINNISH",
"vatCountry": "FINLAND"
}
Suoramaksulaskun laatiminen API-rajapinnan kautta
Kun suoramaksujen vastaanottoilmoitus käsitellään Procountorissa, asiakkaan tiedot päivittyvät asiakasrekisteriin. Ilmoituksen kohdistaminen asiakkaaseen asettaa Maksutapa-kentän (paymentMethod) arvoksi Suoramaksu (DIRECT_PAYMENT) ja lisää asiakkaalle verkkolaskuosoitteen. Tämän jälkeen asiakkaan laskukanavaksi voidaan valita Posti tai Sähköposti.
Esimerkki suoramaksuasiakkaan tiedoista GET /businesspartners/{id} endpointilla haettuna:
{
"id": 5767653,
"name": "Matti Meikäläinen",
"type": "CUSTOMER",
"address": {
"name": "Matti Meikäläinen",
"street": "Testitie 4",
"zip": "40400",
"city": "Jyväskylä",
"country": "FINLAND"
},
"billingAddress": {
"name": "Matti Meikäläinen",
"street": "Testitie 4",
"zip": "40400",
"city": "Jyväskylä",
"country": "FINLAND"
},
"deliveryAddress": {},
"invoicingInfo": {
"customerNumber": "121",
"invoiceChannel": "MAIL",
"language": "FINNISH",
"denyEinvoiceReminders": false,
"einvoiceOperator": "NDEAFIHH",
"einvoiceAddress": "FI9037555380005629"
},
"additionalInfo": {
"invoiceLedger": "INVOICE_LEDGER"
},
"paymentInfo": {
"factoringContractId": null,
"paymentMethod": "DIRECT_PAYMENT",
"bankAccount": "FI9499999900028999",
"paymentTermDays": "10",
"paymentTermPercentage": 0.0000,
"penalInterestRate": 8.0000,
"discountPercentage": 0.0000,
"currency": "EUR"
},
"registryInfo": {
"active": true
},
"version": "2025-11-12T11:26:50"
}
Suoramaksu ("paymentMethod": "DIRECT_PAYMENT") maksutavan tuominen laskulle APIn kautta edellyttää, että asiakkaalle on Procountorissa kohdistettu suoramaksujen vastaanottoilmoitus.
Lasku kohdistetaan suoramaksuasiakkaaseen partnerId-tunnisteen avulla.
Kun maksutapana on Suoramaksu, laskukanavan (invoiceChannel) tulee olla Posti (MAIL) tai Sähköposti (EMAIL). Tämä laskukanava määrittää, mitä kautta asiakkaalle lähetetään suoramaksusta kertova lasku.
Kutsuun tulee lisäksi lisätä counterParty:n sisälle elementtiin einvoiceAddress verkkolaskuosoite ja -operaattori, jotka on tallennettu asiakkaan tietoihin Asiakasrekisterissä. Suoramaksulaskutiedot lähetetään pankille ko. verkkolaskuosoitteeseen.
Esimerkki suoramaksuasiakkaalle lähetettävästä laskusta:
{
"partnerId": 5767653,
"type": "SALES_INVOICE",
"status": "UNFINISHED",
"date": "2025-11-12",
"counterParty": {
"customerNumber": "121",
"counterPartyAddress": {
"name": "Matti Meikäläinen",
"street": "Testitie 4",
"zip": "40400",
"city": "Jyväskylä",
"country": "FINLAND"
},
"einvoiceAddress": {
"operator": "NDEAFIHH",
"address": "FI9037555380005629"
}
},
"billingAddress": {
"name": "Matti Meikäläinen",
"street": "Testitie 4",
"zip": "40400",
"city": "Jyväskylä",
"country": "FINLAND"
},
"deliveryAddress": {},
"paymentInfo": {
"paymentMethod": "DIRECT_PAYMENT",
"currency": "EUR",
"bankAccount": {
"accountNumber": "FI9499999900028999"
},
"dueDate": "2025-11-22",
"currencyRate": 1.00000000,
"paymentTermPercentage": 0.0000,
"bankReferenceCode": "113463"
},
"deliveryTermsInfo": {},
"extraInfo": {
"accountingByRow": true,
"unitPricesIncludeVat": false
},
"discountPercent": 0.0000,
"invoiceRows": [
{
"productId": 22236030,
"product": "Tuote",
"productCode": "1234a",
"quantity": 1.000000,
"unit": "NO_UNIT",
"unitPrice": 100.000000,
"discountPercent": 0.0000,
"vatPercent": 25.50
}
],
"vatStatus": 1,
"invoiceChannel": "MAIL",
"penaltyPercent": 8.0000,
"language": "FINNISH",
"vatCountry": "FINLAND"
}