Senast uppdaterad: 2025-03-07

Fakturaexport till Duett (API)

Gäller Opter 2024.12.15 och senare.

I den här artikeln

Du kan koppla ihop (integrera) Opter med ekonomisystemet Duett. Därefter kan du exportera fakturor från Opter till Duett via API. Mer information om Duett finns på duett.no.

När du gör en fakturaexport från Opter till Duett händer följande:

  • Konteringen exporteras.

    För varje faktura som exporteras skapas en ”voucher” i Duett. I denna ”voucher” finns konteringen som överförs, konteringsrad för konteringsrad. Till denna ”voucher” bifogas en kopia av Opter-fakturan i PDF-format om du har markerat kryssrutan Inkludera PDF-kopia, (mer information finns i Steg 1 nedan).

  • Kundinformation exporteras och uppdateras i Duett, om du inte aktivt väljer att stänga av det med inställningar i fältet Starttext. (Mer information finns i Steg 1 nedan.)

Förutsättningar

Användarkonto hos Duett

För att kunna koppla ihop (integrera) Opter med Duett, behöver du har ett användarkonto hos Duett. Kontakta Duett om du behöver mer information.

Kontonummer

De kontonummer som används i Opter måste finnas i Duett.

Fakturanummer och fakturanummerserier

Duett accepterar fakturanummer från Opter. Vi rekommenderar att ni ser till att numren på fakturor som skapas i Opter inte krockar med numren på eventuella fakturor som skapas direkt i Duett. Det kan ni lösa genom att använda olika fakturanummerserier i Opter och Duett.

Postnummer

Postnummer till de norska kunder som faktureras i Opter måste ha postnummer som finns i Duetts postnummerregister.

Duett tillåter inte att man lägger till postnummer, vare sig i klienten eller via API-anrop. Om du får felmeddelandet Postnumret {0} saknas i Duett vid export, kan du göra något av följande, eller båda:

  • Ändra postnumret i Opter, så att det stämmer överens med postnumret i Duett. Exportera därefter fakturan igen.

  • Inaktivera kunduppdatering genom att sätta createCustomers=false och updateCustomers=false (i Steg 1 nedan), samt hålla kundregistren i Opter och i Duett uppdaterade manuellt.

    Exportera därefter fakturan igen.

Valuta och valutakoder

Duett är för den norska marknaden och använder norska kronor. Duett och Opter använder samma valutakoder.

Resultatenheter

I Opter finns dina resultatenheter under Inställningar > Kontor, på fliken Ekonomi. Om de resultatenheter som används i Opter inte finns i Duett så försöker Opter skapa dem i Duett.

I Opter ser du koderna (värdena) för de olika avdelningarna under en resultatenheten, om du klickar på Ekonomi > Resultatenheter och väljer resultatenhet. Om de koder (värden) som används för en resultatenhet i Opter inte finns i Duett så försöker Opter skapa dem i Duett.

Begränsningar

Följande begränsning finns:

  • Duett tillåter inte att man lägger till postnummer, vare sig i klienten eller via API-anrop. Mer information finns i Postnummer ovan.

