Fakturaeksport til Heeros (API)

Du kan forbinde (integrere) Opter med økonomisystemet Heeros. Derefter kan du eksportere fakturaer fra Opter til Heeros. Du kan få flere oplysninger om Heeros på heeros.com (på finsk) og heeros.com/en (på engelsk).

Trin 1: Opret en fakturaeksport for Heeros i Opter

Klik på Økonomi > Faktura > Fakturaeksport, og opret en ny fakturaeksport ved at klikke på . Følgende felt skal udfyldes under fanen Generelt:
- Navn: For eksempel "Heeros (API)".
- Rapport: Ingen.
- Type: XmlSerializer. (Type skal være XmlSerializer.)
- Kodning: UTF-8.
- Kundekode: Du kan finde din kundekode i Heeros, "la_id" eller "end customer id" (”loppuasiakastunnus”).
- Kontorkode: Du kan finde din kontokode i Heeros, "tt_id" eller "accounting customer id" (”tilitoimistotunnus”).
- Starttekst: I dette felt kan du tilføje andre parametre for at tilpasse eksporten.
  
  Brug formatet "parameter=værdi", og skriv en parameter pr. linje, som i eksemplet nedenfor.
  Eksempel, feltet Starttekst
```
1
2
3
4
5
6
7
MoveOnlyToLedger=true
SendToCustomer=false
CreateCustomer=true
UpdateCustomer=true
CreateProduct=true
UpdateProduct=true
CreateAccountingObjects=true
```
  Hvis du ikke indtaster en bestemt parameter i feltet Starttekst, anvendes standardindstillingen. Du kan få flere oplysninger om parametrene i tabellen Parametre i feltet Starttekst nedenfor.
- Markér afkrydsningsfeltet En fil pr. faktura.
Klik på for at gemme alle ændringer.
Klik på fanen Filoverførsel. Følgende felter skal udfyldes:
- Metode: Heeros API.
- Klientidentitet: API-brugeridentitet fra Heeros. ("Heeros-brugernavn".)
- Klientnøgle: API-nøgle fra Heeros. ("Heeros-adgangskode".)
Klik på for at gemme alle ændringer.

Trin 2: Tilføj transformen i fakturaeksporten

Dette trin bestilles af Opter. Kontakt for at få flere oplysninger.

Trin 3: Tilføj fakturaeksporten i en fakturaeksportgruppe

For at oprette en ny fakturaeksportindstilling (dvs. gruppe af eksporter) eller for at kontrollere, om der allerede findes en fakturaeksportindstilling (gruppe), hvor du ønsker at tilføje fakturaeksporten til Heeros, skal du gøre følgende:

Klik på Økonomi > Faktura > Fakturainformation.
Se på listen til venstre, om der allerede findes en fakturaeksportindstilling (gruppe), hvor du vil tilføje fakturaeksporten til Heeros. Klik på den pågældende fakturaeksportindstilling, og markér afkrydsningsfeltet for "Heeros API" (eller det navn, du har givet fakturaeksporten) under Eksporter.

Hvis der ikke findes en fakturaeksportindstilling (gruppe), hvor du vil tilføje fakturaeksporten til Heeros, skal du oprette en ny. Klik på , og giv fakturaeksportindstillingen et navn, f.eks. "Heeros API". Markér afkrydsningsfeltet for "Heeros API" (eller det navn, du har givet fakturaeksporten) under Eksporter.
Klik på for at gemme alle ændringer.
Vælg, hvilken fakturaeksportindstilling der skal bruges som standard. For at vælge Heeros API som standard skal du markere "Heeros API" i listen til venstre og klikke på .
For at sikre at alle fakturaer bogføres i Heeros, skal du markere "Heeros API"-eksporten for samtlige eksportindstillinger (grupper).
Klik på for at gemme alle ændringer.
Hvis du vil indstille, hvilken fakturaeksportindstilling (gruppe) der gælder for en bestemt kunde, skal du klikke på Register > Kunder og søge efter den kunde, du vil foretage indstillingen for. Klik på fanen Faktureringsinformation, og vælg fakturaeksportindstilling (gruppe) i rullemenuen Fakturaeksportindstilling. Klik på for at gemme alle ændringer.

