Ohjeessa kuvataan, miten myyntilaskut voidaan lähettää vastaanottajille Finago Procountor API -rajapinnan kautta, esimerkiksi kun laskut siirretään ulkoisesta järjestelmästä Procountoriin ja halutaan lähetettää asiakkaille automaattisesti siirron yhteydessä.
Procountorissa myyntilasku on hyväksyttävä ennen sen lähettämistä.
Myyntilaskun lähetysprosessi
POST /invoices luo uuden laskun. Uuden laskun tila on aina aluksi Kesken “UNFINISHED”. Onnistuneesti tallennettu lasku palauttaa laskun tiedot, sisältäen laskun id-tunnisteen. Tätä id-tunnistetta tarvitaan laskun hyväksymiseen ja lähettämiseen.
PUT /invoices/{id}/approve hyväksyy laskun.
PUT /invoices/{id}/send lähettää laskun.
Viitenumeron muodostaminen
Verkkolaskustandardin mukaisesti verkkolaskuilla on oltava mukana viitenumero. Maksutapahtumien kohdistus tapahtuu viitenumeron perusteella. Näin ollen viitenumeron tulee olla myös muilla laskukanavilla tuotavilla laskuilla, mikäli myyntireskontran seuranta tapahtuu Procountorissa.
API -rajapinnan kautta viitenumero muodostuu seuraavasti:
Procountor muodostaa viitenumeron automaattisesti, jos kutsussa tuotava viitenumeron arvo on tyhjä "bankReferenceCode": ""
Toisen järjestelmän muodostama viitenumero voidaan tuoda bankReferenceCode-kentässä. Viitenumeron muoto tarkistetaan.
Jos lasku tuodaan ilman bankReferenceCode-kenttää, se muodostetaan ilman viitenumeroa.
Myyntilaskun lähetyskanavat ja niihin liittyvät rajapintavaatimukset
Käytettävissä olevat laskukanavat (invoiceChannel) ovat:
EMAIL (sähköposti)
MAIL (posti)
ELECTRONIC_INVOICE (verkkolasku)
NO_SENDING (ei lähetetä)
Lisätietoa eri laskukanavista löydät täältä.
Sähköposti
Kun lasku lähetetään sähköpostitse, vastaanottajan sähköpostiosoite (counterParty.email) on pakollinen tieto.
Posti
Laskulle on mahdollista tuoda asiakkaan osoitetiedot (counterParty.counterPartyAddress), laskutusosoite (billingAddress) ja toimitusosoite (deliveryAddress).
Jos laskutusosoitetta ei ole määritetty, käytetään asiakkaan osoitetietoja laskutusosoitteena.
Jos laskutusosoite poikkeaa asiakkaan osoitteesta, tuodaan laskulle erillinen laskutusosoite.
Verkkolasku
Vastaanottajan verkkolaskuosoite tuodaan laskun counterParty.einvoiceAddress -elementissä:
address – vastaanottajan verkkolaskuosoite (pakollinen). Verkkolaskuosoitteen oikeellisuus tarkistetaan.
operator – verkkolaskuoperaattorin välittäjätunnus (pakollinen). Tällä sivulla on listattuna ne verkkolaskuoperaattorit, jotka voi ohjelmassa valita verkkolaskutietoihin.
ediId – OVT-tunnus (valinnainen)
Esimerkki Finago Oy:n verkkolaskuosoitteesta:
"einvoiceAddress": {
"operator": "003723327487",
"address": "003708369224",
"ediId": "003708369224"
}
Verkkolaskun lähettäminen ulkomaille
Ulkomainen verkkolaskuosoite (address) voidaan tuoda 9999-etuliitteen kanssa muodossa 9999verkkolaskuosoite. 9999-alkuosan kanssa käytettynä verkkolaskuoperaattori-kenttä (operator) tuodaan tyhjänä.
Edellyttää, että ympäristö on tuotannossa ja yrityksellä on Finago Apixin verkkolaskujen lähetysosoite käytössä. Koekäyttö -tilassa rajapinta antaa virheilmoituksen.
Esimerkki, kun asiakkaan ulkomainen verkkolaskuosoite on 123456789:
"einvoiceAddress": {
"operator": "",
"address": "9999123456789"
}Tässä artikkelissa käydään tarkemmin läpi, mitä verkkolaskujen lähetyksessä Procountorin kautta ulkomaille tulee huomioida.
Ei lähetetä
Kun laskukanavaksi valitaan Ei lähetetä, laskua ei lähetetä Procountorin kautta. Tätä laskukanavaa voidaan käyttää esimerkiksi tilanteissa, joissa lasku on lähetetty toisesta järjestelmästä.