Katalog-SDK: last ned og kjør

Katalog-SDK: last ned og kjør

Katalog-SDK-en er et lite ferdiglaget program som kjøres på kundens egen datamaskin. Det logger inn i Telaris som kunden og lagrer én regnearkfil (CSV) per katalog kunden har tilgang til, med produkter, lager og kundens priser.

INNHOLDSFORTEGNELSE

• Hva er katalog-SDK-en?
• Last ned SDK-en
• Slik kjører kunden SDK-en
• Vanlige spørsmål

Hva er katalog-SDK-en?

Når SDK-en kjøres, lagrer den én CSV-fil per katalog kunden har tilgang til. Hver fil inneholder følgende kolonner:

MERK: Et produkt kommer kun med i SDK-eksporten hvis det har en verdi i feltet «Catalog links» (katalogkoblinger) på produktet. Produkter uten dette tas ikke med.

SDK-en lastes ned som en zip-fil oppkalt etter kunden, for eksempel acme-as_sdk_26.9.0.zip. Den inneholder alt som trengs, inkludert kundens egne Client ID og Client Secret, så kunden slipper å taste inn koder.

MERK: Fordi zip-filen inneholder hemmeligheten, må den behandles som et passord. Send den via en sikker kanal, og ikke til en delt innboks.

Last ned SDK-en

SDK-en lastes ned fra kundekortet: åpne kunden, gå til fanen «Price Lists» (Prislister) og klikk «Download SDK» (Last ned SDK). Fanen vises kun for lagrede kunder og kun for administratorer.

1. Har kunden ingen auth-klienter fra før: en ny SDK-klient opprettes og zip-filen lastes ned med en gang.
2. Har kunden allerede én eller flere klienter: dialogen «Download SDK» åpnes med kundens klienter. Velg eventuelt en annen rad, og velg Issue eller Rotate:
   
   

Til info: Nye SDK-klienter navngis «Kundenavn – SDK 1», «– SDK 2» osv., så de er lette å kjenne igjen i lista.

Slik kjører kunden SDK-en

1. Installer Node.js (versjon 18 eller nyere) fra nodejs.org. På Mac med Homebrew: brew install node.
2. Pakk ut zip-filen i en mappe du velger.
3. Kjør programmet. Mac/Linux: åpne et terminalvindu og kjør ./client.sh i mappa. Windows: åpne ledetekst (command prompt) i mappa og kjør node client.js.
4. Et nettleservindu åpnes med Telaris-innlogging. Åpnes det ikke, skriver programmet ut en lenke du kan lime inn i nettleseren.
5. Logg inn med kundens egen Telaris-pålogging (ikke en ansatt-pålogging).
6. Når nettleseren sier «Authentication succeeded», kan fanen lukkes. Programmet lagrer da én .csv-fil per katalog i samme mappe.
   
   

Kjører du det igjen senere, gjenbrukes påloggingen, så du trenger normalt ikke logge inn hver gang. Har påloggingen utløpt, åpnes nettleseren på nytt.

Til info: Mappa inneholder en fil som heter settings.json, som holder påloggingsopplysningene. Behold den privat, og ikke rediger eller slett den uten å ha fått beskjed om det.

Vanlige spørsmål

Jeg har mistet SDK-zip-filen eller hemmeligheten – hva gjør jeg?

Hemmeligheten kan ikke vises igjen. Du får en ny zip ved at klienten roteres (Rotate), slik at den gamle slutter å virke.

«node: command not found» når jeg kjører SDK-en

Node.js er ikke installert. Installer Node.js 18 eller nyere (se «Slik kjører kunden SDK-en»).

SDK-en ber om hostname, Client ID eller hemmelighet

Filen settings.json mangler eller er endret. Bruk en fersk SDK-zip, og pass på at alle filene pakkes ut sammen i samme mappe.

Nedlastingen feilet og ber meg laste siden på nytt

Påloggingen har trolig utløpt. Last siden på nytt og prøv igjen.

Integrasjonen sluttet å virke rett etter en rotering

Det gamle systemet har fortsatt den gamle hemmeligheten. Pass på at den nye hemmeligheten eller den nye SDK-zip-filen er tatt i bruk.