Sist oppdatert: 2025-02-27

Gjelder fra og med: 2024.12.15

Fakturaeksport til Duett (API)

Du kan koble sammen (integrere) Opter med økonomisystemet Duett. Deretter kan du eksportere fakturaer fra Opter til Duett via API. Mer informasjon om Duett finner du på duett.no.

Når du eksporterer en faktura fra Opter til Duett, skjer følgende:

  • Konteringen eksporteres.

    For hver faktura som eksporteres, opprettes det en ”voucher” i Duett. Denne «voucher» inneholder konteringen som overføres, konteringslinje for konteringslinje. En kopi av Opter-fakturaen i PDF-format vil bli lagt ved denne ”voucher” hvis du har krysset av i avkrysningsboksen Inkluder PDF-kopi (se mer informasjon under Trinn 1 nedenfor).

  • Kundeinformasjon eksporteres og oppdateres i Duett, med mindre du aktivt velger å slå det av med innstillinger i feltet Starttekst. (Mer informasjon er tilgjengelig i Trinn 1 nedenfor.)

Forutsetninger

Brukerkonto hos Duett

For å kunne koble (integrere) Opter med Duett, må du ha en brukerkonto hos Duett. Kontakt Duett hvis du trenger mer informasjon.

Kontonummer

Kontonumrene som brukes i Opter, må finnes i Duett.

Fakturanummer og fakturanummerserier

Duett godtar fakturanumre fra Opter. Vi anbefaler at du sørger for at fakturanumrene som opprettes i Opter, ikke kolliderer med numrene på eventuelle fakturaer som opprettes direkte i Duett. Du kan løse dette ved å bruke ulike fakturanummerserier i Opter og Duett.

Postnummer

Postnummeret til norske kunder som faktureres i Opter, må ha et postnummer som finnes i Duetts postnummerregister.

Duett lar deg ikke legge til postnummer, verken i klienten eller via API-anrop. Hvis du får feilmeldingen Postnummeret {0} mangler i Duett når du eksporterer, kan du gjøre ett eller begge av følgende:

  • Endre postnummeret i Opter slik at det samsvarer med postnummeret i Duett. Deretter eksporterer du fakturaen på nytt.

  • Deaktiver kundeoppdatering ved å angi createCustomers=false og updateCustomers=false (i trinn 1 nedenfor), og hold kundeoppføringene i Opter og Duett oppdatert manuelt.

    Deretter eksporterer du fakturaen på nytt.

Valuta og valutakoder

Duett er for det norske markedet og bruker norske kroner. Duett og Opter bruker de samme valutakodene.

Resultatenheter

I Opter finner du resultatenhetene dine under Innstillinger > Kontor, på fanen Økonomi. Hvis resultatenhetene som brukes i Opter ikke finnes i Duett, vil Opter forsøke å opprette dem i Duett.

I Opter kan du se kodene (verdiene) for de ulike avdelingene under en resultatenhet hvis du klikker på Økonomi > Resultatenheter og velger resultatenhet. Hvis kodene (verdiene) som brukes for en resultatenhet i Opter ikke finnes i Duett, vil Opter forsøke å opprette dem i Duett.

Begrensninger

Det finnes følgende begrensning:

  • Duett lar deg ikke legge til postnummer, verken i klienten eller via API-anrop. Mer informasjon er tilgjengelig i Postnummer over.

