Laskunvienti Dineroon (API)

Voit yhdistää (integroida) Opterin Dineroon, www.dinero.dk. Sen jälkeen voit viedä laskuja Opterista Dineroon.

Jokaisesta viedystä laskusta luodaan Dinerossa manuaalinen tosite (voucher). Se sisältää siirrettävän tiliöinnin jokaisen tiliöintirivin. Manuaalisen tositteen liitteenä on kopio Opterin laskusta PDF-muodossa.

Seuraavat tiedot lähetetään Dineron tositteen mukana:

• Y-tunnus sellaisena kuin se näkyy Dinerossa ("organisationId").

• Laskun päivämäärä, ("voucherDate").

• Tilinumero tilirivillä ('accountNumber').

• Koodausrivin määrä ('määrä').

• Koodausrivillä olevan tilin alv-koodi ('accountVatCode').

• Yrityksesi Dinerossa käyttämä taseselvitystilin numero ("balancingAccountNumber").

• Yrityksesi Dinerossa käyttämän tasetilin alv-koodi ("balancingAccountVatCode").

• Linkki liitteenä olevaan PDF-muotoiseen Opter-laskuun.

• Koodausrivin kuvaus ('description'). Opter lähettää kuvauksessa laskunumeron, tilausnumeron ja laskun päivämäärän.

  Dineron API:ssa ei ole kenttää laskunumerolle. Sen sijaan Opter lähettää laskunumeron kentissä description- ja externalReference, jotta Opterin laskunumero näkyy ainakin Dinero-ohjelmistossa.

• Teksti "Opter-lasku" ja laskun numero, joka laskulla on Opterissa ("externalReference").

Huomioi seuraavat seikat

Dineron API:in liittyy joitakin rajoituksia. Opter to Dinero -seteliin ei voi sisällyttää seuraavia tuotteita:

• Asiakaskoodi, reskontranumero, laskutusosoite.

  Suosittelemme pitämään asiakastiedot ajan tasalla sekä Opterissa että Dinerossa.

• Tulosyksikkö.

  Suosittelemme pitämään tulosyksikkötiedot ajan tasalla sekä Opterissa että Dinerossa.

• Valuuttakoodi ja valuuttakurssi.

  Dinero ei tue laskuissa muita valuuttoja. Älä käytä Opterissa olevaa asiakkaan valuutan valitsemistoimintoa, jos käytössä on Dinero-taloushallintojärjestelmä.

  Lisätietoa: Valuutta ja valuuttakoodit ja Valuuttakurssi jäljempänä.

• Laskunumero. (Dineron API:ssa ei ole kenttää laskunumerolle. Sen sijaan Opter lähettää laskunumeron kentissä description- ja externalReference, jotta Opterin laskunumero näkyy ainakin Dinero-ohjelmistossa.)

• Maksuehto.

• Jne.

Edellytykset

Valuutta ja valuuttakoodit

Dinerossa valuutta valitaan laskuasetuksissa. Siellä valittua valuuttaa käytetään jokaiselle laskulle Dineroon laskun viennin yhteydessä lähetettävässä manuaalisessa tositteessa.

Valuuttakoodeja (esimerkiksi ”DKK”, ”SEK” ja ”EUR”) ei lähetetä Dineroon lähetettävässä manuaalisessa tositteessa.

Valuuttakurssi

Syötä Dineroon ja Opteriin täsmälleen samat valuuttakurssit. Jos haluat päivittää valuuttakurssia, päivitä se sekä Dinerossa että Opterissa.

• Opterissa valuuttakurssit määritetään kohdassa Hallinto > Valuutat välilehdellä Valuuttakurssit.

• Dinerossa käytetyn valuuttakurssin näet Dineron laskuasetuksissa.

Tilinumero

Opterissa käytettävien tilinumeroiden tulee löytyä myös Dinerosta.

OCR-numero

OCR-numeroa ei lähetetä Dineroon lähetettävässä manuaalisessa tositteessa.

Vaihe 1: Luo API-käyttäjätili Visma Connectissa

