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
| Felmeddelande | Betyder | Lö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 ensamt | Kontrollera datastrukturen, eventuellt tillsammans med den som byggt integrationen |
Duplicate order on source | Det finns redan en order med samma källreferens. Normalt när dubblettkontroll är aktiverad – ordern är redan importerad | Ska ordern ändå importeras på nytt måste den befintliga raderas eller källreferensen ändras |
Missing customer in Telaris | Kunden finns inte och «Avvisa saknad kund» är aktiverad | Skapa 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 produktreferensen | Skapa 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älv | Kontrollera 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
| Begrepp | Förklaring |
|---|---|
| Order Drop | Processen 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ändare | En egen användartyp i Telaris avsedd för systemintegration – har åtkomstnyckel i stället för lösenord |
| Åtkomstnyckel | Unik nyckel som autentiserar anrop till API:et |
| Källreferens | Externt referensnummer från det avsändande systemet – används för dubblettkontroll och spårbarhet |
| Dubblettkontroll | Kontroll som avvisar order om det redan finns en med samma källreferens |
| Produktkoppling | Processen där en orderrad kopplas till en befintlig produkt baserat på produktnummer, SKU eller OID |
| Frigöring | Orderrader markeras som klara för plockning och lagerhantering |
| Tagg | Etikett som sätts på kunder skapade via API:et för spårbarhet i kundsökningen |
| Adressobjekt | Leveransadressen lagrad som en egen, strukturerad post på ordern (namn, gata, postnr, ort, land), till skillnad från ren text i orderanteckningen |
| Produkt-OID | Unik identifierare för en produkt i Telaris – skild från produktnummer och SKU |
| API-dokumentation | Teknisk 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
Feddback skickat
Vi uppskattar din feedback och uppdaterar artikeln vid behov