Kunnskapsbase / Nettbutikk

Spørring mot produktlager via API

Lagerdataene dine kan også hentes programmatisk – de eksterne systemene dine kan alltid jobbe med sanntidstall.

Sellvio lar butikkeiere vise tilpassede produktutvalg på ulike listetjenester, for eksempel Facebook Shop, Olcsobbat.hu, Argep.hu osv., via API-tilgangs-URL-er.

Administrasjonsskjermen for produkt-API-et finner du i sidemenyen i administrasjonsgrensesnittet under «Nettbutikk» → «API».

For hver tjeneste som er oppført i administrasjonsskjermbildet for API, kreves det at butikkeieren har en konto hos den aktuelle tjenesten. Når kontoen er opprettet hos en bestemt tjeneste, kan butikkeieren kopiere den aktuelle API-lenken fra Sellvio og lime den inn på profilsiden sin hos tjenesteleverandøren.

Produktlistetjenester krever at butikkeiere konfigurerer kontoene sine på en bestemt måte. Se dokumentasjonen på tjenesteleverandørens nettsted for mer informasjon om hvordan API-lenkene integreres i systemet deres.

Produktene som listes opp, må også leveres i sin bestemte struktur. Sellvio håndterer produktstrukturen i bakgrunnen, så butikkeiere trenger ikke å tenke på dette.

Fanen Generelt

Innstillingene under fanen «Generelt» er like for alle tjenester. Derfor beskriver denne dokumentasjonen detaljene for én tjeneste, siden oppsettet er det samme for alle tjenestene.

  • De fleste produktlistetjenester er knyttet til et bestemt land. Administratorer kan filtrere listen etter land ved hjelp av nedtrekkslisten øverst på siden.
    Skjermbilde for dette trinnet
  • Navnet på produktlistetjenesten.
  • Kategorier – i kategorivalgfeltet kan butikkeiere angi hvilke nettbutikkategorier de vil ta med i produktlistetjenesten. Det er ingen grense for hvor mange kategorier du kan velge.
  • Merker – i produsentvalgfeltet kan butikkeiere angi hvilke produsenters produkter de vil ta med i produktlistetjenesten. Det er ingen grense for hvor mange produsenter du kan velge.
    Skjermbilde for dette trinnet
  • Priskategori – velg om detalj- eller engrosprodukter skal vises i produktlistetjenesten.
  • Kun merkede produkter – når dette er slått på, tas bare produkter som er spesifikt merket for formålet i administrasjonsgrensesnittet til nettbutikken, med i produktfeeden.
  • URL – dette feltet viser URL-en som genereres automatisk. Alle endringer du gjør i innstillingene over, oppdaterer den genererte URL-en automatisk. Språket i den genererte URL-en (/en, /hu, /sr) bestemmes av gjeldende språk i administrasjonsgrensesnittet. Det avgjør også hvilket språk produktene vises på i produktlistetjenesten. Når alle innstillingene er konfigurert, kan du enkelt kopiere API-URL-en til utklippstavlen ved å klikke på Kopier-knappen på slutten av URL-feltet.
    Skjermbilde for dette trinnet
  • I nedtrekkslisten «Format» kan du velge hvilket format produktene skal leveres i via URL-en.

Landet der tjenesten er tilgjengelig, vises øverst til høyre for tjenesten. Hvis tjenesten ikke er knyttet til et bestemt land, er den tilgjengelig over hele verden.

VIKTIG: Produkter som ikke er synlige eller ikke er tilgjengelige, vises ikke i produktlisten som deles via API-URL-en.

Fanen B2B API

Funksjonen «Bruker-API-tokener» gjør det mulig å opprette et API-endepunkt som inneholder en unik produktliste for en bestemt registrert bruker.

Ved å velge kategorier og produsenter i nettbutikken kan administratorer avgrense hvilke produkter fra butikken som skal inngå i API-endepunktet. Hvis ingen kategori eller produsent er valgt, inkluderer endepunktet alle tilgjengelige produkter fra nettbutikken. API-endepunktet gir også ytterligere produktdata, som nettopris, mva.-verdi, parametere og deklarasjonsopplysninger, inkludert nettovekt, bruttovekt og energiklasse.

Endepunktene til de opprettede bruker-API-tokenene er utvidet med mer detaljerte produktbildedata. Datasettet inneholder nå både produktets hovedbilde og øvrige bilder som er knyttet til produktet.

Ettersom endepunktet opprettes for en bestemt bruker, inkluderer produktene som leveres via API-URL-en, brukerrabatter på systemnivå. Disse kan konfigureres individuelt for hver registrerte bruker i menyen «Brukeradministrasjon» → «Brukere», under fanen «Rabatter». Hvis du trenger en rask oppfriskning om brukerspesifikke rabatter, kan du lese denne artikkelen.

  • Kategorier: I inndatafeltet for kategorivalg kan butikkeiere angi hvilke nettbutikk-kategorier produktene skal hentes fra. Det er ingen grense for hvor mange kategorier du kan velge.
  • Produsenter: I inndatafeltet for produsentvalg kan butikkeiere angi hvilke produsenters produkter som skal tas med. Det er ingen grense for hvor mange produsenter du kan velge.
    Skjermbilde for dette trinnet
  • Lagre – ved å velge lagre kan du filtrere hvilke produkter fra bestemte lagersteder som skal være tilgjengelige via API-endepunktet. Hvis du ikke velger noe lager, begrenser ikke systemet produktlisten etter lager.
  • Bruker: Den registrerte brukeren som API-endepunktet skal opprettes for. I dette feltet kan du søke på brukernavn eller e-postadresse.

Når du klikker på Lagre-knappen, opprettes API-endepunktet for den valgte brukeren med den angitte konfigurasjonen.

Alle API-endepunkter som er opprettet tidligere, er listet opp i fanen User API Tokens, under seksjonen Create User API Token.

Den registrerte brukerens navn og e-postadresse, samt antall endepunkter klienten bruker.

Brukernavn og e-post: den registrerte brukerens navn og e-postadresse, samt antall endepunkter klienten har brukt.

Delen med listen over endepunktene brukeren eier, kan du utvide eller skjule med pilknappen øverst til høyre i seksjonen. Administratorer kan velge endepunktformat og kopiere det opprettede endepunktet til utklippstavlen ved å klikke på knappen «Kopier» i formatnedtrekkslisten.

Hvis et API-endepunkt ikke lenger trengs, kan du enkelt slette det ved å klikke på det røde papirkurvikonet i enden av API-URL-oppføringen.

Når du klikker på den blå Innstillinger-knappen i enden av API-URL-oppføringen, vises konfigurasjonen endepunktet ble opprettet med.

VIKTIG: Eksisterende innstillinger for API-URL kan bare vises, ikke redigeres.