Yleisimmät integraatio-ongelmat ja niiden ratkaisut

• Kirjautuminen ja käyttöoikeudet
• Yritystilit
• Testiympäristö
• Laskujen lähettäminen
• Peppol
• Laskujen vastaanottaminen
• Kuluttajalaskutus Suomessa
• Palvelun saatavuus

Moneen integraatiokysymykseen löytyy nopea vastaus. Tarkista tämä lista ennen kuin otat yhteyttä tukeen. Jokaisen vastauksen lopussa on linkki dokumentaatioon, josta löydät lisätietoja.

Kirjautuminen ja käyttöoikeudet

”USER NOT FOUND”
Testi- ja tuotantoympäristöllä on eri API-avaimet, eivätkä toisen ympäristön avaimet toimi toisessa. Tarkista, että avaimesi kuuluvat siihen ympäristöön, jota kutsut. Lue lisää.

”401 Unauthorized” laskuja lähetettäessä tai vastaanotettaessa
Kun ohjelmistosi kirjautuu Maventaan, se pyytää tarvitsemansa oikeudet. Jos se ei pyydä oikeutta lähettää tai vastaanottaa laskuja, nämä pyynnöt hylätään. Tarkista myös, onko kirjautuminen vanhentunut: kirjaudu uudelleen ja yritä vielä kerran. Jos saat saman virheen uudelleen, tarkista tunnisteesi. Lue lisää.

Käyttäjä ei voi muuttaa yrityksen asetuksia
Integraation oikeudet riippuvat sen käyttäjän roolista, jona integraatio kirjautuu. Käyttäjät, joilla ei ole pääkäyttäjän roolia, eivät voi muuttaa yrityksen tietoja tai asetuksia. Lue lisää käyttäjärooleista.

”vendor_api_key_missing”
Jokainen pyyntö tarvitsee vendor API keyn. Tarkista, että ohjelmistosi lähettää sen kirjautuessaan.  Lue lisää.

Yritystilit

Uutta yritystiliä ei voi vielä käyttää
Yritystiliä ei voi käyttää täysimääräisesti ennen kuin yritystä edustamaan oikeutettu henkilö on vahvistanut sen. Vahvistustapa riippuu yrityksen maasta. Lue lisää.

Vahvistus allekirjoitettiin testiympäristössä, mutta tila ei muuttunut
Testiympäristössä tila päivittyy eri tavalla kuin tuotannossa. Lue lisää.

Vanhaa laskua ei löydy
Maventa säilyttää laskuja kuluvan ja edellisen vuoden ajan, eli noin kaksi vuotta. Maventa ei ole pitkäaikainen arkisto, joten tallenna laskut omaan järjestelmääsi, jos tarvitset niitä pidempään. Lue lisää.

Testiympäristö

Testilasku näkyy lähetettynä, mutta se ei koskaan saapunut
Sähköposti-, tulostus- ja kuluttajareitit sekä ulkoisten operaattoreiden reitit Suomessa ja Ruotsissa ovat testiympäristössä vain simuloituja. Peppol-testilähetykset ja lähetykset Maventa-tilien välillä toimivat kuten tuotannossa. Jos haluat testata oikeaa sähköpostitoimitusta, ota yhteyttä Maventan tukeen. Lue lisää.

Testitiedot ovat kadonneet
Testiympäristö voidaan tyhjentää ilman ennakkoilmoitusta. Älä säilytä siellä mitään, mitä tarvitset myöhemmin.

Visma Signin kutsu ei ole saapunut
Tarkista ensin, että allekirjoittajan sähköpostiosoite on kirjoitettu oikein eikä siinä ole kirjoitusvirheitä. Jos osoite oli väärä, lähetä uusi kutsu oikeaan osoitteeseen. Testiympäristössä Visma Signin allekirjoituskutsun saapuminen voi joskus kestää useita tunteja. Jos osoite on oikein, odota kutsua rauhassa ennen kuin lähetät uuden, ja tarkista myös roskapostikansio. Uuden kutsun lähettäminen peruu aiemman kutsun, joten myöhemmin saapuvaa vanhaa kutsua ei voi enää käyttää. Jos olet lähettänyt useamman kutsun, käytä aina uusinta. Kutsu on voimassa 7 päivää. Lue lisää.

Laskujen lähettäminen

Lasku on ollut pitkään tilassa ”Pending”
Laskut lähtevät yleensä noin 10 minuutissa. Kuukauden vaihteessa ja muina ruuhka-aikoina lähettäminen voi kestää muutaman tunnin. Lasku voi olla odottavassa tilassa myös tarkoituksella, esimerkiksi kun Maventa yrittää Peppol-toimitusta uudelleen. Odottavat laskut eivät katoa: Maventa seuraa niitä, ja ne lähtevät, kun ongelma on ratkaistu. Älä lähetä laskua uudelleen. Lue lisää.

Lasku epäonnistui
Lasku merkitään epäonnistuneeksi vasta, kun kaikkia mahdollisia toimitusreittejä on yritetty. Toimi syyn mukaan:

• Väärä osoite: korjaa osoite ja lähetä sama lasku oikeaan osoitteeseen.
• Toimitusreittiä ei ole saatavilla: lähetä lasku toista reittiä, esimerkiksi sähköpostilla tai tulostuspalvelun kautta.
• Laskun sisältö ei ole kelvollinen: korjaa lasku ja lähetä se uutena laskuna.

