Hva er Order Drop API?

Hva er Order Drop API?

Order Drop API er Telaris' mottakskanal for ordrer fra eksterne systemer. API-et tar imot en ordre som strukturerte data og oppretter den i Telaris – med ordrelinjer, kundedata og leveringsadresse. Finnes ikke kunden fra før, opprettes den automatisk.

API-et er grunnmuren for all ordreimport i Telaris. Ferdige integrasjoner som WooCommerce, MyStore og Telaris Connect bruker Order Drop API i bakgrunnen for å få ordrer inn. I tillegg kan eksterne parter – kunder med egne systemer, partnere eller tredjepartsutviklere – koble seg direkte på API-et.

MERK: Order Drop API er en del av grunnsystemet og krever ingen lisens. Det kreves kun en API-bruker med tilgangsnøkkel.

INNHOLDSFORTEGNELSE

• Hvilke utfordringer løser modulen?
• Funksjonell oversikt
• Typisk arbeidsflyt
• Samspill med andre moduler
• Viktige begreper

Hvilke utfordringer løser modulen?

Bedrifter som selger via nettbutikk, markedsplass eller andre kanaler trenger å få ordrer inn i ordresystemet uten manuelt arbeid. Typiske problemer:

• Manuell ordreregistrering – uten integrasjon må noen kopiere ordrer fra det eksterne systemet til Telaris for hånd
• Feil og forsinkelser – manuell overføring gir tastefeil, manglende linjer og forsinket leveranse
• Doble kunder – kunder fra det eksterne systemet må også opprettes manuelt i Telaris
• Manglende sporbarhet – vanskelig å vite hvilke ordrer som er importert og hvilke som gjenstår
• Skalering – ved økt volum blir manuell håndtering uholdbar
  
  

Order Drop API løser dette ved å:

• la eksterne systemer sende ordrer direkte til Telaris via et enkelt API-kall
• opprette kunden automatisk hvis den ikke finnes fra før
• koble ordrelinjer til riktige produkter basert på produktnummer eller SKU
• frigi ordrelinjer automatisk slik at ordren er klar for videre behandling umiddelbart
• sende e-postvarsling til ansvarlig ved ny ordre (valgfritt)
• avvise duplikater basert på kildereferanse (valgfritt)

Funksjonell oversikt

Typisk arbeidsflyt

1. Et eksternt system (nettbutikk, integrasjon, partnersystem) sender ordredata til Order Drop API
2. API-et autentiserer forespørselen via tilgangsnøkkel
3. Kunden identifiseres i Telaris – eller opprettes automatisk hvis den ikke finnes
4. Ordren opprettes med status «åpen»
5. Ordrelinjer legges til og kobles til produkter i Telaris
6. Linjene frigis automatisk (med mindre det er deaktivert i forespørselen)
7. Eventuelt sendes e-postvarsling til konfigurert mottaker
8. API-et returnerer ordrenummer, kundenummer og status

Samspill med andre moduler

• WooCommerce-integrasjonen – importerer ordrer fra WooCommerce-nettbutikker via Order Drop API
• Telaris Connect – mottar ordrer fra tilkoblede Telaris-instanser via Order Drop API
• Ordremodulen – ordrer opprettet via API-et håndteres som vanlige ordrer i Telaris
• Produktmodulen – ordrelinjer kobles til eksisterende produkter basert på produktnummer eller SKU
• Kundemodulen – kunder opprettes eller gjenbrukes automatisk
  
  

Til info: Det samme ordremottaket brukes også internt av Tripletex-integrasjonen ved import av fakturagrunnlag, og av ordrebooking fra objekt-/tagmodulen. Disse går gjennom samme logikk som eksterne ordreimporter.

Viktige begreper