Denne artikkelen beskriver kort hva PowerOffice sitt api er, hva det kan benyttes til og utvalgte muligheter via api'et. Deretter gis det informasjon om hvem som kan benytte seg av PowerOffice api'et, hvilke typiske brukere av vårt api vi har og hvilke kommersielle hensyn som gjelder, samt hvilken rolle PowerOffice har i integrasjonsprosessen og kravet om en integrasjonsavtale for tilgang. Til slutt informeres det om tilgjengelige integrasjoner sammen med en video som kort forklarer integrasjonsmulighetene i PowerOffice.

Begreper og terminologi

Her avklares noen begreper og terminologi som benyttes videre i denne artikkelen:

• API: "Application Programing Interface", et grensesnitt for utveksling av data mellom systemer
• Integrasjon: Sammenkobling av tekniske systemer, programvare eller applikasjoner for sømløs overføring av data
• Testmiljø: Et eget isolert miljø ment for testing, utforskning og demonstrasjoner, uten risiko for påvirkning av reelle regnskap, kundeforhold osv. Testmiljøet vårt ligger på nettsiden https://godemo.poweroffice.net/
• Produksjonsmiljø: Live miljøet med reell kundedata og reell bruk av PowerOffice
• Endepunkt: I praksis en nettadresse for å nå en bestemt ressurs i vårt api. Eksempelvis vil https://goapi.poweroffice.net/v2/Customers være hovedadressen til endepunktene for å opprette, endre eller hente kunder fra PowerOffice klienter.

Hva er PowerOffice api

Api står for "Application Programming Interface", og er et grensesnitt for å utveksle data mellom to forskjellige systemer. PowerOffice api'et er altså et programmeringsgrensesnitt for eksterne parter som vil utveksle data med PowerOffice. 

Fordelen med bruk av api'et er at eksterne systemer kan kommunisere direkte med PowerOffice, og dermed automatisere en rekke prosesser som ellers vil måtte håndteres manuelt gjennom bilagsregistrering eller manuell import av filer. Med api kan datautveksling kjøres automatisk, og reduserer dobbeltarbeid og risiko for feil som følge av manuell håndtering av data.

Api'et åpner muligheten for at en rekke ulike systemer og spesialiserte løsninger kan integreres med PowerOffice, slik at våre kunder kan jobbe med de spesialiserte verktøyene som passer best for sin arbeidshverdag.

Vårt api er åpent, som betyr at den tekniske informasjon ligger fritt tilgjengelig på våre nettsider for aktører som ønsker å se på mulighetene for integrasjon. Det betyr også at tilgang til testing er enkelt å komme i gang med i vårt dedikerte testmiljø. Vi jobber hele tiden med å dekke behovene til våre kunder og har derfor gjort det enkelt for tredjepartsleverandører å integrere seg med PowerOffice. 

Åpen tilgjengelig dokumentasjon av vårt api finner du her: https://developer.poweroffice.net/. Eventuelle spørsmål om api'et kan sendes til vårt api team på e-post: go-api@poweroffice.no

Hva kan PowerOffice api'et benyttes til

Api'et vårt kan overordnet utnyttes til å gjøre følgende tre operasjoner:

• Hente ut data fra PowerOffice for bruk i det eksterne systemet
• Sende inn og opprette data fra eksternt system til PowerOffice, eller endre/oppdatere data som allerede er i PowerOffice
• Starte prosesser i PowerOffice som utnytter funksjonalitet som ligger i PowerOffice

Vi har delt inn vårt API i ulike endepunkter. Hver slikt endepunkt er knyttet til et bestemt element eller bestemt funksjon i Go, og vi har rettighetsstyring knyttet til disse endepunktene i forhold til hva en integrasjon har tilgang til å gjøre.

Et eksempel på slike endepunkt er "Customer", som benyttes for å opprette, endre eller lese ut kunder. Et annet eksempel på endepunkt er "SalesOrders", som benyttes for å opprette ordre/fakturautkast i PowerOffice basert på grunnlag fra et ekstern system. En integrasjon som skal overføre ordre/fakturautkast til PowerOffice, må nødvendigvis ha tilganger til både "Customer" og "SalesOrders" for å kunne gjøre dette.

Utvalgte muligheter via api

