Tässä ohjeessa kerrotaan, miten hyvityslasku luodaan Finago Procountor API-rajapinnan kautta.
Hyvityslaskun muodostaminen API-rajapinnan kautta
Hyvityslaskulle ei ole erillistä API-endpointia tai tunnistetta. API-ajapinnassa hyvityslasku muodostetaan tavallisena laskuna POST /invoices endpointilla.
Laskusta muodostuu hyvityslasku, jos sen loppusumma on negatiivinen. Negatiivinen loppusumma saadaan tuomalla joko rivien määrä (quantity) tai yksikköhinta (unitPrice) negatiivisena.
Rajapinnan kautta ei ole mahdollista muodostaa linkitystä hyhityslaskun ja hyvitettävän laskun välille. Laskun Lisätietoja-kenttään (additionaIInformation) voi halutessaan lisätä vapaamuotoisen tiedon, mitä alkuperäistä laskunumeroa kyseisellä hyvityslaskulla hyvitetään.
Esimerkki hyvityslaskun laatimisesta:
{
"type": "SALES_INVOICE",
"status": "UNFINISHED",
"date": "2025-10-14",
"counterParty": {
"customerNumber": "622",
"identifier": "6152235-5",
"counterPartyAddress": {
"name": "Jannen Jalkineet Oy",
"street": "Tehdaskatu 54",
"zip": "00200",
"city": "Helsinki",
"country": "FINLAND"
},
"einvoiceAddress": {}
},
"paymentInfo": {
"paymentMethod": "BANK_TRANSFER",
"currency": "EUR",
"bankAccount": {
"accountNumber": "FI9499999900028999"
},
"dueDate": "2025-10-24",
"currencyRate": 1.00000000,
"paymentTermPercentage": 0.0000,
"bankReferenceCode": "113191"
},
"deliveryTermsInfo": {},
"extraInfo": {
"accountingByRow": true,
"unitPricesIncludeVat": false
},
"discountPercent": 0.0000,
"invoiceRows": [
{
"product": "Tuote 1",
"productCode": "pr2",
"quantity": -200.000000,
"unit": "PIECE",
"unitPrice": 0.500000,
"discountPercent": 0.0000,
"vatPercent": 25.50
}
],
"vatStatus": 1,
"invoiceChannel": "NO_SENDING",
"penaltyPercent": 7.0000,
"language": "FINNISH",
"additionalInformation": "Hyvitys myyntilaskuun nro 1308",
"vatCountry": "FINLAND"
}Huomioitavaa
Seuraavissa artikkeleissa käsitellään tarkemmin hyvityslaskujen eri tilanteita ja niiden jatkokäsittelyä.