Trin 4: Eksportér fakturaer til Heeros

Du kan eksportere fakturaoplysningerne fra Opter, når du lukker en fakturaperiode, eller efterfølgende ved at vælge, om du vil eksportere hele fakturaperioder eller enkelte fakturaer.

Klik på Økonomi > Faktura > Faktura.
Markér den faktura eller fakturaperiode, du vil eksportere, højreklik, og vælg Eksportér.
Klik på Eksporter og send for at eksportere fakturaen eller fakturaperioden til Heeros.

I vinduet Fakturaeksport i Opter vises antallet af fakturaer, som skal eksporteres, sammen med antallet af eksporterede fakturaer samt en statusindikator (længst nede i vinduet). Statusindikatoren bliver helt grøn, når fakturaeksporten er klar.

Hvis fakturaeksporten mislykkes, bliver statusindikatoren grå, og der står, at eksporten mislykkedes. Hvis eksporten mislykkedes, vises en fejlmeddelelse. Se Fejlmeddelelser nedenfor.

Parametre i feltet Starttekst

Tabellen viser de parametre, du kan indtaste i feltet Starttekst. Find flere oplysninger og eksempler i Trin 1 ovenfor.

Parameter	Beskrivelse
MoveOnlyToLedge=<true/false>	Fakturaer i Heeros kan sendes til modtageren (kunden) via Opentext. Vælg, om fakturaen skal sendes automatisk til Opentext eller ej: "True" (standard): Fakturaen sendes automatisk til Opentext. "False": Fakturaen gemmes i "Heeros Sales Invoices" med status "complete". Derefter kan du manuelt sende fakturaen til Opentext eller direkte til kunden. Kun én af parametrene MoveOnlyToLedge og SendToCustomer (se nedenfor) kan sættes til "true".
SendToCustomer=<true/false>	Vælg, om fakturaen skal sendes automatisk til kunden eller ej: "True": Fakturaen sendes automatisk til kunden. "False" (standard): Fakturaen gemmes i "Heeros Sales Invoices" med status "complete". Derefter kan du manuelt sende fakturaen til Opentext eller direkte til kunden. Kun én af parametrene MoveOnlyToLedge (se ovenfor) og SendToCustomer kan sættes til "true".
CreateCustomer=<true/false>	Vælg, om kunden skal oprettes automatisk i Heeros eller ej: "True" (standard): Hvis kunden på den faktura, der eksporteres, ikke findes i Heeros, så oprettes kunden automatisk i Heeros. "False": Hvis kunden på den faktura, der eksporteres, ikke findes i Heeros, får du en fejlmeddelelse fra Heeros, når du eksporterer fakturaen. Kunden oprettes altså ikke automatisk i Heeros, men du kan oprette kunden manuelt i Heeros og derefter eksportere fakturaen igen.
UpdateCustomer=<true/false>	Vælg, om kundeoplysningerne skal opdateres automatisk i Heeros eller ej: "True" (standard): Hvis kundeoplysningerne på den eksporterede faktura ikke stemmer overens med oplysningerne i Heeros, bliver kundeoplysningerne automatisk opdateret i Heeros. "False": Hvis kundeoplysningerne på den eksporterede faktura ikke stemmer overens med oplysningerne i Heeros, får du en fejlmeddelelse fra Heeros, når du eksporterer fakturaen. Kunden oprettes altså ikke automatisk i Heeros, men du kan opdatere kundeoplysningerne manuelt i Heeros og derefter eksportere fakturaen igen.
CreateProduct=<true/false>	I Opter kan du angive prisenheder og/eller produkter på fakturaen (du vælger normalt at bruge prisenheder eller produkter). I Heeros hedder det bare produkter. Vælg, om produkter skal oprettes automatisk i Heeros eller ej: "True" (standard): Hvis produktet på den faktura, der eksporteres, ikke findes i Heeros, så oprettes produktet automatisk i Heeros. "False": Hvis produktet på den faktura, der eksporteres, ikke findes i Heeros, får du en fejlmeddelelse fra Heeros, når du eksporterer fakturaen. Produktet oprettes altså ikke automatisk i Heeros, men du kan oprette produktet manuelt i Heeros og derefter eksportere fakturaen igen.
UpdateProduct=<true/false>	I Opter kan du angive prisenheder og/eller produkter på fakturaen (du vælger normalt at bruge prisenheder eller produkter). I Heeros hedder det bare produkter. Vælg, om produktet skal oprettes automatisk i Heeros eller ej: "True" (standard): Hvis produktoplysningerne på den eksporterede faktura ikke stemmer overens med oplysningerne i Heeros, bliver produktoplysningerne automatisk opdateret i Heeros. "False": Hvis produktoplysningerne på den eksporterede faktura ikke stemmer overens med oplysningerne i Heeros, får du en fejlmeddelelse fra Heeros, når du eksporterer fakturaen. Produktoplysningerne oprettes altså ikke automatisk i Heeros, men du kan opdatere oplysningerne manuelt i Heeros og derefter eksportere fakturaen igen.
CreateAccountingObjects=<true/false>	Vælg, om konteringen skal oprettes automatisk i Heeros eller ej: "True" (standard): Når du eksporterer fakturaer, oprettes konteringen automatisk i Heeros. "False": Konteringen oprettes ikke automatisk i Heeros.