Steg 1: Skapa en fakturaexport för Duett i Opter

  1. Klicka på Ekonomi > Fakturor > Fakturaexport och skapa en ny fakturaexport genom att klicka på . Följande fält måste fyllas i på fliken Allmänt:

    • Namn: Till exempel ”Duett (API)”.

    • Rapport: Ingen.

    • Typ: Duett API.

    • Encoding: UTF-8.

    • Lösenord: Lösenord (API-klientnyckel) från Duett. Eventuellt kan du själv skapa en API-klientnyckel i Duett. Om det inte går, kontakta Duett-supporten.

    • Starttext: I det här fältet kan du lägga två extrainställningar om du vill att anpassa exporten.

      Om du vill att kunder som inte finns i Duett ska skapas och att kundinformationen ska uppdateras automatiskt vid exporten, så behöver du inte skriva någonting i fältet Starttext.

      Använd formatet är ”parameter=värde” och skriv en parameter per rad, som i exemplet nedan.

      Exempel, fältet Starttext
      createCustomers=false
      updateCustomers=false

      Om du inte skriver in en viss parameter i fältet Starttext, så används standardinställningen.

      Parameter

      Beskrivning

      createCustomers=<true/false>

      Välj om kunden ska skapas automatiskt i Duett eller inte:

      • ”True” (standard): Om den kund som står på fakturan som exporteras inte finns i Duett, så skapas kunden automatiskt i Duett.

      • ”False”: Om den kund som står på fakturan som exporteras inte finns i Duett, så får man ett felmeddelande från Duett när man exporterar fakturan. Felmeddelandet är Kunden {0} saknas i Duett och export av kunder har inaktiverats.

        Kunden skapas alltså inte automatiskt i Duett, men du kan manuellt skapa kunden i Duett och sedan exportera fakturan igen.

      updateCustomers=<true/false>

      Välj om kundinformationen ska uppdateras automatiskt i Duett eller inte:

      • ”True” (standard): Om informationen om den kund som står på fakturan som exporteras har ändrats i Opter sedan kunden senast var med i en export, så uppdaterar Opter kundinformationen i Duett.

      • ”False”: Opter uppdaterar inte kundinformationen i Duett.

        Om du väljer det här alternativet så rekommenderar vi att du manuellt håller kundregistren i Opter och i Duett uppdaterade, så att de alltid innehåller samma information.

  2. Om du vill att Opter-fakturan ska bifogas i PDF-format, markera kryssrutan Inkludera PDF-kopia.

    I Duett finns det inget stöd för att presentera alla detaljer som man kan vilja ha med på en transportfaktura, som avsändare, mottagare, avstånd, vikt, fraktsedelsnummer med mera. Därför skapas den grafiska fakturan med alla detaljer i Opter och skickas med till Duett som en PDF-fil.

  3. Om du vill minska PDF-filens storlek markerar du Minska PDF filstorlek.

    Filstorleken minskas genom att all textformatering (fetstil, kursivt, understruket) tas bort, och genom att teckensnittet ändras till ett som använder mindre lagringsutrymme. Hur mycket filstorleken minskar beror alltså bland annat på hur mycket formatering den innehåller.

  4. Klicka på för att spara alla ändringar.

Steg 2 (valfritt): Översätta Opters momskoder

Moms kan sättas på kontonummer i Duett, men momskoden för varje konteringsrad i Opter skickas alltid med vid fakturaexport till Duett. Som standard skickas momssatsen i hela procent som momskod, till exempel ”25”.

Om ni har behov av att använda andra momskoder, så skriver ni momskoderna i översättningtabellen, se instruktioner nedan. Om konteringsradens moms har en översättning i fönstret Fakturaexport på fliken Koder så skickas den momskoden, istället för standardinställningen att momssatsen skickas i hela procent som momskod.

Om ni vill styra vilken eller vilka momskoder som skickas till Duett, gör så här:

  1. I Opter, i fönstret Fakturaexport, klicka på fliken Koder och välj Skattesatser i listrutan.

  2. Fyll i momskoden i kolumnen Kod för den eller de momssatser som ni vill styra.

  3. Klicka på för att spara alla ändringar.

Steg 3: Lägga till fakturaexporten i en fakturaexportgrupp