Trinn 1: Opprett en fakturaeksport for Duett i Opter

  1. Klikk på Økonomi > Faktura > Fakturaeksport og opprett en ny fakturaeksport ved å klikke på . Følgende felter må fylles ut på fanen Standard:

    • Navn: For eksempel "Duett (API)".

    • Rapport: Ingen.

    • Type: Duett API.

    • Tegnkoding: UTF-8.

    • Passord: Passord (API-klientnøkkel) fra Duett. Du kan eventuelt opprette en API-klientnøkkel selv i Duett. Hvis dette ikke er mulig, kan du kontakte Duetts kundestøtte.

    • Starttekst: I dette feltet kan du legge til to ekstra innstillinger hvis du ønsker å tilpasse eksporten.

      Hvis du vil at kunder som ikke finnes i Duett, skal opprettes, og at kundeinformasjonen skal oppdateres automatisk under eksporten, trenger du ikke å skrive inn noe i feltet Starttekst.

      Bruk formatet «parameter=verdi», og skriv én parameter per linje, som i eksempelet nedenfor.

      Eksempel, feltet Starttekst
      createCustomers=false
      updateCustomers=false

      Hvis du ikke angir en bestemt parameter i feltet Starttekst, brukes standardinnstillingen.

      Parameter Beskrivelse

      createCustomers=<true/false>

      Velg om kunden skal opprettes automatisk i Duett eller ikke:

      • «True» (standard): Hvis kunden som står på fakturaen som eksporteres, ikke finnes i Duett, opprettes kunden automatisk i Duett.

      • «False»: Hvis kunden på fakturaen som eksporteres, ikke finnes i Duett, vil du få en feilmelding fra Duett når du eksporterer fakturaen. Feilmeldingen er Kunden {0} mangler i Duett, og eksport av kunder er deaktivert.

        Kunden opprettes altså ikke automatisk i Duett, men du kan opprette kunden manuelt i Duett og deretter eksportere fakturaen på nytt.

      updateCustomers=<true/false>

      Velg om kundeinformasjonen skal oppdateres automatisk i Duett eller ikke:

      • «True» (standard): Hvis kundeinformasjonen på fakturaen som eksporteres, har blitt endret i Opter siden kunden sist ble inkludert i en eksport, vil Opter oppdatere kundeinformasjonen i Duett.

      • «False»: Opter oppdaterer ikke kundeinformasjonen i Duett.

        Hvis du velger dette alternativet, anbefaler vi at du manuelt holder kunderegistrene i Opter og i Duett oppdaterte, slik at de alltid inneholder samme informasjon.

  2. Hvis du vil at Opter-fakturaen skal legges ved i PDF-format, må du merke av i avkrysningsruten Inkluder PDF-kopi.

    I Duett er det ikke støtte for å presentere alle detaljene man måtte ønske å ha med på en transportfaktura, som avsender, mottaker, avstand, vekt, fraktbrevnummer med mer. Derfor opprettes den grafiske fakturaen med alle detaljer i Opter og sendes til Duett som PDF-fil.

  3. Hvis du vil redusere størrelsen på PDF-filen, markerer du Reduser PDF-filstørrelse.

    Filstørrelsen reduseres ved å fjerne all tekstformatering (fet, kursiv, understreket), og ved å endre skrifttypen til en skrift som bruker mindre lagringsplass. Hvor mye filstørrelsen reduseres, avhenger blant annet av hvor mye formatering den inneholder.

  4. Klikk på for å lagre alle endringer.

Trinn 2 (valgfritt): Oversett Opters momskoder

Moms kan legges til på kontonummer i Duett, men momskoden for hver konteringslinje i Opter sendes alltid med fakturaeksporten til Duett. Som standard sendes momssatsen i hele prosent som momskode, for eksempel "25".

Hvis du må bruke andre momskoder, skriver du inn momskodene i oversettelsestabellen, se instruksjonene nedenfor. Hvis moms på konteringslinjen har en oversettelse i vinduet Fakturaeksport på fanen Koder, sendes denne momskoden, i stedet for standardinnstillingen som er at momssatsen sendes i hele prosent som momskode.

Hvis du vil kontrollere hvilke(n) momskode(r) som skal sendes til Duett, gjør du følgende:

  1. I Opter, i vinduet Fakturaeksport, klikker du på fanen Koder og velger Skattesatser i rullegardinmenyen.

  2. Skriv inn momskoden i kolonnen Kode for den eller de momssatsene du ønsker å kontrollere.

  3. Klikk på for å lagre alle endringer.

Trinn 3: Legg til fakturaeksporten i en fakturaeksportgruppe

