Senast uppdaterad: 2024-09-10
Fakturaexport till Heeros (API)
I den här artikeln
Du kan koppla ihop (integrera) Opter med ekonomisystemet Heeros. Därefter kan du exportera fakturor från Opter till Heeros. Mer information om Heeros finns på heeros.com (på finska) och heeros.com/en (på engelska).
Steg 1: Skapa en fakturaexport för Heeros i Opter
-
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 ”Heeros (API)”.
-
Rapport: Ingen.
-
Typ: XmlSerializer. (Typ måste vara XmlSerializer.)
-
Encoding: UTF-8.
-
Kundkod: Du hittar din kundkod i Heeros, ”la_id” eller "end customer id" (”loppuasiakastunnus”).
-
Kontorskod: Du hittar din kontorskod i Heeros, ”tt_id” eller "accounting customer id" (”tilitoimistotunnus”).
-
Starttext: I det här fältet kan du lägga till övriga parametrar för att anpassa exporten.
Använd formatet är ”parameter=värde” och skriv en parameter per rad, som i exemplet nedan.
Exempel, fältet StarttextMoveOnlyToLedger=true
SendToCustomer=false
CreateCustomer=true
UpdateCustomer=true
CreateProduct=true
UpdateProduct=true
CreateAccountingObjects=trueOm du inte skriver in en viss parameter i fältet Starttext, så används standardinställningen. Mer information om parametrarna finns i tabellen Parametrar i fältet Starttext nedan.
-
Markera kryssrutan En fil per faktura.
-
-
Klicka på
för att spara alla ändringar.
-
Klicka på fliken Filöverföring. Följande fält måste fyllas i:
-
Metod: Heeros API.
-
Klientidentitet: API-användaridentitet från Heeros. (”Heeros user name”.)
-
Klientnyckel: API-nyckeln från Heeros. (”Heeros password”.)
-
-
Klicka på
för att spara alla ändringar.
Steg 2: Lägga in transformen på fakturaexporten
Det här steget beställs av Opter. Kontakta för mer information.
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 Heeros, gör så här:
-
Klicka på Ekonomi > Fakturor > Fakturaexportinställningar.
-
Titta i listan till vänster om det redan finns en fakturaexportinställning (grupp) där du vill lägga till fakturaexporten till Heeros. Klicka på den fakturaexportinställningen och markera kryssrutan för ”Heeros 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 Heeros, så skapar du en ny. Klicka på
och ge fakturaexportinställningen ett namn, till exempel ”Heeros API”. Markera kryssrutan för ”Heeros API” (eller det namn du gav fakturaexporten) under Exporter.
-
Klicka på
för att spara alla ändringar.
-
Välj vilken av fakturaexportinställningarna som ska vara standard. För att välja Heeros API som standard, markera ”Heeros API” i listan till vänster och klicka på
.
-
För att försäkra sig om att alla fakturor blir bokförda i Heeros, markera ”Heeros API”-exporten för samtliga exportinställningar (grupper).
-
Klicka på
för att spara alla ändringar.
-
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 Heeros
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.
-
Klicka på Ekonomi > Fakturor > Fakturor.
-
Markera den faktura eller fakturaperiod du vill exportera, högerklicka och välj Exportera.
-
Klicka på Exportera och skicka för att exportera fakturan eller fakturaperioden till Heeros.
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.
Det kan ta väldigt lång tid att exportera fakturor till Heeros. Det beror på hur Heeros system är byggt. Vi rekommenderar att ni startar en separat instans av Opter och exporterar fakturorna från den. Då kan ni låta exporten stå så länge det behövs utan att behöva avbryta den.
Parametrar i fältet Starttext
Tabellen listar de parametrar som du kan skiva in i fältet Starttext. Mer information och ett exempel finns i Steg 1 ovan.
Parameter | Beskrivning |
---|---|
MoveOnlyToLedge=<true/false> |
Fakturor i Heeros kan skickas till mottagaren (kunden) via Opentext. Välj om fakturan ska skickas automatiskt till Opentext eller inte:
Endast en av parametrarna MoveOnlyToLedge och SendToCustomer (se nedan) kan vara satt till ”true”. |
SendToCustomer=<true/false> |
Välj om fakturan ska skickas automatiskt till kunden eller inte:
Endast en av parametrarna MoveOnlyToLedge (se ovan) och SendToCustomer kan vara satt till ”true”. |
CreateCustomer=<true/false> |
Välj om kunden ska skapas automatiskt i Heeros eller inte:
|
UpdateCustomer=<true/false> |
Välj om kundinformationen ska uppdateras automatiskt i Heeros eller inte:
|
CreateProduct=<true/false> |
I Opter kan man lista artiklar och/eller produkter på fakturan, (man brukar välja att använda artiklar eller produkter). I Heeros kallas det bara produkter. Välj om produkten ska skapas automatiskt i Heeros eller inte:
|
UpdateProduct=<true/false> |
I Opter kan man lista artiklar och/eller produkter på fakturan, (man brukar välja att använda artiklar eller produkter). I Heeros kallas det bara produkter. Välj om produkten ska uppdateras automatiskt i Heeros eller inte:
|
CreateAccountingObjects=<true/false> |
Välj om konteringen ska skapas automatiskt i Heeros eller inte:
|
Felsökning
Felmeddelanden
Om exporten till Heeros inte fungerar visas ett felmeddelande. Felmeddelanden visas endast när man exporterar och något går fel. Felmeddelandena visas i ett popup-fönster, de sparas inte någonstans.
Felmeddelande | Beskrivning |
---|---|
Det går inte att logga in på Heeros. Antingen är användarnamnet/lösenordet felaktigt, eller så går det inte att ansluta till Heeros. Pröva igen om några minuter. |
Kontrollera att det står rätt i Opter, på fliken Filöverföring, i fälten:
(Se instruktionen ovan.) Pröva sedan att exportera fakturorna igen. |
Det gick inte att skicka fakturan till Heeros. Felkod från Heeros: {0}. Felmeddelande från Heeros: {1} |
Läs felkoden och felmeddelandet från Heeros och försök att åtgärda problemet. Därefter kan du pröva att exportera fakturorna igen. |
Fakturan har skickats men kunde inte hanteras i Heeros eftersom den inte är fullständig. Kontrollera ofullständiga fakturor i Heeros. Faktura-ID i Heeros: {0}. |
Kontakta Heeros och be om mer information. |
Fakturan har skickats men kunde inte bekräftas inom tidsgränsen. Kontrollera ofullständiga fakturor i Heeros för att se om den har kommit in och vad den har för status. Faktura-ID i Heeros: {0}. |
Kontrollera fakturan i Heeros, om den har kommit till Heeros och vad den har för status. Du kan pröva att exportera fakturan igen. |
Det gick inte att skicka faktura {0} till Heeros på grund av valideringsfel. Antal fel: {1}. Kontakta Opter-supporten. |
Kontakta supporten på Opter om du får detta felmeddelande. |