För att skapa en ny fakturasexportinställning (det vill säga grupp av exporter) eller för att kontrollera om det redan finns en fakturaexportinställning (grupp) där du vill lägga till fakturaexporten till Duett, gör så här:

  1. Klicka på Ekonomi > Fakturor > Fakturaexportinställningar.

  2. Titta i listan till vänster om det redan finns en fakturaexportinställning (grupp) där du vill lägga till fakturaexporten till Duett. Klicka på den fakturaexportinställningen och markera kryssrutan för ”Duett (API)” (eller det namn du gav fakturaexporten) under Exporter.

    Om det inte finns någon fakturaexportinställning (grupp) där du vill lägga till fakturaexporten till Duett, så skapar du en ny. Klicka på och ge fakturaexportinställningen ett namn, till exempel ”Duett (API)”. Markera kryssrutan för ”Duett (API)” (eller det namn du gav fakturaexporten) under Exporter.

  3. Klicka på för att spara alla ändringar.

  4. Välj vilken av fakturaexportinställningarna som ska vara standard. För att välja Duett (API) som standard, markera ”Duett (API)” i listan till vänster och klicka på .

  5. För att försäkra sig om att alla fakturor blir bokförda i Duett, markera ”Duett (API)”-exporten för samtliga exportinställningar (grupper).

  6. Klicka på för att spara alla ändringar.

  7. Om du vill ställa in vilken fakturaexportinställning (grupp) som gäller för en viss kund, klicka på Register > Kunder och sök fram kunden som du vill göra inställningen för. Klicka på fliken Faktureringsuppgifter och välj fakturaexportinställning (grupp) i listrutan Fakturaexportinställning. Klicka på för att spara alla ändringar.

Steg 4: Exportera fakturor till Duett

Du kan exportera fakturainformationen från Opter i samband med att du stänger en fakturaperiod, eller i efterhand då du kan välja om du vill exportera hela fakturaperioder eller enskilda fakturor.

  1. I Opter, klicka på Ekonomi > Fakturor > Fakturor.

  2. Markera den faktura eller fakturaperiod du vill exportera, högerklicka och välj Exportera.

  3. Klicka på Exportera och skicka för att exportera fakturan eller fakturaperioden till Duett.

    I fönstret Fakturaexport i Opter visas antalet fakturor som ska exporteras och antalet exporterade fakturor, samt en förloppsindikator (längst ner i fönstret). Förloppsindikatorn blir helt grön när fakturaexporten är klar.

    Om fakturaexporten misslyckas blir förloppsindikatorn grå och det står att exporten misslyckades. Om exporten misslyckades visas ett felmeddelande, se Felmeddelanden nedan.

  4. I Duett, om du vill kontrollera att konteringen överförts korrekt, gör så här:

    1. Då inga egentliga fakturor kan skapas via API anrop får man gå via kund och se vilka reskontraposter som finns, därifrån kan man granska de ”vouchers” som skapats och säkerställa att konteringen i Duett stämmer med den i Opter.

      I Duett, klicka på ”Meny” > ”Salg” > ”Kunder”. På den kund du vill kontrollera transaktionerna för, högerklicka och välj ”Transaksjonsoversikt”. Fönstret ”Reskontrooversikt” öppnas.

    2. Lokalisera fakturan och klicka på bilagsnumret i kolumnen ”Bilagsnr”. Fönstret ”Bilagsjournal” öppnas.

    3. Gränssnittet är lite begränsat, därför rekommenderar vi att du gör en export från Duett till Excel, för att få med all data.

    4. Kontrollera att konteringen i Duett stämmer med den i Opter.

Felsökning

Om exporten till Duett inte fungerar som den ska, så visas ett felmeddelande. Följande gäller för felmeddelandena:

  • De visas endast när man exporterar och något går fel.

  • De visas i ett popup-fönster vid exporttillfället.

  • Mer utförlig information finns i Windows Eventlog. (Det vill säga, titta i klientens eventlogg, eftersom anropen sker från klienten).

Felmeddelandena och förslag på åtgärder finns i tabellen nedan. När du har åtgärdat problemet/felet, så kan du exportera fakturorna igen.

Kunde inte hämta...

Angående alla felmeddelanden som börjar på ”Kunde inte hämta...” i tabellen nedan:

  • I Duett går det att skapa hur många fakturor som helst med samma nummer. I Opter kan man exportera redan exporterade fakturor, och då finns risken att det blir dubletter av fakturorna i Duett. Därför finns en kontrollfunktion, som innebär att Opter frågar Duett om fakturan med nummer x i period y finns. Om fakturan redan finns i Duett, så exporterar Opter inte den fakturan till Duett (igen), utan går vidare till nästa faktura i exporten. Inga dubletter skapas i Duett.

  • Om något går fel när Opter använder sig av denna kontrollfunktion, då visas felmeddelanden som börjar på ”Kunde inte hämta...”. Felmeddelandena och förslag på åtgärder finns i tabellen nedan.

