BunStackDocs

Integrasjoner og API

ProSmart: tilkobling og miljøer

Koble til ProSmart i Test eller Production: feltene, innloggingskontrollen, bytte av miljø, Kustom-testordrer og frakobling.

Sist oppdatert · 4 min lesing

Her kobler du til ProSmart og velger Test eller Production.

Hvor: Stack › ProSmart › Settings.

Koble til ProSmart

  1. Hent Client ID og Client Secret fra ProSmart. Test og Production har hver sin client secret.
  2. Åpne Stack › ProSmart › Settings.
  3. Velg Test eller Production.
  4. Fyll inn feltene i tabellen nedenfor.
  5. Trykk Connect ProSmart.

Statusen blir CONNECTED når ProSmart gir BunStack et token. Ellers blir den ERROR, med årsaken.

FeltHva du legger inn
ProSmart tenantTenant-navnet i ProSmart, for eksempel FORETAGET.
Customer number (kundnr)Kunden ordrene bookes på i miljøet. Et heltall. Se Kundenummer per land.
Customer per countryValgfritt. En egen kunde per mottakerland.
API base URLForhåndsutfylt per miljø. Endre den bare hvis ProSmart gir deg en annen adresse.
Freight article numberValgfritt. Artikkelen frakten bookes på. Tomt felt gir ingen fraktlinje.
Client ID, Client SecretFra ProSmart, ett sett per miljø. Client ID kan være den samme i begge.
  • Production bruker https://prosmartapi.se/prosmartapi/api.
  • Test bruker https://prosmartadc.se/prosmartapi/api, som er ProSmarts øvingsselskap.
  • BunStack godtar bare https-adresser på prosmartapi.se og prosmartadc.se.
  • Brukernavn og passord til ProSmarts webapp trengs ikke.
  • Knappen heter Update connection når miljøet allerede er tilkoblet. La hemmelighetsfeltene stå tomme når du endrer andre felt.

Test og Production

Hvert miljø har egen adresse, tenant, kundenummer og egne nøkler. Miljøet du lagrer, er det som brukes. Ordrer sendes dit, og lageret leses derfra.

  • Knappen heter Save and switch to Test eller Save and switch to Production når du lagrer miljøet som ikke brukes.
  • Integrasjonssiden viser TEST når Test brukes.
  • Bytt tilbake ved å velge miljøet og lagre. Nøklene blir liggende, så la feltene stå tomme.
  • Test og Production har hvert sitt kunderegister og artikkelregister. En artikkel i Production kan mangle i Test.
  • En push til Test er ikke en push til Production. Samme ordre kan sendes til begge. Sperren mot duplikater gjelder innenfor ett miljø.
  • Testpusher er merket TEST på ordren og på fanen Activity.
  • Et bytte av miljø endrer ingen ordre. Flaggene på ordrene blir liggende.

Advarsel: Test kan ikke ha samme adresse og samme tenant som Production. Da ville testordrer havne i det ekte lageret.

Advarsel: Sync stock now i Test skriver testmiljøets lager til produktene dine, i alle butikker som selger dem. Integrasjonssiden spør før synken starter.

Kustom-testordrer

En ordre som Kustom tok betalt for i playground, sendes ikke til ProSmart Production. BunStack lagrer på ordren hvilket Kustom-miljø som tok betalingen. Eldre ordrer leses fra kassesesjonen. Et bytte av Kustom til Live gjør ikke gamle testordrer til ekte. Bytt ProSmart til Test hvis du vil prøve flyten.

Innloggingskontrollen

Knappene for miljøene viser hvordan ProSmart sist svarte på innloggingen, for eksempel Login refused (HTTP 401) for Production mens Test brukes.

Check stored Production login og Check stored Test login prøver den lagrede innloggingen i det valgte miljøet. Miljøet byttes ikke, og det du har skrevet, blir liggende. Har du skrevet nye nøkler uten å lagre, kan knappen ikke trykkes. Lagre først, fordi kontrollen bruker de lagrede nøklene.

Test connection prøver miljøet som brukes, og viser ProSmarts svar.

SvarÅrsakGjør slik
401Client secret eller tenant er feil.Kontroller Client Secret og ProSmart tenant.
403Kontoen mangler tilgang til API-et.Be ProSmart åpne API-et for kontoen.
404Adressen er feil.La API base URL slutte ved API-ets rot, uten /token.
5xxProSmart er nede.Prøv igjen senere.
Intet svar innen 15 sekunderAPI-et kan ikke nås.Prøv igjen senere.

Fanen Activity

Fanen Activity viser de 20 siste lagersynkene og de 25 siste ordrepushene. Hver push viser miljøet, sendte og hoppet over linjer og utleveringen.

Koble fra

Disconnect sletter Client ID og Client Secret for begge miljøene og slår av integrasjonen. Lagersynk og ordrepush stopper. Tenant, kundenummer, adresser og ordreinnstillingene blir liggende. Koble til igjen ved å legge inn nøklene på nytt.

Kallgrenser

BunStack kjører én lagersynk per workspace om gangen. Hvert kall til ProSmart får 15 sekunder.