For å opprette en ny fakturaeksportinnstilling (dvs. gruppe av eksporter) eller for å kontrollere om det allerede finnes en fakturaeksportinnstilling (gruppe) der du ønsker å legge til fakturaeksporten til Duett, gjør du som følger:

  1. Klikk på Økonomi > Faktura > Fakturaeksportinnstillinger.

  2. Se i listen til venstre om det allerede finnes en fakturaeksportinnstilling (gruppe) der du ønsker å legge til fakturaeksporten til Duett. Klikk på fakturaeksportinnstillingen, og kryss av i avkrysningsboksen for ”Duett (API)” (eller navnet du har gitt fakturaeksporten) under Eksportere.

    Hvis det ikke finnes noen fakturaeksportinnstilling (gruppe) der du vil legge til fakturaeksporten til Duett, oppretter du en ny. Klikk på og gi fakturaeksportinnstillingen et navn, for eksempel ”Duett (API)”. Marker avkrysningsboksen for ”Duett (API)” (eller navnet du ga fakturaeksporten) under Eksportere.

  3. Klikk på for å lagre alle endringer.

  4. Velg hvilken av fakturaeksportinnstillingene som skal være standard. Velg Duett (API)API som standard ved å markere ”Duett (API)” i listen til venstre og klikke på .

  5. For å forsikre deg om at alle fakturaer blir bokført i Duett, må du markere ”Duett (API)”-eksporten for samtlige eksportinnstillinger (grupper).

  6. Klikk på for å lagre alle endringer.

  7. Hvis du vil angi hvilken fakturaeksportinnstilling (gruppe) som gjelder for en bestemt kunde, klikker du på Register > Kunder og søker opp kunden du ønsker å gjøre innstillingen for. Klikk på fanen Faktureringsinformasjon og velg fakturaeksportinnstilling (gruppe) i rullegardinmenyen Fakturaeksportinnstilling. Klikk på for å lagre alle endringer.

Trinn 4: Eksportere fakturaer til Duett

Du kan eksportere fakturainformasjonen fra Opter samtidig som du avslutter en fakturaperiode, eller etterpå, siden du kan velge om du vil eksportere hele fakturaperioder eller enkeltfakturaer.

  1. I Opter klikker du på Økonomi > Faktura > Faktura.

  2. Marker fakturaen eller fakturaperioden du vil eksportere, høyreklikk og velg Eksporter.

  3. Klikk på Eksporter og send for å eksportere fakturaen eller fakturaperioden til Duett.

    I vinduet Fakturaeksport i Opter vises antall fakturaer som skal eksporteres og antall eksporterte fakturaer, samt en fremdriftsindikator (lengst nede i vinduet). Fremdriftsindikatoren blir helt grønn når fakturaeksporten er fullført.

    Hvis fakturaeksporten mislykkes, blir fremdriftslinjen grå, og det står at eksporten mislyktes. Hvis eksporten mislyktes, vises en feilmelding, se Feilmeldinger nedenfor.

  4. I Duett kan du gjøre følgende hvis du vil kontrollere at konteringen ble overført på riktig måte:

    1. Ettersom det ikke kan opprettes fakturaer via API-anrop, må du gå via kunden og se hvilke reskontroposteringer som finnes. Derfra kan du gå gjennom de "vouchers" som er opprettet, og sikre at konteringen i Duett stemmer overens med den i Opter.

      I Duett klikker du på "Meny" > "Salg" > "Kunder". Høyreklikk på kunden du vil sjekke transaksjonene for, og velg "Transaksjonsoversikt". Vinduet "Reskontrooversikt" åpnes.

    2. Finn fakturaen, og klikk på bilagsnummeret i kolonnen "Bilagsnummer". Vinduet "Bilagsjournal" åpnes.

    3. Grensesnittet er litt begrenset, så vi anbefaler derfor at du eksporterer fra Duett til Excel for å få med alle dataene.

    4. Kontroller at konteringen i Duett stemmer overens med konteringen i Opter.

Feilsøking

Hvis eksporten til Duett ikke fungerer som den skal, vises en feilmelding. Følgende gjelder for feilmeldingene:

  • De vises bare når du eksporterer og noe går galt.

  • De vises i et popup-vindu når du eksporterer.

  • Du finner mer detaljert informasjon i Windows Eventlog. (Det vil si, se i klientens hendelseslogg, ettersom anropene foretas fra klienten).

Feilmeldingene og forslag til tiltak er oppført i tabellen nedenfor. Når du har løst problemet/feilen, kan du eksportere fakturaene igjen.

Kunne ikke hente ...

Vedrørende alle feilmeldinger som begynner med "Kunne ikke hente ..." i tabellen nedenfor:

  • I Duett kan du opprette et vilkårlig antall fakturaer med samme nummer. I Opter kan du eksportere fakturaer som allerede er eksportert, og da er det en risiko for dupliserte fakturaer i Duett. Derfor finnes det en kontrollfunksjon som innebærer at Opter spør Duett om fakturaen med nummer x i periode y finnes. Hvis fakturaen allerede finnes i Duett, vil ikke Opter eksportere den fakturaen til Duett (igjen), men gå videre til neste faktura i eksporten. Det opprettes ingen duplikater i Duett.

  • Hvis noe går galt når Opter bruker denne kontrollfunksjonen, vil den vise feilmeldinger som begynner med "Kunne ikke hente ...". Feilmeldingene og forslag til tiltak er oppført i tabellen nedenfor.

