Oppsett og bruk

Oppsett og bruk

Denne veiledningen beskriver hva som må på plass for å ta Order Drop API i bruk – tilganger, API-bruker og innstillinger – og forskjellen på å bruke API-et via en ferdig integrasjon kontra å koble et eksternt system direkte på det.

INNHOLDSFORTEGNELSE

• Tilgangsstyring og rettigheter
• Forutsetninger
• Opprette API-bruker
• Konfigurere innstillinger
• Bruk via ferdig integrasjon
• Bruk fra eksternt system (direkte tilkobling)

Tilgangsstyring og rettigheter

Vanlige brukere og kunder har ikke direkte tilgang til Order Drop API. Tilgang krever en API-bruker med tilgangsnøkkel. Ordrer opprettet via API-et er synlige for alle som har tilgang til ordrevisningen – de behandles som vanlige ordrer.

Forutsetninger

Før ordreimporten fungerer, må dette være på plass:

• Lisens: ingen – Order Drop API er en del av grunnsystemet
  
  
• API-bruker med tilgangsnøkkel (opprettes av systemadministrator)
  
  
• Produkter registrert i Telaris med riktig produktnummer eller SKU. Linjer uten treff legges til uten produktkobling (med mindre «Avvis manglende produkt» er aktivert)
  
  
• Kundedata: den innsendte dataen må inneholde enten kundens e-postadresse eller kundenummer med utfylt verdi. Andre identifikatorer (organisasjonsnummer, intern kunde-ID, Tripletex-ID) kan brukes til selve oppslaget, men er ikke tilstrekkelig alene – forespørselen avvises før oppslaget skjer

Opprette API-bruker

En API-bruker opprettes av systemadministrator og får en tilgangsnøkkel som brukes til autentisering i alle API-kall:

1. Kontakt systemadministrator for å opprette en API-bruker
2. Motta tilgangsnøkkelen
3. Oppgi nøkkelen til den som skal integrere – enten et Telaris-integrasjonsteam eller en ekstern part

Tilgangsnøkkelen er varig og trenger ikke fornyes med jevne mellomrom.

Tips: Fremgangsmåten for å opprette API-brukeren steg for steg er beskrevet i artikkelen «Opprette API-bruker».

Konfigurere innstillinger

Innstillingene for Order Drop API konfigureres via Telaris support/prosjekt Det finnes ingen dedikerte felter – innstillingene legges inn som nøkkel/verdi-par:

• Avvis manglende kunde– aktiver hvis kun eksisterende kunder skal få ordrer importert
  
  
• Avvis manglende produkt – aktiver hvis alle produkter i ordrelinjene må finnes i Telaris
  
  
• Oppdater leveringsadresse – aktiver for å lagre leveringsadresse som eget adresseobjekt i stedet for fritekst
  
  
• Varslingsmottaker – sett e-postadresse for å motta varsling ved nye ordrer
  
  

Til info: En fullstendig forklaring av hva hver innstilling gjør, finner du i artikkelen «Slik fungerer ordreimporten».

Bruk via ferdig integrasjon

Order Drop API brukes normalt ikke direkte av sluttbrukere, men av integrasjoner. Når en integrasjon er satt opp, flyter ordrer automatisk inn i Telaris:

• WooCommerce-integrasjonen – konfigureres som integrasjonsapp under Administrasjon → Integrasjoner
• Telaris Connect – mottar ordrer fra tilkoblede Telaris-instanser
  
  

For ferdigbygde integrasjoner er alt API-arbeidet allerede håndtert. Oppsettet er da det som står i den aktuelle integrasjonens egen artikkel.

Bruk fra eksternt system (direkte tilkobling)

Eksterne parter – kunder, partnere eller tredjepartsutviklere – kan koble seg direkte på Order Drop API. Det er relevant når:

• Kunden har et eget ordresystem, ERP eller nettbutikk uten en ferdig Telaris-integrasjon
• En partner eller leverandør vil sende ordrer automatisk
• En utvikler bygger en egendefinert integrasjon
  
  

Slik kommer man i gang (Telaris' side):

1. Systemadministrator oppretter en API-bruker og deler tilgangsnøkkelen med den eksterne parten
2. Den eksterne parten mottar Telaris' API-dokumentasjon som beskriver dataformat og autentisering
3. Den eksterne parten bygger integrasjonen i sitt system – typisk ved å sende ordredata til API-et via et standard HTTP-kall
4. Test med en prøveordre og verifiser at den opprettes korrekt i Telaris
5. Sett i produksjon
   
   

MERK: Telaris' side dekker å opprette API-bruker, konfigurere innstillinger, dele dokumentasjon og verifisere at mottak fungerer, samt en kort gjennomgang av API-et. Testing og feilsøking der Telaris er involvert kommer i tillegg og varierer med den eksterne partens kompetanse. Den eksterne partens eget utviklingsarbeid – å bygge, formatere, teste og feilsøke på sin side – ligger utenfor Telaris' ansvarsområde.

Til info: API-dokumentasjonen er teknisk og beregnet på utviklere. Onboarding- og supportpersonell trenger normalt ikke å lese den – det holder å vite at den finnes og kan deles med den eksterne parten.