Felmeddelanden

Felmeddelande

Beskrivning
Fel vid API-anrop

Detta felmeddelande kopplas ihop med ett felmeddelande från Duett. Kontakta Opter-supporten.
Det gick inte att logga in på Duett

Kontrollera att du har angivit rätt lösenord i fältet Lösenord (i Steg 1 ovan).
En modul saknas i Duett. Logga in på Duett och åtgärda problemet.

Lägg till den modul som saknas. Eventuellt kan du själv lägga till den saknade modulen i Duett. Om det inte går, kontakta Duett-supporten.
Felaktigt angivet kontonummer: {0}

Kontrollera kontonumret i Opter.
Kontot {0} saknas i Duett. Kontrollera tillgängliga konton i Duett.

De kontonummer som används i Opter måste finnas i Duett.
Kunde inte hämta konton

Opter kunde inte hämta information om konton när Opter använde kontrollfunktionen. Mer information finns i Kunde inte hämta... ovan.

Kontakta Opter-supporten.

Det gick inte skapa kunden i Duett

Ni har satt createCustomers=true i fältet Starttext (i Steg 1 ovan).

Du kan skapa kunden manuellt i Duett och sedan exportera fakturan igen.

Om du vill kan du även inaktivera kunduppdatering genom att sätta createCustomers=false och updateCustomers=false (i Steg 1 nedan), samt hålla kundregistren i Opter och i Duett uppdaterade manuellt.
Kunde inte hämta kunder

Opter kunde inte hämta kunden när Opter använde kontrollfunktionen. Mer information finns i Kunde inte hämta... ovan.

Kontakta Opter-supporten.
Kunden {0} saknas i Duett och export av kunder har inaktiverats

Ni har satt createCustomers=false i fältet Starttext (i Steg 1 ovan).

Du kan göra något av följande:

  • Skapa kunden manuellt i Duett och sedan exportera fakturan igen.

  • Sätta createCustomers=true i fältet Starttext, se Steg 1 ovan, och sedan exportera fakturan igen.
Kunde inte hämta kunduppgifter för {0}

Opter kunde inte hämta kundinformationen för angiven kund när Opter använde kontrollfunktionen. Mer information finns i Kunde inte hämta... ovan.

Kontakta Opter-supporten.
Fel vid uppdatering av kund {0}

Detta felmeddelande kopplas ihop med ett felmeddelande från Duett. Kontakta Opter-supporten.
Postnumret {0} saknas i Duett Se sektionen Postnummer ovan.

Det gick inte att skapa resultateheten {0} i Duett

Om de resultatenheter som används i Opter inte finns i Duett så försöker Opter skapa dem i Duett. Om du får detta felmeddelande så har Opter misslyckats med att skapa resultatenheten i Duett.

Mer information finns i sektionen Resultatenheter ovan.

Kontakta Opter-supporten.
Det gick inte att skapa värdet {0} för resultatenheten i Duett

Kontrollera att alla avdelningar har en kod (ett värde) i fältet Kod (i fönstren Resultatenheter 1–Resultatenheter 5) i Opter.

Mer information finns i sektionen Resultatenheter ovan.

Kunde inte hämta resultatenheter

Opter kunde inte hämta information om resultatenheter när Opter använde kontrollfunktionen. Mer information finns i Kunde inte hämta... ovan.

Kontakta Opter-supporten.
Det gick inte att exportera faktura {0} till Duett

Angiven faktura gick inte att exportera till Duett.

Kontakta Opter-supporten.

Kunde inte hämta fakturor

Något gick fel när Opter använde kontrollfunktionen där Opter frågar Duett om fakturan med nummer x i period y redan finns i Duett. Mer information finns i Kunde inte hämta... ovan.

Kontakta Opter-supporten.
För många anrop

Kontakta Opter-supporten.

Se även