Integraatioaiheet ja mistä ohjeet löytyvät
Tämä artikkeli on opas Maventan integraatiodokumentaatioon. Dokumentaation sivut on ryhmitelty aiheittain yritystileistä sekä laskujen lähettämisestä ja vastaanottamisesta kuluttajalaskutukseen, Peppoliin, laskuformaatteihin, saatavienhallintaan ja integraatiotyökaluihin. Jokaisen linkin yhteydessä kerrotaan lyhyesti, mitä sivulla käsitellään ja milloin tarvitset sitä, joten löydät suoraan oikeat ohjeet.
ℹ️ Tarkat ohjeet jokaiseen integraatioaiheeseen löytyvät Maventan dokumentaatiosta. Dokumentaatio on englanninkielinen. Tässä artikkelissa kerrotaan, mitä kukin aihe kattaa ja milloin tarvitset sitä, joten pääset suoraan oikealle sivulle.
Aloittaminen
- Getting started: integraation vaiheet, tunnisteet, integraatiotasot ja testiympäristö.
- API overview: REST- ja SOAP-rajapinnat, palvelun saatavuus ja huoltokatkot.
Yritystilit ja käyttäjät
- Companies and settings: yritystilien luominen asiakkaillesi, tilien vahvistaminen ja useiden integraatioiden käyttö samalla yrityksellä.
- Users: käyttäjäroolit ja se, mitä kukin rooli voi tehdä.
- Department companies: kun yksi yritys tarvitsee useita erillisiä tilejä.
- Billing: miten Maventa laskuttaa kumppaneita ja miten voit laskuttaa asiakkaitasi.
Laskujen lähettäminen
- Sending invoices: koko lähetysprosessi. Sivulla käsitellään vastaanottajan osoitteen löytämistä, liitteitä, tuplalaskujen estämistä, toimituksen seurantaa ja epäonnistuneiden laskujen käsittelyä.
- Email invoicing: missä tilanteissa Maventa lähettää laskun sähköpostitse ja miten toimitustapa valitaan.
- Printing: laskujen lähettäminen paperisena, ohjeet maittain.
Kuluttajalaskutus
Kuluttajalaskutus toimii jokaisessa maassa eri tavalla. Yritys voi lähettää laskuja kuluttajille vain omassa maassaan.
- Consumer invoicing overview: käytettävissä olevat kanavat ja kaikkia maita koskevat asiat.
- Suomi: e-laskut ja suoramaksut kuluttajien verkkopankkeihin sekä digitaalinen posti.
- Norja: AvtaleGiro, eFaktura verkkopankeissa ja Vippsissä sekä muut kanavat.
- Ruotsi: e-laskut verkkopankkeihin ja digitaalisiin postilaatikoihin.
Laskujen vastaanottaminen
- Receiving invoices: vastaanoton aktivointi, laskujen hakeminen sekä virheiden ja uudelleenyritysten käsittely.
- Scanning: paperi- ja PDF-laskujen muuttaminen verkkolaskuiksi.
- Detect: vastaanotettujen laskujen tarkistukset, jotka auttavat havaitsemaan virheitä ja petoksia.
- Fraud reporting: epäilyttävän laskun ilmoittaminen.
Peppol
- Peppol network: miten Peppol toimii, yritysten rekisteröinti vastaanottajiksi ja mitä tapahtuu, jos toimitus ei onnistu heti.
- Document exchange: muut liiketoiminta-asiakirjat Peppolissa, kuten tilaukset.
- Invoice response: ostajan ja myyjän väliset laskun tilaviestit.
- Self-billing: itselaskutus, jossa ostaja laatii laskun myyjän puolesta.
Laskuformaatit
- Supported formats: Maventan tukemat formaatit esimerkkeineen. Maventa suosittelee Peppol BIS 3.0 -formaattia.
- Peppol BIS 3.0 ja Finvoice: formaattikohtaiset ohjeet.
- Validation: miten Maventa tarkistaa laskut ja miten voit tarkistaa ne itse ennen lähettämistä.
- Document types: laskut, hyvityslaskut ja muut asiakirjatyypit.
Saatavienhallinta
- Accounts receivable services: maksujen seuranta, maksumuistutukset ja perintä perintätoimistojen kautta.
Työkalut integraattoreille
- Webhooks: Maventa lähettää järjestelmällesi ilmoituksen tapahtumista, esimerkiksi uuden laskun saapumisesta. Ohjelmistosi ei siis tarvitse tarkistaa uusia tapahtumia jatkuvasti.
- Embeddable user interface: Maventan käyttöliittymän upottaminen omaan tuotteeseesi.
- Reference implementations: esimerkkikoodia Javalla ja C#:lla. Hyvä lähtökohta, mutta ei valmista tuotantokoodia.
- Maventa Connector: Windows-sovellus, joka siirtää tiedostoja Maventan ja paikallisten kansioiden välillä. Ei suositella uusiin integraatioihin.
Maat
- Services and reach: mitä kussakin maassa on saatavilla, mukaan lukien verkostot, formaatit ja paikalliset vaatimukset.
- Upcoming changes: tulevat muutokset verkkolaskutuksen säännöissä ja verkostoissa.
API-kuvaus ja muutokset
- API documentation: jokainen API-metodi yksityiskohtaisesti.
- Developer changelog: viimeaikaiset muutokset rajapintaan.
- Product changelog: viimeaikaiset muutokset Maventa-palveluun.