Feilmeldinger

Feilmelding Beskrivelse
Feil ved API-kall

Denne feilmeldingen er kobles til en feilmelding fra Duett. Kontakt Opters kundestøtte.
Kunne ikke logge inn på Duett

Kontroller at du har skrevet inn riktig passord i feltet Passord (i trinn 1 over).
En modul mangler i Duett. Logg på Duett og rett problemet.

Legg til den manglende modulen. Du kan eventuelt legge til den manglende modulen i Duett selv. Hvis dette ikke er mulig, kan du kontakte Duetts kundestøtte.
Feil angitt kontonummer: {0}

Kontroller kontonummeret i Opter.
Kontoen {0} mangler i Duett. Kontroller tilgjengelige kontoer i Duett.

Kontonumrene som brukes i Opter, må finnes i Duett.
Kunne ikke hente kontoen

Opter klarte ikke å hente informasjon om kontoen når Opter brukte kontrollfunksjonen. Mer informasjon er tilgjengelig i Kunne ikke hente ... over.

Kontakt Opters kundestøtte.

Kunne ikke opprette kunden i Duett

Du har angitt createCustomers=true i feltet Starttekst (i trinn 1 over).

Du kan opprette kunden manuelt i Duett og deretter eksportere fakturaen på nytt.

Hvis du vil, kan du deaktivere kundeoppdatering ved å angi createCustomers=false og updateCustomers=false (i trinn 1 nedenfor), og hold kundeoppføringene i Opter og Duett oppdatert manuelt.
Kunne ikke hente kunder

Opter klarte ikke å hente kunden når Opter brukte kontrollfunksjonen. Mer informasjon er tilgjengelig i Kunne ikke hente ... over.

Kontakt Opters kundestøtte.
Kunden {0} mangler i Duett, og eksport av kunder er deaktivert

Du har angitt createCustomers=false i feltet Starttekst (i trinn 1 over).

Du kan gjøre et av følgende:

  • Opprett kunden manuelt i Duett og eksporter deretter fakturaen på nytt.

  • Sett createCustomers=true i feltet Starttekst, setrinn 1 over, og eksporter deretter fakturaen på nytt.
Kunne ikke hente kundeopplysninger for {0}

Opter klarte ikke å hente kundeinformasjon for angitt kunde når Opter brukte kontrollfunksjonen. Mer informasjon er tilgjengelig i Kunne ikke hente ... over.

Kontakt Opters kundestøtte.
Feil ved oppdatering av kunde {0}

Denne feilmeldingen er kobles til en feilmelding fra Duett. Kontakt Opters kundestøtte.
Postnummeret {0} mangler i Duett Se seksjonen Postnummer over.

Kunne ikke opprette resultatenheten {0} i Duett

Hvis resultatenhetene som brukes i Opter ikke finnes i Duett, vil Opter forsøke å opprette dem i Duett. Hvis du får denne feilmeldingen, har Opter ikke klart å opprette resultatenheten i Duett.

Mer informasjon er tilgjengelig i seksjonen Resultatenheter over.

Kontakt Opters kundestøtte.
Kunne ikke opprette verdien {0} for resultatenheten i Duett

Kontroller at alle avdelinger har en kode (en verdi) i feltet Kode (i vinduene Resultatenheter 1–Resultatenheter 5) i Opter.

Mer informasjon er tilgjengelig i seksjonen Resultatenheter over.

Kunne ikke hente resultatenheter

Opter klarte ikke å hente informasjon om resultatenheter når Opter brukte kontrollfunksjonen. Mer informasjon er tilgjengelig i Kunne ikke hente ... over.

Kontakt Opters kundestøtte.
Kunne ikke eksportere faktura {0} til Duett

Angitt faktura kunne ikke eksporteres til Duett.

Kontakt Opters kundestøtte.

Kunne ikke hente fakturaer

Noe gikk galt da Opter brukte kontrollfunksjonen der Opter spør Duett om fakturaen med nummer x i periode y allerede finnes i Duett. Mer informasjon er tilgjengelig i Kunne ikke hente ... over.

Kontakt Opters kundestøtte.
For mange kall

Kontakt Opters kundestøtte.