Voit myös ottaa käyttöön sähköposti-ilmoitukset epäonnistuneista laskuista. Lue lisää.

Lasku lähetettiin vahingossa
Lähetettyä laskua ei voi perua Maventan kautta, koska se on jo luovutettu toimitettavaksi. Lähetä sen sijaan hyvityslasku tai sovi laskun perumisesta suoraan vastaanottajan kanssa. Lue lisää.

”DUPLICATE INVOICE NUMBER”
Yrityksellä on käytössä tuplalaskujen esto, ja samalla numerolla on lähetetty lasku viimeisen 7 päivän aikana. Lue lisää.

Liite hylättiin
Yksittäisen liitteen koko voi olla enintään 10 Mt ja koko laskun enintään 100 Mt. Tiedostonimissä saa olla vain kirjaimia A–Z, numeroita, pisteitä ja alaviivoja, ja nimen pituus voi olla enintään 50 merkkiä. Lue lisää.

Lasku lähti sähköpostilla tai tulostettuna verkkolaskun sijaan
Jos laskua ei voi toimittaa verkkolaskuna, Maventa kokeilee muita reittejä tietyssä järjestyksessä. Voit estää reitit, joita et halua käyttää. Lue lisää.

Peppol

Yrityksen rekisteröinti Peppol-vastaanottajaksi epäonnistuu
Yritys voi olla rekisteröitynä Peppoliin vain yhden palveluntarjoajan (Access Point) kautta kerrallaan. Jos yritys on jo rekisteröity toisen palveluntarjoajan kautta, sen täytyy ensin pyytää kyseistä palveluntarjoajaa poistamaan rekisteröinti. Lue lisää.

Peppol-laskun toimitus kestää pitkään
Jos vastaanottajan palveluntarjoajalla on tilapäinen ongelma, Maventa yrittää toimitusta automaattisesti uudelleen noin kahden päivän ajan ennen kuin lasku merkitään epäonnistuneeksi. Älä lähetä laskua uudelleen, kun toimitus on vielä kesken. Lue lisää.

Laskujen vastaanottaminen

Laskuja puuttuu ohjelmistostasi
Jos käytät webhookeja ja järjestelmäsi ei ollut käytettävissä, Maventa yrittää lähettää ilmoituksen uudelleen kerran tunnissa enintään 24 tunnin ajan. Tarkista uudet laskut varmuuden vuoksi kerran päivässä, jotta mikään ei jää huomaamatta. Lue lisää.

Sama lasku saapuu kahdesti
Kaksoiskappaleet voivat johtua toistuvista ilmoituksista tai päällekkäisistä tarkistuksista. Pidä kirjaa jo käsittelemistäsi laskuista. Lue lisää.

Vastaanotettua laskua ei voi hakea haluamassasi formaatissa
Hae lasku sen alkuperäisessä formaatissa tai Peppol BIS 3.0 -muodossa. Lue lisää.

Listalla näkyy toisen integraation laskuja
Jos yritys käyttää useita integraatioita, ne jakavat saman yritystilin. Asetukset, laskulistat ja webhookit ovat yhteisiä. Jos kahden eri kumppanin tuotteet hakevat saman vastaanotetun laskun, kumpaakin kumppania laskutetaan siitä. Lue lisää.

Kuluttajalaskutus Suomessa

Kuluttajaverkkolaskutus ei ole vielä alkanut
Pankkiverkkoyhteyden avaaminen kestää yleensä muutaman päivän. Sen jälkeen lähettäjäilmoitusten (SI-sanomat, joilla yritys ilmoittautuu pankeille e-laskuttajaksi) perillemeno voi kestää 1–4 pankkipäivää, ja virheilmoitukset voivat saapua vielä useita päiviä lähettämisen jälkeen. Lue lisää.

Kuluttajan e-lasku epäonnistui
Kuluttaja on voinut lopettaa e-laskusopimuksensa. Hae uusimmat vastaanottoilmoitukset (RI-sanomat, joilla pankki kertoo kuluttajan aloittaneen tai lopettaneen e-laskun vastaanoton) ja tarkista, onko joukossa lopetus. Lue lisää.

Palvelun saatavuus

”503 Service unavailable” tai ei vastausta
Tarkista tilanne osoitteesta status.visma.com kohdasta Common Services (Maventa / Visma .net AutoInvoice). Odota ja yritä uudelleen, ja pidennä odotusaikaa jokaisen yrityksen välillä. Lue lisää.

”429 Too many requests”
Ohjelmistosi lähettää pyyntöjä liian usein. Odota ennen kuin yrität uudelleen. Jos et käytä webhookeja, tarkista uudet laskut enintään kerran tai kahdesti päivässä. Lue lisää.

Palomuuri estää yhteydet
Maventan IP-osoitteet voivat muuttua ilman ennakkoilmoitusta, joten IP-osoitteisiin perustuvia palomuurisääntöjä ei suositella. Lue lisää.

Jokin lakkasi toimimasta päivityksen jälkeen
Tarkista viimeaikaiset muutokset kehittäjien muutoslokista (Developer Changeog) ja tiedotteista.