Viimeisin päivitys: 27.02.2025

Voimassa alkaen: 2024.12.15

Laskunvienti Duettiin (API)

Voit yhdistää (integroida) Opterin Duett-taloushallintojärjestelmään. Sen jälkeen voit viedä laskuja Opterista Duettiin. Lisätietoja Duettista on saatavilla osoitteessa duett.no.

Kun viet laskun Opterista Duettiin, tapahtuu seuraavaa:

  • Tiliöinti viedään.

    Jokaisesta viedystä laskusta luodaan Duettissa tosite (voucher). Se sisältää siirrettävän tiliöinnin jokaisen tiliöintirivin. Tositteeseen liitetään kopio Opter-laskusta PDF-muodossa, jos olet merkinnyt valintaruudun Sisällytä PDF-kopio. (Lisätietoja on jäljempänä olevassa kohdassaVaihe 1).

  • Asiakastiedot viedään ja päivitetään Duettiin, ellei toimintoa kytketä pois käytöstä kentän Aloitusteksti asetuksilla. (Lisätietoa: Vaihe 1 jäljempänä.)

Edellytykset

Duett-käyttäjätili

Jotta voit yhdistää (integroida) Opterin Duettiin, sinulla on oltava käyttäjätili Duettissa. Ota yhteyttä Duettiin, jos tarvitset lisätietoja.

Tilinumero

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

Laskunumero ja laskunumerosarja

Duett hyväksyy Opterin laskunumerot. Suosittelemme varmistamaan, että Opterissa luotujen laskujen numerot eivät ole ristiriidassa suoraan Duettissa luotujen laskujen numeroiden kanssa. Voit ratkaista tämän käyttämällä eri laskunumerosarjoja Opterissa ja Duettissa.

Postinumero

Opterissa laskutettavien norjalaisten asiakkaiden postinumeroiden on oltava Duettin postinumerorekisterissä.

Duett ei salli postinumeroiden lisäämistä asiakasohjelman tai API-kutsujen kautta. Jos viennin aikana näytetään virheilmoitus Postinumero {0} puuttuu Duettista, voit tehdä jommankumman tai molemmat seuraavista:

  • Muuta postinumero Opterissa niin, että se vastaa postinumeroa Duettissa. Vie lasku sitten uudelleen.

  • Poista asiakkaiden päivitys käytöstä asettamalla createCustomers=false ja updateCustomers=false (Vaihe 1 alla) ja päivitä asiakastiedot Opterissa ja Duettissa manuaalisesti.

    Vie lasku sitten uudelleen.

Valuutta ja valuuttakoodit

Duett on tarkoitettu Norjan markkinoille, ja siinä käytetään Norjan kruunuja. Duett ja Opter käyttävät samoja valuuttakoodeja.

Tulosyksiköt

Opterissa tulosyksiköt ovat kohdassa Asetukset > Toimistot välilehdellä Hallinto. Jos Opterissa käytettäviä tulosyksiköitä ei ole Duettissa, Opter yrittää luoda ne Duettiin.

Opterissa voit nähdä eri osastojen koodit (arvot) tulosyksikön alla valitsemalla Hallinto> Tulosyksiköt ja valitsemalla tulosyksikön. Jos Opterissa tulosyksiköille käytettäviä koodeja (arvoja) ei ole Duettissa, Opter yrittää luoda ne Duettiin.

Rajoitukset

Ota huomioon seuraavat rajoitukset:

  • Duett ei salli postinumeroiden lisäämistä asiakasohjelman tai API-kutsujen kautta. Lisätietoa: Postinumerot edellä.

