Integrasjoner og API
ProSmart: tilkobling og miljøer
Koble til ProSmart i Test eller Production: feltene, innloggingskontrollen, bytte av miljø, Kustom-testordrer og frakobling.
Her kobler du til ProSmart og velger Test eller Production.
Hvor: Stack › ProSmart › Settings.
Koble til ProSmart
- Hent Client ID og Client Secret fra ProSmart. Test og Production har hver sin client secret.
- Åpne Stack › ProSmart › Settings.
- Velg Test eller Production.
- Fyll inn feltene i tabellen nedenfor.
- Trykk Connect ProSmart.
Statusen blir CONNECTED når ProSmart gir BunStack et token. Ellers blir den ERROR, med årsaken.
| Felt | Hva du legger inn |
|---|---|
| ProSmart tenant | Tenant-navnet i ProSmart, for eksempel FORETAGET. |
| Customer number (kundnr) | Kunden ordrene bookes på i miljøet. Et heltall. Se Kundenummer per land. |
| Customer per country | Valgfritt. En egen kunde per mottakerland. |
| API base URL | Forhåndsutfylt per miljø. Endre den bare hvis ProSmart gir deg en annen adresse. |
| Freight article number | Valgfritt. Artikkelen frakten bookes på. Tomt felt gir ingen fraktlinje. |
| Client ID, Client Secret | Fra 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 | Årsak | Gjør slik |
|---|---|---|
| 401 | Client secret eller tenant er feil. | Kontroller Client Secret og ProSmart tenant. |
| 403 | Kontoen mangler tilgang til API-et. | Be ProSmart åpne API-et for kontoen. |
| 404 | Adressen er feil. | La API base URL slutte ved API-ets rot, uten /token. |
| 5xx | ProSmart er nede. | Prøv igjen senere. |
| Intet svar innen 15 sekunder | API-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.