Fejlfinding

Fejlmeddelelser

Hvis eksporten til Heeros ikke virker, vises en fejlmeddelelse. Fejlmeddelelser vises kun, når der opstår fejl under eksport. Fejlmeddelelserne vises i et pop op-vindue og gemmes ikke nogen steder.

Fejlbesked	Beskrivelse
Det var ikke muligt at logge ind på Heeros. Enten er brugernavnet/adgangskoden forkert, eller også er det ikke muligt at oprette forbindelse til Heeros. Prøv igen om et par minutter.	Kontrollér, at felterne i Opter på fanen Filoverførsel, er korrekte: Klientidentitet: API-brugeridentitet fra Heeros. (Heeros-brugernavn.) Klientnøgle: API-nøgle fra Heeros. (Heeros-adgangskode.) (Se instruktionerne ovenfor.) Forsøg derefter at eksportere fakturaerne igen.
Fakturaen kunne ikke sendes til Heeros. Fejlkode fra Heeros: {0}. Fejlmeddelelse fra Heeros: {1}	Læs fejlkoden og fejlmeddelelsen fra Heeros, og forsøg at løse problemet. Derefter kan du forsøge at eksportere fakturaerne igen.
Fakturaen er sendt, men kunne ikke behandles i Heeros, fordi den ikke er fuldstændig. Tjek ufuldstændige fakturaer i Heeros. Faktura-ID i Heeros: {0}.	Kontakt Heeros, og bed om flere oplysninger.
Fakturaen er sendt, men kunne ikke bekræftes inden for tidsgrænsen. Tjek den ufuldstændige faktura i Heeros for at se, om den er modtaget, og hvad dens status er. Faktura-ID i Heeros: {0}.	Kontrollér fakturaen i Heeros, om den er ankommet til Heeros, og hvad dens status er. Du kan forsøge at eksportere fakturaen igen.
Faktura {1} kunne ikke sendes til Heeros på grund af valideringsfejl. Antal fejl: {2}. Kontakt venligst Opter-supporten.	Kontakt Opters support, hvis du får denne fejlmeddelelse.