Vaihe 1: Luo laskunvienti Duettiin Opterissa

  1. Valitse Hallinto > Laskut > Laskunvienti ja luo uusi laskunvienti valitsemalla . Seuraavat kentät on täytettävä välilehdellä Yleinen:

    • Nimi: Esimerkiksi ”Duett (API)”.

    • Raportti: Ilman.

    • Laji: Duett API.

    • Merkkikoodaus: UTF-8.

    • Salasana: Salasana (API-asiakasavain) Duettilta. Voit myös luoda API-asiakasavaimen itse Duettissa. Jos se ei onnistu, ota yhteyttä Duettin tukeen.

    • Aloitusteksti: Voit lisätä kenttään kaksi lisäasetusta, jos haluat mukauttaa vientiä.

      Jos haluat, että asiakkaat, joita ei ole Duettissa, luodaan ja että asiakastiedot päivitetään automaattisesti viennin aikana, kenttään Aloitusteksti ei tarvitse syöttää mitään.

      Käytettävä muoto on ”parametri=arvo”. Kirjoita yksi parametri yhdelle riville kuten alla olevassa esimerkissä.

      Esimerkki, kenttä Starttext
      createCustomers=false
      updateCustomers=false

      Jos et syötä tiettyä parametria kenttään Aloitusteksti, käytetään oletusasetusta.

      Parametri Kuvaus

      createCustomers=<true/false>

      Valitse, luodaanko asiakas automaattisesti Duettissa vai ei:

      • ”True” (oletus): Jos vietävään laskuun merkittyä asiakasta ei ole Duettissa, asiakas luodaan automaattisesti Duettiin.

      • ”False”: Jos vietävään laskuun merkittyä asiakasta ei ole Duettissa, Duett antaa virheviestin, kun lasku viedään. Virheilmoitus on Asiakas {0} puuttuu Duettista ja asiakkaiden vienti on poistettu käytöstä.

        Asiakasta ei siis luoda automaattisesti Duettiin, mutta voit luoda asiakkaan manuaalisesti Duettiin ja viedä laskun sitten uudelleen.

      updateCustomers=<true/false>

      Valitse, päivitetäänkö asiakastiedot Duettiin automaattisesti vai ei:

      • ”True” (oletus): Jos vietävän laskun asiakkaan tiedot ovat muuttuneet Opterissa asiakkaaseen viimeksi liittyneen viennin jälkeen, Opter päivittää asiakastiedot Duettiin.

      • ”False”: Opter ei päivitä asiakastietoja Duettiin.

        Jos valitset tämän vaihtoehdon, suosittelemme, että pidät Opterin ja Duettin asiakastiedot manuaalisesti ajan tasalla, jotta ne sisältävät aina samat tiedot.

  2. Jos haluat, että Opter-lasku liitetään PDF-muodossa, merkitse valintaruutu Sisällytä PDF-kopio.

    Duett 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 Duettiin PDF-tiedostona.

  3. Jos haluat pienentää PDF-tiedoston kokoa, merkitse kohta Pienennä PDF-tiedoston kokoa.

    Tiedoston kokoa pienennetään poistamalla kaikki tekstin muotoilut (lihavointi, kursivointi, alleviivaus) ja vaihtamalla fontti sellaiseen, joka käyttää vähemmän tallennustilaa. Se, kuinka paljon tiedostokoko pienenee, riippuu muun muassa siitä, kuinka paljon muotoilua tiedosto sisältää.

  4. Tallenna muutokset valitsemalla .

Vaihe 2 (valinnainen): Käännä Opterin ALV-koodit

Arvonlisävero voidaan lisätä tilinumeroihin Duettissa, mutta Opterin kunkin tiliöintirivin ALV-koodi lähetetään aina laskun viennin yhteydessä Duettiin. Oletusarvoisesti arvonlisäverokoodina lähetetään ALV-kanta kokonaisina prosentteina, esimerkiksi ”25”.

Jos on käytettävä muita ALV-koodeja, kirjoita ne käännöstaulukkoon. Katso jäljempänä olevat ohjeet. Jos tiliöintirivin ALV:lle on käännös ikkunassaLaskunvienti välilehdellä Koodeja, tämä ALV-koodi lähetetään. Tällöin ei käytetä oletusasetusta, jonka mukaan ALV-koodina lähetetään ALV-kanta lähetetään kokonaisina prosentteina.

Jos haluat määrittää, mitkä ALV-koodit lähetetään Duettille, tee näin:

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

  2. Kirjoita ALV-koodi sarakkeeseen Koodi määritettävän ALV-kannan tai määritettävien ALV-kantojen kohdalle.

  3. Tallenna muutokset valitsemalla .

Vaihe 3: Lisää laskunvienti laskunvientiryhmään

