Integrationer og API
ProSmart: tilslutning og miljøer
Tilslut ProSmart i Test eller Production: felterne, login-kontrollen, skift af miljø, Kustom-testordrer og afbrydelse.
Her tilslutter du ProSmart og vælger Test eller Production.
Hvor: Stack › ProSmart › Settings.
Tilslut ProSmart
- Hent Client ID og Client Secret fra ProSmart. Test og Production har hver sin client secret.
- Åbn Stack › ProSmart › Settings.
- Vælg Test eller Production.
- Udfyld felterne i tabellen nedenfor.
- Tryk Connect ProSmart.
Status bliver CONNECTED, når ProSmart giver BunStack et token. Ellers bliver den ERROR, med årsagen.
| Felt | Hvad du indtaster |
|---|---|
| ProSmart tenant | Tenant-navnet i ProSmart, for eksempel FORETAGET. |
| Customer number (kundnr) | Kunden, ordrerne bookes på i miljøet. Et heltal. Se Kundenummer pr. land. |
| Customer per country | Valgfrit. En egen kunde pr. modtagerland. |
| API base URL | Udfyldt på forhånd pr. miljø. Ændr den kun, hvis ProSmart giver dig en anden adresse. |
| Freight article number | Valgfrit. Varen, fragten bookes på. Et tomt felt giver ingen fragtlinje. |
| Client ID, Client Secret | Fra ProSmart, ét sæt pr. miljø. Client ID kan være den samme i begge. |
- Production bruger
https://prosmartapi.se/prosmartapi/api. - Test bruger
https://prosmartadc.se/prosmartapi/api, som er ProSmarts øvelsesvirksomhed. - BunStack godkender kun https-adresser på prosmartapi.se og prosmartadc.se.
- Brugernavn og adgangskode til ProSmarts webapp skal ikke bruges.
- Knappen hedder Update connection, når miljøet allerede er tilsluttet. Lad hemmelighedsfelterne stå tomme, når du ændrer andre felter.
Test og Production
Hvert miljø har egen adresse, tenant, kundenummer og egne nøgler. Det miljø, du gemmer, er det, der bruges. Ordrer sendes dertil, og lageret læses derfra.
- Knappen hedder Save and switch to Test eller Save and switch to Production, når du gemmer det miljø, der ikke bruges.
- Integrationssiden viser TEST, når Test bruges.
- Skift tilbage ved at vælge miljøet og gemme. Nøglerne bliver liggende, så lad felterne stå tomme.
- Test og Production har hvert sit kunderegister og vareregister. En vare i Production kan mangle i Test.
- En push til Test er ikke en push til Production. Samme ordre kan sendes til begge. Spærren mod dubletter gælder inden for ét miljø.
- Testpushes er markeret TEST på ordren og på fanen Activity.
- Et skift af miljø ændrer ingen ordre. Markeringerne på ordrerne bliver liggende.
Advarsel: Test kan ikke have samme adresse og samme tenant som Production. I så fald ville testordrer havne i det rigtige lager.
Advarsel: Sync stock now i Test skriver testmiljøets lager til dine produkter, i alle butikker, der sælger dem. Integrationssiden spørger, før synkroniseringen starter.
Kustom-testordrer
En ordre, som Kustom tog betaling for i playground, sendes ikke til ProSmart Production. BunStack gemmer på ordren, hvilket Kustom-miljø der tog betalingen. Ældre ordrer læses fra kassesessionen. Et skift af Kustom til Live gør ikke gamle testordrer til rigtige. Skift ProSmart til Test, hvis du vil prøve flowet.
Login-kontrollen
Knapperne for miljøerne viser, hvordan ProSmart sidst svarede på login, for eksempel Login refused (HTTP 401) for Production, mens Test bruges.
Check stored Production login og Check stored Test login prøver det gemte login i det valgte miljø. Miljøet skiftes ikke, og det, du har skrevet, bliver liggende. Har du skrevet nye nøgler uden at gemme, kan knappen ikke trykkes. Gem først, fordi kontrollen bruger de gemte nøgler.
Test connection prøver det miljø, der bruges, og viser ProSmarts svar.
| Svar | Årsag | Gør sådan |
|---|---|---|
| 401 | Client secret eller tenant er forkert. | Kontrollér Client Secret og ProSmart tenant. |
| 403 | Kontoen mangler adgang til API'et. | Bed ProSmart åbne API'et for kontoen. |
| 404 | Adressen er forkert. | Lad API base URL slutte ved API'ets rod, uden /token. |
| 5xx | ProSmart er nede. | Prøv igen senere. |
| Intet svar inden for 15 sekunder | API'et kan ikke nås. | Prøv igen senere. |
Fanen Activity
Fanen Activity viser de 20 seneste lagersynkroniseringer og de 25 seneste ordrepushes. Hver push viser miljøet, sendte og oversprungne linjer og udleveringen.
Afbryd
Disconnect sletter Client ID og Client Secret for begge miljøer og slår integrationen fra. Lagersynk og ordrepush stopper. Tenant, kundenummer, adresser og ordreindstillingerne bliver liggende. Tilslut igen ved at indtaste nøglerne på ny.
Kaldegrænser
BunStack kører én lagersynk pr. workspace ad gangen. Hvert kald til ProSmart får 15 sekunder.