Feilsøking og vanlige spørsmål (FAQ)
Her finner du vanlige feil, kjente begrensninger og ofte stilte spørsmål om Order Drop API.
INNHOLDSFORTEGNELSE
Vanlige feil
| Feilmelding | Betyr | Løsning |
|---|---|---|
Invalid JSON data passed in order field... | Dataen er ikke gyldig eller mangler påkrevde felt. Minst ett av kundens e-post eller kundenummer må være med og ha en verdi – organisasjonsnummer, kunde-ID eller Tripletex-ID er ikke nok alene | Kontroller datastrukturen, eventuelt sammen med den som har bygget integrasjonen |
Duplicate order on source | Det finnes allerede en ordre med samme kildereferanse. Normalt når duplikatsjekk er aktivert – ordren er allerede importert | Skal ordren likevel importeres på nytt, må den eksisterende slettes eller kildereferansen endres |
Missing customer in Telaris | Kunden finnes ikke og «Avvis manglende kunde» er aktivert | Opprett kunden manuelt, eller deaktiver innstillingen for å la API-et opprette kunden automatisk |
Missing product in Telaris: [produktreferanse] | Produktet finnes ikke og «Avvis manglende produkt» er aktivert. Hele ordren slettes – ingen delvis import. Feilmeldingen inkluderer produktreferansen | Opprett produktet med riktig produktnummer/SKU, eller deaktiver innstillingen |
| Ingen feilmelding (403) | Tilgangsnøkkelen mangler, er feil, eller API-brukeren er deaktivert/slettet. Nøkler utløper ikke – en nøkkel som har fungert slutter ikke å virke av seg selv | Kontroller at nøkkelen sendes korrekt i forespørselen |
Kjente begrensninger
- Ingen brukergrensesnitt for API-et – Order Drop API har ingen egen side i Telaris. Ordrer sendes programmatisk, og resultatet ses i ordrevisningen
- Produktoppslag følger fast rekkefølge – systemet prøver alltid produktnummer, deretter SKU, deretter OID. Er flere felt angitt på samme linje, blir det siste treffet stående
- Ingen delvis import – hvis «Avvis manglende produkt» er aktivert og ett produkt mangler, slettes hele ordren. Det opprettes ikke en ordre med de linjene som fant produkter
- Kunden rulles ikke tilbake – hvis «Avvis manglende produkt» sletter ordren, blir en kunde som ble opprettet automatisk i samme kall liggende igjen i Telaris
- Ingen automatisk oppdatering – en ordre opprettet via API-et kan ikke oppdateres ved å sende samme ordre på nytt. Endringer gjøres manuelt i ordrevisningen
- Adresseformat – leveringsadresse lagres som fritekst med mindre «Oppdater leveringsadresse» er aktivert. Fritekst er mindre strukturert og kan gi utfordringer ved etikettutskrift
- Kun ordreopprettelse – API-et oppretter ordrer, men kan ikke oppdatere, kansellere eller slette eksisterende ordrer
Hva modulen ikke gjør
- Ordrestatus-oppdatering – API-et oppdaterer ikke status på eksisterende ordrer i Telaris eller i det eksterne systemet
- Produktsync – synkroniserer ikke produkter mellom Telaris og det eksterne systemet
- Lagerstatus – sender ikke lagerbeholdning tilbake til det eksterne systemet
- Fakturering – ordrer importert via API-et behandles som vanlige ordrer og faktureres via Telaris' ordinære fakturaprosess
- Returer – API-et håndterer ikke returer eller kreditnotaer
Vanlige spørsmål
Hva er Order Drop API?
Et mottakspunkt i Telaris som lar eksterne systemer sende ordrer inn i Telaris automatisk. Integrasjoner som WooCommerce og Telaris Connect bruker dette i bakgrunnen.
Trenger jeg en lisens for å bruke Order Drop API?
Nei. Order Drop API er en del av grunnsystemet. Du trenger kun en API-bruker med tilgangsnøkkel.
Hva skjer med kunden når en ordre mottas?
Systemet forsøker å finne kunden basert på kundenummer, e-post eller andre identifikatorer. Finnes den ikke, opprettes den automatisk – med mindre «Avvis manglende kunde» er aktivert.
Hva skjer hvis et produkt ikke finnes i Telaris?
Ordrelinjen legges til uten produktkobling – kun tekst og pris fra den innsendte dataen. Er «Avvis manglende produkt» aktivert, avvises hele ordren i stedet.
Kan samme ordre importeres to ganger?
Som standard ja – API-et sjekker ikke automatisk for duplikater. Men det avsendende systemet kan aktivere duplikatsjekk ved å sende med en kildereferanse og et duplikatsjekk-flagg.
Hva er forskjellen på å bruke Order Drop API direkte og via en integrasjon?
Ingen funksjonell forskjell – integrasjoner som WooCommerce og MyStore bruker Order Drop API under panseret. Forskjellen er at integrasjonene håndterer datahenting og formatering automatisk, mens direkte bruk krever at den eksterne parten bygger dette selv.
Blir ordrer opprettet via API-et synlige i ordrelisten?
Ja. De er vanlige ordrer i Telaris og vises i ordrelisten, på kundekortet og i alle rapporter.
Kan jeg se hvilke ordrer som er importert via API-et?
Kunder opprettet via API-et merkes med en tag (for eksempel «orderdrop»). I tillegg lagres en kildereferanse på ordren som kan brukes for å søke og filtrere.
Hvem kan sende ordrer til API-et?
Alle med en gyldig API-nøkkel. Det er ingen begrensning på hvem som kan sende – tilgangen styres utelukkende via nøkkelen.
Frigis ordrelinjene automatisk?
Ja, som standard frigis alle ordrelinjer umiddelbart. Det avsendende systemet kan deaktivere dette per ordre, slik at linjene forblir ufrigitte og må behandles manuelt.
Kan jeg motta e-post når en ny ordre kommer inn?
Ja. Konfigurer en e-postadresse i systeminnstillingene for orderdrop-varsling. Meldingen inneholder ordrenummer og en direktelenke til ordren.
Ordliste
| Begrep | Forklaring |
|---|---|
| Order Drop | Prosessen med å sende ordredata til Telaris via API-et |
| API-nøkkel | Tilgangsnøkkel som autentiserer kall til API-et – opprettes for en API-bruker i Telaris |
| API-bruker | En egen brukertype i Telaris beregnet på systemintegrasjon – har tilgangsnøkkel i stedet for passord |
| Tilgangsnøkkel | Unik nøkkel som autentiserer kall til API-et |
| Kildereferanse | Eksternt referansenummer fra det avsendende systemet – brukes for duplikatsjekk og sporbarhet |
| Duplikatsjekk | Kontroll som avviser ordrer hvis det allerede finnes en med samme kildereferanse |
| Produktkobling | Prosessen der en ordrelinje kobles til et eksisterende produkt basert på produktnummer, SKU eller OID |
| Frigivelse | Ordrelinjer markeres som klare for plukking og lagerbehandling |
| Tag | Merkelapp som settes på kunder opprettet via API-et for sporbarhet i kundesøket |
| Adresseobjekt | Leveringsadressen lagret som en egen, strukturert post på ordren (navn, gate, postnr, by, land), i motsetning til ren tekst i ordrenotatet |
| Produkt-OID | Unik identifikator for et produkt i Telaris – forskjellig fra produktnummer og SKU |
| API-dokumentasjon | Teknisk dokumentasjon for utviklere som beskriver dataformat og autentisering for API-et |

Var denne artikkelen nyttig?
Så bra!
Takk for din tilbakemelding
Beklager at vi ikke kunne være mer til hjelp
Takk for din tilbakemelding
Tilbakemeldingen er sendt inn
Vi setter pris på tilbakemeldingen din og vil prøve å rette på artikkelen