Vad är Order Drop API?

Vad är Order Drop API?


Order Drop API är Telaris mottagningskanal för order från externa system. API:et tar emot en order som strukturerade data och skapar den i Telaris – med orderrader, kunddata och leveransadress. Finns inte kunden sedan tidigare skapas den automatiskt.

API:et är grundstommen för all orderimport i Telaris. Färdiga integrationer som WooCommerce, MyStore och Telaris Connect använder Order Drop API i bakgrunden för att få in order. Dessutom kan externa parter – kunder med egna system, partner eller tredjepartsutvecklare – ansluta direkt till API:et.


OBS: Order Drop API är en del av grundsystemet och kräver ingen licens. Det krävs endast en API-användare med åtkomstnyckel.



INNEHÅLLSFÖRTECKNING


Vilka utmaningar löser modulen?


Företag som säljer via webbutik, marknadsplats eller andra kanaler behöver få order in i ordersystemet utan manuellt arbete. Typiska problem:

  • Manuell orderregistrering – utan en integration måste någon kopiera order från det externa systemet till Telaris för hand
  • Fel och förseningar – manuell överföring ger skrivfel, saknade rader och försenad leverans
  • Dubbla kunder – kunder från det externa systemet måste också skapas manuellt i Telaris
  • Bristande spårbarhet – svårt att veta vilka order som importerats och vilka som återstår
  • Skalning – vid ökad volym blir manuell hantering ohållbar

Order Drop API löser detta genom att:

  • låta externa system skicka order direkt till Telaris via ett enkelt API-anrop
  • skapa kunden automatiskt om den inte redan finns
  • koppla orderrader till rätt produkter baserat på produktnummer eller SKU
  • frigöra orderrader automatiskt så att ordern är klar för vidare behandling omedelbart
  • skicka e-postavisering till ansvarig vid ny order (valfritt)
  • avvisa dubbletter baserat på källreferens (valfritt)



Funktionell översikt


FunktionBeskrivning
OrderskapandeTar emot orderdata och skapar order med rader i Telaris
KundhanteringHittar befintlig kund eller skapar ny baserat på medskickad kunddata
ProduktkopplingKopplar orderrader till produkter via produktnummer, SKU eller produkt-OID
LeveransadressLagrar leveransadressen på ordern – antingen som fritext i orderanteckningen eller som ett strukturerat adressobjekt
DubblettkontrollAvvisar order med samma källreferens som en befintlig order (valfritt)
Automatisk frigöringFrigör orderrader automatiskt så att ordern är klar för plockning
E-postaviseringSkickar meddelande till en e-postadress när en ny order skapas (valfritt)



Typiskt arbetsflöde


  1. Ett externt system (webbutik, integration, partnersystem) skickar orderdata till Order Drop API
  2. API:et autentiserar förfrågan via åtkomstnyckeln
  3. Kunden identifieras i Telaris – eller skapas automatiskt om den inte finns
  4. Ordern skapas med status «öppen»
  5. Orderrader läggs till och kopplas till produkter i Telaris
  6. Raderna frigörs automatiskt (om det inte är inaktiverat i förfrågan)
  7. Eventuellt skickas e-postavisering till konfigurerad mottagare
  8. API:et returnerar ordernummer, kundnummer och status



Samspel med andra moduler


  • WooCommerce-integrationen – importerar order från WooCommerce-webbutiker via Order Drop API
  • Telaris Connect – tar emot order från anslutna Telaris-instanser via Order Drop API
  • Ordermodulen – order skapade via API:et hanteras som vanliga order i Telaris
  • Produktmodulen – orderrader kopplas till befintliga produkter baserat på produktnummer eller SKU
  • Kundmodulen – kunder skapas eller återanvänds automatiskt

Till info: Samma ordermottagning används även internt av Tripletex-integrationen vid import av fakturaunderlag, och av orderbokning från objekt-/taggmodulen. Dessa går genom samma logik som externa orderimporter.



Viktiga begrepp


BegreppFörklaring
Order DropProcessen att skicka orderdata till Telaris via API:et
API-nyckelÅtkomstnyckel som autentiserar anrop till API:et – skapas för en API-användare i Telaris
API-användareEn egen användartyp i Telaris avsedd för systemintegration, inte mänsklig inloggning
KällreferensExternt referensnummer från det avsändande systemet – används för dubblettkontroll och spårbarhet
ProduktkopplingOrderraden kopplas till en befintlig produkt baserat på produktnummer, SKU eller produkt-OID
FrigöringOrderrader markeras som klara för plockning och lagerhantering
AdressobjektLeveransadressen lagrad som en egen, strukturerad post på ordern (namn, gata, postnr, ort, land), till skillnad från ren text i orderanteckningen



Var artikeln till hjälp?

Toppen!

Tack för din feedback

Vi beklagar att det inte var till hjälp

Tack för din feedback

Berätta för oss hur vi kan förbättra den här artikeln!

Välj minst en av orsakerna
CAPTCHA-verifiering krävs.

Feddback skickat

Vi uppskattar din feedback och uppdaterar artikeln vid behov