Jotta voit viedä laskuja Dineroon API:n kautta, tarvitaan seuraavat tiedot (jotka syötetään Opteriin kohdassa Vaihe 2: Luo laskun vienti Opterissa alla):

• ”Client_id” (käyttäjätunnus) API-käyttäjätilille.

• ”Client_secret” (API-avain) API-käyttäjätilille.

• ”Redirect URI”. (Redirect URI on sijainti, johon käyttäjä ohjataan Dineron API:hin kirjautumisen jälkeen. Tarvitaan siis verkkopalvelin, jolle voidaan lähettää todennuksen tuottamat tiedot.)

Noudata osoitteessa https://developer.dinero.dk/documentation/getting-started/ annettuja ohjeita. Jos sinulla on kysyttävää, ota yhteyttä Visma Connectiin tai Dineroon.

Vaihe 2: Luo laskunvienti Opterissa

Napsauta Hallinto > Laskut > Laskunvienti ja luo uusi laskun vienti napsauttamalla Uusi. Seuraavat kentät on täytettävä välilehdellä Yleinen:

• Nimi: Esimerkiksi ”Dinero (API)”.

• Laji: Dinero API.

• Merkkikoodaus: UTF-8.

• Käyttäjätunnus: Edellä vaiheessa 1 luomasi API-käyttäjätilin ”Client_id”.

• Salasana: "Client_secret" (API-avain) API-käyttäjätilille, jonka loit osoitteessa Step 1: Luo API-tili Visma Connectissa edellä.

• Toimiston koodi: Y-tunnus Dineroon syötetyssä muodossa (”organisationId”), jossa se saadaan vastaamaan laskunviennin tietoja.

• Aloitusteksti: Kenttään syötetään seuraavat tiedot:

  • "Redirect URI", jonka olet saanut Dinerolta osoitteessa Step 1: Luo API-tili Visma Connectissa edellä.

  • Dinerossa oleva ”BalancingAccountNumber”.

  Kirjoita jokainen asetus omalle rivilleen, kuten esimerkissä alla.

  1
  2
  RedirectUri=http://localhost:44303
  BalancingAccountNumber=55000

Vaihe 3: Käännä Opterin ALV-koodit

Dineroon lähetettävässä manuaalisessa tositteessa jokainen tiliöintirivi sisältää tilinumeron ja ALV-koodin. Opterissa käytettävien tilinumeroiden on oltava olemassa Dinerossa, ja jokaisella tilillä on oltava sama ALV-koodi kummassakin järjestelmässä.

Dinerossa ALV-koodit (ALV-kannat) ovat kohdassa ”Indstillinger” -> ”Momssatser”.

Opterin ALV-koodit (ALV-kannat) on käännettävä ALV-koodeiksi, joita Dinero käyttää. Tee näin:

1. Napsauta Opterin ikkunassa Laskunvienti välilehteä Koodeja ja valitse Verokannat pudotusvalikosta.

2. Täytä Dineron ALV-koodit sarakkeeseen Koodi jokaiselle Opterista löytyvälle ALV-kannalle.

3. Tallenna muutokset valitsemalla Tallenna.

Vaihe 4: Lisää laskunvienti laskunvientiasetuksiin

1. Valitse Hallinto > Laskut > Laskunvientiasetukset.

2. Valitse ja anna vientiasetuksille nimi (esimerkiksi ”Dinero API”). Valitse ”Dinero API” (tai nimi, jonka annoit laskunviennille) kohdassa Viennit.

3. Tallenna muutokset valitsemalla Tallenna.

4. Valitse, mitä laskunvientiä käytetään oletuksena. Valitse Dinero API oletukseksi merkitsemällä ”Dinero API” vasemmalla olevassa luettelossa ja napsauta kohtaa .

5. Sen varmistamiseksi, että kaikki laskut kirjataan kirjanpitoon Dinerossa, valitse ”Dinero API” -vienti kaikkiin vientiasetuksiin.