Voit luoda uuden laskunvientiasetuksen (eli vientiryhmän) tai tarkistaa, onko laskunvientiasetus (ryhmä) olemassa jos siellä, johon haluat lisätä laskunviennin Duettiin, seuraavasti:

  1. Valitse Hallinto > Laskut > Laskunvientiasetukset.

  2. Katso vasemmanpuoleisesta luettelosta, onko laskunvientiasetus (ryhmä) olemassa jo siellä, johon haluat lisätä laskunviennin Duettiin. Napsauta kyseistä laskunvientiasetusta ja merkitse valintaruutu ”Duett (API)” (tai nimi, jonka annoit laskunviennille) kohdassa Viennit.

    Jos laskunvientiasetusta (ryhmä) ei ole olemassa siellä, johon haluat lisätä laskunviennin Duettiin, luo uusi. Valitse ja anna laskunvientiasetuksille nimi, esimerkiksi ”Duett (API)”. Merkitse valintaruutu ”Duett (API)” (tai nimi, jonka annoit laskunviennille) kohdassa Viennit.

  3. Tallenna muutokset valitsemalla .

  4. Valitse, mitä laskunvientiasetusta käytetään oletuksena. Valitse Duett (API) oletukseksi merkitsemällä ”Duett (API)” vasemmalla olevassa luettelossa ja napsauta kohtaa .

  5. Sen varmistamiseksi, että kaikki laskut kirjataan kirjanpitoon Duettissa, valitse ”Duett (API)” -vienti kaikkiin vientiasetuksiin (ryhmiin).

  6. Tallenna muutokset valitsemalla .

  7. Jos haluat määrittää, mikä laskunvientiasetus (ryhmä) koskee tiettyä asiakasta, valitse Hakemisto > Asiakkaat ja etsi asiakas, jolle haluat tehdä asetuksen. Napsauta välilehteä Laskutustiedot ja valitse laskunvientiasetus (ryhmä) pudotusvalikosta Laskun vientiasetukset. Tallenna muutokset valitsemalla .

Vaihe 4: Laskujen vienti Duettiin

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

  1. Valitse Opterissa Hallinto > Laskut > Laskut.

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

  3. Napsauttamalla Vie ja lähetä voit viedä laskun tai laskutuskauden Duettiin.

    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, siitä kertoo edistymispalkin harmaa väri. Jos vienti ei onnistu, näytölle tulee virheviesti. Katso jäljempänä oleva kohta Virheviestit.

  4. Jos haluat tarkistaa Duettissa, että tiliöinti on siirretty oikein, tee näin:

    1. Koska API-kutsujen avulla ei voida luoda varsinaisia laskuja, olemassa olevat reskontrakirjaukset on selvitettävä asiakkaan tietojen kautta. Näin voidaan tarkistaa luodut ”tositteet” ja varmistaa, että tiliöinnit Duettissa ja Opterissa täsmäävät.

      Valitse Duettissa ”Meny” > ”Salg” > ”Kunder”. Napsauta hiiren kakkospainikkeella asiakasta, jonka tapahtumat haluat tarkistaa, ja valitse ”Transaksjonsoversikt”. Näyttöön avautuu ikkuna ”Reskontrooversikt”.

    2. Etsi lasku ja napsauta liitenumeroa sarakkeessa ”Bilagsnr”. Näyttöön avautuu ikkuna ”Bilagsjournal”.

    3. Käyttöliittymän toiminnot ovat rajalliset, joten suosittelemme viemään kaikki tiedot Duettista Exceliin.

    4. Tarkista, että tiliöinti on sama Duettissa ja Opterissa.

Vianetsintä

Jos vienti Duettiin ei onnistu, näyttöön tulee virheviesti. Ota huomioon seuraavat virheilmoituksia koskevat seikat:

  • Ne näytetään vain, jos vienti epäonnistuu ja tapahtuu virhe.

  • Ne näytetään ponnahdusikkunassa vientihetkellä.

  • Tarkempia tietoja saat Windowsin tapahtumalokista. (Katso siis asiakasohjelman tapahtumalokia, koska kutsut tulevat asiakasohjelmasta).

Virheilmoitukset ja korjaavien toimenpiteiden ehdotukset on lueteltu alla olevassa taulukossa. Kun olet korjannut ongelman/virheen, voit viedä laskut uudelleen.

Nouto ei onnistu

Kaikkien noutamisen epäonnistumisesta kertovien virheilmoitusten osalta on huomioitava seuraavaa:

  • Duettissa on mahdollista luoda rajaton määrä laskuja samalle numerolle. Opterissa on mahdollista viedä jo vietyjä laskuja, jolloin Duettissa voi päästä syntymään laskujen kaksoiskappaleita. Tätä varten on olemassa tarkistustoiminto, joka tarkoittaa, että Opter kysyy Duettilta, onko olemassa laskua numerolla x kaudelle y. Jos lasku on jo olemassa Duettissa, Opter ei vie kyseistä laskua Duettiin (uudelleen), vaan siirtyy seuraavaan vietävään laskuun. Duettissa ei tällöin luoda kaksoiskappaleita.

  • Jos jokin menee pieleen, kun Opter käyttää tätä tarkistustoimintoa, näytetään noutamisen epäonnistumisesta kertova virheilmoitus. Virheilmoitukset ja korjaavien toimenpiteiden ehdotukset on lueteltu alla olevassa taulukossa.

