Felsökning och vanliga frågor (FAQ)

Felsökning och vanliga frågor (FAQ)


Här hittar du vanliga fel, kända begränsningar och ofta ställda frågor om Order Drop API.



INNEHÅLLSFÖRTECKNING


Vanliga fel


FelmeddelandeBetyderLösning
Invalid JSON data passed in order field...Datan är inte giltig eller saknar obligatoriska fält. Minst ett av kundens e-post eller kundnummer måste vara med och ha ett värde – organisationsnummer, kund-ID eller Tripletex-ID räcker inte ensamtKontrollera datastrukturen, eventuellt tillsammans med den som byggt integrationen
Duplicate order on sourceDet finns redan en order med samma källreferens. Normalt när dubblettkontroll är aktiverad – ordern är redan importeradSka ordern ändå importeras på nytt måste den befintliga raderas eller källreferensen ändras
Missing customer in TelarisKunden finns inte och «Avvisa saknad kund» är aktiveradSkapa kunden manuellt, eller inaktivera inställningen för att låta API:et skapa kunden automatiskt
Missing product in Telaris: [produktreferens]Produkten finns inte och «Avvisa saknad produkt» är aktiverad. Hela ordern raderas – ingen delvis import. Felmeddelandet inkluderar produktreferensenSkapa produkten med rätt produktnummer/SKU, eller inaktivera inställningen
Inget felmeddelande (403)Åtkomstnyckeln saknas, är fel, eller API-användaren är inaktiverad/raderad. Nycklar upphör inte att gälla – en nyckel som har fungerat slutar inte fungera av sig självKontrollera att nyckeln skickas korrekt i förfrågan



Kända begränsningar


  • Inget användargränssnitt för API:et – Order Drop API har ingen egen sida i Telaris. Order skickas programmatiskt, och resultatet ses i ordervyn

  • Produktuppslag följer fast ordning – systemet provar alltid produktnummer, sedan SKU, sedan OID. Om flera fält anges på samma rad blir den sista träffen kvar

  • Ingen delvis import – om «Avvisa saknad produkt» är aktiverad och en produkt saknas raderas hela ordern. Det skapas inte en order med de rader som hittade produkter

  • Kunden rullas inte tillbaka – om «Avvisa saknad produkt» raderar ordern blir en kund som skapades automatiskt i samma anrop kvar i Telaris

  • Ingen automatisk uppdatering – en order skapad via API:et kan inte uppdateras genom att skicka samma order på nytt. Ändringar görs manuellt i ordervyn

  • Adressformat – leveransadressen lagras som fritext om inte «Uppdatera leveransadress» är aktiverad. Fritext är mindre strukturerad och kan ge utmaningar vid etikettutskrift

  • Endast orderskapande – API:et skapar order, men kan inte uppdatera, annullera eller radera befintliga order



Vad modulen inte gör


  • Orderstatusuppdatering – API:et uppdaterar inte status på befintliga order i Telaris eller i det externa systemet
  • Produktsynk – synkroniserar inte produkter mellan Telaris och det externa systemet
  • Lagerstatus – skickar inte lagersaldo tillbaka till det externa systemet
  • Fakturering – order importerade via API:et hanteras som vanliga order och faktureras via Telaris ordinarie fakturaprocess
  • Returer – API:et hanterar inte returer eller kreditnotor



Vanliga frågor


Vad är Order Drop API?

En mottagningspunkt i Telaris som låter externa system skicka order in i Telaris automatiskt. Integrationer som WooCommerce och Telaris Connect använder detta i bakgrunden.

Behöver jag en licens för att använda Order Drop API?

Nej. Order Drop API är en del av grundsystemet. Du behöver endast en API-användare med åtkomstnyckel.

Vad händer med kunden när en order tas emot?

Systemet försöker hitta kunden baserat på kundnummer, e-post eller andra identifierare. Finns den inte skapas den automatiskt – om inte «Avvisa saknad kund» är aktiverad.

Vad händer om en produkt inte finns i Telaris?

Orderraden läggs till utan produktkoppling – endast text och pris från den inskickade datan. Är «Avvisa saknad produkt» aktiverad avvisas hela ordern i stället.

Kan samma order importeras två gånger?

Som standard ja – API:et kontrollerar inte automatiskt för dubbletter. Men det avsändande systemet kan aktivera dubblettkontroll genom att skicka med en källreferens och en dubblettkontroll-flagga.

Vad är skillnaden mellan att använda Order Drop API direkt och via en integration?

Ingen funktionell skillnad – integrationer som WooCommerce och MyStore använder Order Drop API under huven. Skillnaden är att integrationerna hanterar datahämtning och formatering automatiskt, medan direkt användning kräver att den externa parten bygger detta själv.

Blir order skapade via API:et synliga i orderlistan?

Ja. De är vanliga order i Telaris och visas i orderlistan, på kundkortet och i alla rapporter.

Kan jag se vilka order som importerats via API:et?

Kunder skapade via API:et märks med en tagg (till exempel «orderdrop»). Dessutom lagras en källreferens på ordern som kan användas för att söka och filtrera.

Vem kan skicka order till API:et?

Alla med en giltig API-nyckel. Det finns ingen begränsning på vem som kan skicka – åtkomsten styrs uteslutande via nyckeln.

Frigörs orderraderna automatiskt?

Ja, som standard frigörs alla orderrader omedelbart. Det avsändande systemet kan inaktivera detta per order, så att raderna förblir ofrigjorda och måste behandlas manuellt.

Kan jag få e-post när en ny order kommer in?

Ja. Konfigurera en e-postadress i systeminställningarna för orderdrop-avisering. Meddelandet innehåller ordernumret och en direktlänk till ordern.



Ordlista


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 – har åtkomstnyckel i stället för lösenord
ÅtkomstnyckelUnik nyckel som autentiserar anrop till API:et
KällreferensExternt referensnummer från det avsändande systemet – används för dubblettkontroll och spårbarhet
DubblettkontrollKontroll som avvisar order om det redan finns en med samma källreferens
ProduktkopplingProcessen där en orderrad kopplas till en befintlig produkt baserat på produktnummer, SKU eller OID
FrigöringOrderrader markeras som klara för plockning och lagerhantering
TaggEtikett som sätts på kunder skapade via API:et för spårbarhet i kundsökningen
AdressobjektLeveransadressen lagrad som en egen, strukturerad post på ordern (namn, gata, postnr, ort, land), till skillnad från ren text i orderanteckningen
Produkt-OIDUnik identifierare för en produkt i Telaris – skild från produktnummer och SKU
API-dokumentationTeknisk dokumentation för utvecklare som beskriver dataformat och autentisering för API:et







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