6. Tallenna muutokset valitsemalla Tallenna.

Vaihe 5: Laskujen vienti Dineroon

Voit viedä laskutiedot Opterista laskutuskauden sulkemisen yhteydessä tai sen jälkeen, kun olet valinnut, haluatko viedä kokonaisia laskutuskausia vai yksittäisiä laskuja.

1. Valitse Hallinto > Laskut > Laskut.

2. Valitse lasku tai laskutuskausi, jonka haluat viedä, napsauta sitä hiiren kakkospainikkeella ja valitse Vie.

3. Valitse Vie ja lähetä.

   Selain avautuu. Kirjaudu sisään Visma Connect -tililläsi.

   Näyttöön avautuu seuraava ikkuna:

   

4. Valitse ”Accept”. (Hyväksyt sen, että Visma Connectissa Dineroon yhdistetty integraatio voi lähettää tietoja Dineroon. Muussa tapauksessa vientiä Dineroon ei voi tehdä.)

   Kun olet napsauttanut ”Accept”-painiketta, vienti Dineroon alkaa.

   Opterin ikkunassa Laskunvienti näytetään vietävien ja vietyjen laskujen määrä sekä edistymisosoitin (ikkunan alareunassa). Kun laskunvienti on valmis, koko edistymispalkki on vihreä. Jos laskunvienti epäonnistuu, edistymispalkin väri on harmaa.

Kun viet laskuja Dineroon, tapahtuu seuraavaa:

• Ennen laskujen vientiä Opter tarkistaa kaikkien laskujen tiliöintirivien kaikki tilit. Lisätietoa on jäljempänä olevassa kohdassa Laskunviennin yksityiskohtainen kuvaus.

• Dinero ei tue kaikkien mahdollisesti tarvittavien tietojen esittämistä kuljetuslaskussa. Näitä tietoja ovat esimerkiksi lähettäjä, vastaanottaja, välimatka, paino ja rahtikirjan numero. Siksi Opterissa luodaan kaikki tiedot sisältävä graafinen lasku, joka lähetetään Dineroon automaattisesti PDF-tiedostona.

• Löydät Dineroon viemäsi laskut Dinerosta valitsemalla ”Bogföring” ja ”Bilagsarkiv”.

  Vasemmalla näkyy graafinen lasku (joka lähetettiin PDF-tiedostona). Oikealla näkyy laskulle luotu manuaalinen tosite.

• Jos vienti Dineroon ei onnistu, näyttöön tulee virheviesti. Katso jäljempänä oleva kohta Virheviestit.

Vianetsintä

Yksityiskohtainen kuvaus laskujen viennistä

Kun viet laskuja Dineroon, tapahtuu (automaattisesti) seuraavaa:

1. Opter tarkistaa, että kenttään Aloitusteksti ikkunassa Laskunvienti on määritetty ”BalancingAccountNumber”. (Katso Vaihe 2: Luo laskun vienti Opterissa edellä.)

   Jos sitä ei ole, näyttöön tulee virheviesti Balancing account -tili puuttuu..

2. Opter tarkistaa, että kentässä Aloitusteksti oleva ”BalancingAccountNumber” on Dinerossa.

   Jos sitä ei ole, näytetään virheviesti Ilmoitettua balancing account -tiliä ({0}) ei ole Dinerossa. Kentässä Aloitusteksti oleva ”BalancingAccountNumber” näytetään virheviestissä suluissa ”{ }”.

3. Opter tarkistaa, että tiliöintirivien tilit on syötetty oikein.

   Jos ne on syötetty väärin, näytetään virheviesti Virheellinen tilinumero. Tarkista käytettävissä olevat tilit Dinerossa.

   (Opterin tilinumeroissa saattaa esimerkiksi olla sekaisin kirjaimia ja numeroita, ”xx (2000)”.)

4. Opter tarkistaa, että tiliöintirivien tilit ovat Dinerossa.

   Jos tiliä ei ole Dinerossa, näytetään virheviesti Dinero-tili puuttuu. Tarkista käytettävissä olevat tilit Dinerossa.