Virheviestit

Virheviesti Kuvaus
Virhe API-kutsussa

Virheilmoitus liittyy Duettin antamaan virheilmoitukseen. Ota yhteyttä Opterin tukeen.
Duettiin kirjautuminen epäonnistui

Tarkista, että olet syöttänyt oikean salasanan kenttään Salasana (edellä olevassa vaiheessa 1).
Duettista puuttuu moduuli. Kirjaudu Duettiin ja ratkaise ongelma.

Lisää puuttuva moduuli. Voit myös lisätä puuttuvan moduulin Duettiin itse. Jos se ei onnistu, ota yhteyttä Duettin tukeen.
Virheellinen tilinumero: {0}

Tarkista tilinumero Opterissa.
Tili {0} puuttuu Duettista. Tarkista käytettävissä olevat tilit Duettista.

Opterissa käytettävien tilinumeroiden tulee löytyä myös Duettista.
Tiliä ei voitu noutaa

Opter ei onnistunut noutamaan tietoja tileistä tarkistustoiminnon yhteydessä. Lisätietoa: Nouto ei onnistu edellä.

Ota yhteyttä Opterin tukeen.

Asiakkaan luominen epäonnistui Duettissa

On tehty määritys createCustomers=true kenttään Aloitusteksti (edellä olevassa vaiheessa 1).

Voit luoda asiakkaan manuaalisesti Duettissa ja viedä laskun sitten uudelleen.

Voit myös ottaa asiakkaiden päivityksen pois käytöstä asettamalla createCustomers=false ja updateCustomers=false (Vaihe 1 alla) ja päivittää asiakastiedot Opterissa ja Duettissa manuaalisesti.
Asiakkaita ei voitu noutaa

Opter ei onnistunut noutamaan asiakasta tarkistustoiminnon yhteydessä. Lisätietoa: Nouto ei onnistu edellä.

Ota yhteyttä Opterin tukeen.
Asiakas {0} puuttuu Duettista ja asiakkaiden vienti on poistettu käytöstä

On tehty määritys createCustomers=false kenttään Aloitusteksti (edellä olevassa vaiheessa 1).

Tee jokin seuraavista:

  • Luo asiakas manuaalisesti Duettissa ja vie lasku sitten uudelleen.

  • Määritä createCustomers=true kenttään Aloitusteksti, katso edellä oleva vaihe 1, ja vie sitten lasku uudelleen.
Asiakastietoja kohteelle {0} ei voitu noutaa

Opter ei onnistunut noutamaan tietyn asiakkaan asiakastietoja tarkistustoiminnon yhteydessä. Lisätietoa: Nouto ei onnistu edellä.

Ota yhteyttä Opterin tukeen.
Virhe päivitettäessä asiakasta {0}

Virheilmoitus liittyy Duettin antamaan virheilmoitukseen. Ota yhteyttä Opterin tukeen.
Postinumero {0} puuttuu Duettista Katso edellä oleva kohta Postinumero.

Tulosyksikön {0} luominen epäonnistui Duettissa

Jos Opterissa käytettäviä tulosyksiköitä ei ole Duettissa, Opter yrittää luoda ne Duettiin. Virheilmoitus tarkoittaa, että Opter ei ole onnistunut luomaan tulosyksikköä Duettiin.

Lisätietoa: Tulosyksiköt edellä.

Ota yhteyttä Opterin tukeen.
Arvon {0} luominen tulosyksikölle epäonnistui Duettissa

Tarkista, että kaikilla osastoilla on koodi (arvo) Opterin kentässä Koodi (ikkunoissa Tulosyksiköt 1–Tulosyksiköt 5).

Lisätietoa: Tulosyksiköt edellä.

Tulosyksikköjä ei voitu noutaa

Opter ei onnistunut noutamaan tietoja tulosyksiköistä tarkistustoiminnon yhteydessä. Lisätietoa: Nouto ei onnistu edellä.

Ota yhteyttä Opterin tukeen.
Laskun {0} vienti Duettiin epäonnistui

Laskun vienti Duettiin epäonnistui.

Ota yhteyttä Opterin tukeen.

Laskuja ei voitu noutaa

Jokin meni pieleen Opterin käyttäessä tarkistusfunktiota, jolla Opter kysyy Duettilta, onko Duettissa jo laskua numerolla x kaudelle y. Lisätietoa: Nouto ei onnistu edellä.

Ota yhteyttä Opterin tukeen.
Liian monta kutsua

Ota yhteyttä Opterin tukeen.