• Hente, opprette eller endre grunndata:
  • Kunder
  • Leverandører
  • Ansatte (men ikke arbeidsforhold)
  • Prosjekt
  • Avdeling
  • Produkter
  • Kontoer
• Vanlige funksjoner:
  • Opprette ordre/fakturautkast, og sende faktura
  • Overføre og bokføre bilag i PowerOffice
  • Hente ut regnskapstransaksjoner, saldobalanser og reskontroinformasjon for rapportering
• Særskilt funksjonalitet:
  • Inkasso: Mulighet for inkassobyrå å integrere mot en dedikert arbeidsflyt i PowerOffice
  • Factoring: Mulighet for factoringselskap å integrere mot en dedikert arbeidsflyt i PowerOffice

Hvem kan bruke PowerOffice api, og hvordan komme i gang?

Type brukere av vårt api

Det er hovedsakelig tre type brukere av vårt api:

• Kunder: Våre kunder kan selv integrere sine løsninger til bruk på egne klienter. Kunder kan også lage integrasjoner som kan tilbys andre kunder som et produkt
• Systemleverandører: Systemleverandører som ønsker det, kan lage en integrasjon for systemet de tilbyr mot PowerOffice, som da generelt kan tilbys kunder som benytter PowerOffice og det aktuelle eksterne systemet
• Integrasjonspartnere: En rekke aktører spesialiserer seg på å tilby integrasjoner mellom systemer, som kan tilbys PowerOffice kunder. En oversikt over slike aktører har vi på våre nettsider her: https://www.poweroffice.no/utvidelser/kategorier/integrasjonspartnere

Kommersielle hensyn

Tilgang til testmiljøet vårt er kostnadsfritt for alle, og direkte api relatert support knyttet til integrasjonsprosessen tilbyr vi også vederlagsfritt. Tilgang til produksjonsmiljøet vårt, og publisering på våre nettsider og nyhetsbrev er også kostnadsfritt.

Unntakene er integrasjoner som berører finansielle tjenester eller dedikerte integrasjonsprosesser vi har utviklet, herunder inkasso og factoring. Slike integrasjonsparter må ha en særskilt avtale med oss for å gå live i vårt produksjonsmiljø.

Integrasjonsparter står på sin side fritt til å kommersialisere sin integrasjon.

PowerOffice sin rolle i integrasjonsprosessen

PowerOffice stiller oss gjerne disponible for en dialog om integrasjonen, anbefalinger knyttet til bruk av vårt api og prosessen som skal integreres. Dialog med integrasjonspart tar vi gjennom kanalen go-api@poweroffice.no, hvor korrespondansen er tilgjengelig for vårt api team.

PowerOffice er imidlertid ikke direkte involvert i selve utviklingen, testing eller drift av integrasjoner. Integrasjonspart står ansvarlig for funksjonaliteten og dataflyten som integreres, herunder support og vedlikehold av denne. Vi har et åpent api, og har innrettet oss slik for at dette skal være skalerbart fra vår side, og enkelt å komme i gang med fra integrasjonspartens side.

Fra PowerOffice sin side oppfordrer vi til at aktører som integrerer har en fastsatt plan og en kravspesifikasjon på hva som skal lages, og at dette er kvalitetssikret med brukere og aller helst regnskapsfører dersom integrasjonen involverer bokføring i regnskapet.

Før aktører får tilgang til til produksjonsmiljøet vårt, utfører en api teamet en overordnet kvalitetssikring av integrasjonsflyten sammen med integrasjonsparten. Dette gjelder særlig for de integrasjoner som vi skal markedsføre.

Integrasjonsavtale med ekstern part

For å få tilgang til produksjonsmiljøet vårt må integrasjonsparter akseptere og signere en integrasjonsavtale som omhandler bruken av vårt api.  

Dette er en standardisert avtale som er utarbeidet av Visma, supplert med informasjon og forventninger som er spesifikk for PowerOffice AS og vårt api. Avtalen er tilgjengelig her.

Oversikt over integrasjoner

Gjennom vårt api kan eksterne utviklere lage skreddersydde integrasjoner. Api'et utvikles kontinuerlig og stadig nye systemer og tredjeparter integrerer seg mot api'et og videreutvikler sine integrasjoner over tid. En full oversikt over systemer og tredjeparter integrert med PowerOffice er listet opp her: https://www.poweroffice.no/utvidelser