5. Opter noutaa laskutiedot Opterin tietokannasta (vietävien laskujen osalta).

   Jos sitä ei ole, näyttöön tulee virheviesti Virhe haettaessa laskujen tietoja.

6. Opter luo graafisesta laskusta PDF-tiedoston, jossa on kaikki Opterissa olevat tiedot.

   Jos PDF-tiedoston koko on yli 6 Mt, Opter yrittää pienentää tiedoston kokoa. (PDF-tiedosto liitetään laskua varten luotavaan manuaaliseen tositteeseen. Liitetiedostojen enimmäiskoko on 6 Mt.)

7. Opter lataa PDF-tiedoston Dineroon.

   Jos se ei onnistu, näyttöön tulee API:n virheviesti. API:n virheviestit on koottu tänne: https://developer.dinero.dk/documentation/error-and-status/.

8. Opter luo jokaiselle vietävälle laskulle manuaalisen tositteen (voucher). Se sisältää siirrettävän tiliöinnin.

9. Opter liittää PDF-tiedoston (jossa on graafinen lasku) tähän manuaaliseen tositteeseen.

10. Manuaalinen tosite kirjataan Dinerossa.

    Manuaalinen tosite vaikuttaa kirjanpitoon Dinerossa vasta sen jälkeen, kun Opter on kirjannut sen Dinerossa.

Virheilmoitukset

Jos vienti Dineroon ei onnistu, näyttöön tulee virheviesti. Virheilmoitus näytetään vain, jos vienti epäonnistuu ja tapahtuu virhe. Virheilmoitukset näytetään ponnahdusikkunassa, eikä sitä tallenneta mihinkään.

Virheviesti	Selitys
Dineroon kirjautuminen ei onnistunut. Tarkista käyttäjätiedot.	Dineroon kirjautuminen epäonnistui. Varmista, että sähköpostiosoite ja salasana on kirjoitettu oikein. Ota tarvittaessa yhteyttä Visma Connectiin tai Dineroon.
Visma Connect ei voinut valtuuttaa käyttäjää.	Varmista, että sähköpostiosoite ja salasana on kirjoitettu oikein. Ota tarvittaessa yhteyttä Visma Connectiin tai Dineroon.
Balancing account -tili puuttuu.	”BalancingAccountNumber” puuttuu kentästä Aloitusteksti ikkunassa Laskunvienti. (Katso Vaihe 2: Luo laskun vienti Opterissa edellä.)
Ilmoitettua balancing account -tiliä ({0}) ei ole Dinerossa.	Kentässä Aloitusteksti oleva ”BalancingAccountNumber” puuttuu Dinerosta. (Katso Vaihe 2: Luo laskun vienti Opterissa edellä.) Kentässä Aloitusteksti oleva ”BalancingAccountNumber” näytetään virheviestissä suluissa ”{ }”.
Virheellinen tilinumero. Tarkista käytettävissä olevat tilit Dinerossa.	Tiliöintirivin tiliä ei ole syötetty oikein Opterissa. Opterin tilinumeroissa saattaa esimerkiksi olla sekaisin kirjaimia ja numeroita, ”xx (2000)”.
Dinero-tili puuttuu. Tarkista käytettävissä olevat tilit Dinerossa.	Tiliöintirivien tilejä ei ole Dinerossa. Opterissa käytettävien tilinumeroiden tulee löytyä myös Dinerosta.
Virhe haettaessa laskujen tietoja	Jokin menee pieleen, kun Opter yrittää noutaa laskutiedot Opterin tietokannasta (vietävien laskujen osalta).
Virhe API-kutsussa	Opter saa virheviestin Dinero API:lta ja näyttää sen. Virheviestit on koottu tänne: https://developer.dinero.dk/documentation/error-and-status/

Pyydä apua käyttöönottovastaavalta

Jos sinulla on kysyttävää tai tarvitset tukea aloittamiseen, ota yhteyttä ja varaa aika käyttöönottovastaavan kanssa.