Feilsøking og vanlige spørsmål (FAQ)

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


FeilmeldingBetyrLø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 aleneKontroller datastrukturen, eventuelt sammen med den som har bygget integrasjonen
Duplicate order on sourceDet finnes allerede en ordre med samme kildereferanse. Normalt når duplikatsjekk er aktivert – ordren er allerede importertSkal ordren likevel importeres på nytt, må den eksisterende slettes eller kildereferansen endres
Missing customer in TelarisKunden finnes ikke og «Avvis manglende kunde» er aktivertOpprett 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 produktreferansenOpprett 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 selvKontroller 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


BegrepForklaring
Order DropProsessen med å sende ordredata til Telaris via API-et
API-nøkkelTilgangsnøkkel som autentiserer kall til API-et – opprettes for en API-bruker i Telaris
API-brukerEn egen brukertype i Telaris beregnet på systemintegrasjon – har tilgangsnøkkel i stedet for passord
TilgangsnøkkelUnik nøkkel som autentiserer kall til API-et
KildereferanseEksternt referansenummer fra det avsendende systemet – brukes for duplikatsjekk og sporbarhet
DuplikatsjekkKontroll som avviser ordrer hvis det allerede finnes en med samme kildereferanse
ProduktkoblingProsessen der en ordrelinje kobles til et eksisterende produkt basert på produktnummer, SKU eller OID
FrigivelseOrdrelinjer markeres som klare for plukking og lagerbehandling
TagMerkelapp som settes på kunder opprettet via API-et for sporbarhet i kundesøket
AdresseobjektLeveringsadressen lagret som en egen, strukturert post på ordren (navn, gate, postnr, by, land), i motsetning til ren tekst i ordrenotatet
Produkt-OIDUnik identifikator for et produkt i Telaris – forskjellig fra produktnummer og SKU
API-dokumentasjonTeknisk 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

Fortell oss hvordan vi kan forbedre denne artikkelen.

Velg minst én av grunnene
CAPTCHA-verifisering er obligatorisk.

Tilbakemeldingen er sendt inn

Vi setter pris på tilbakemeldingen din og vil prøve å rette på artikkelen