Integrationer & API
ProSmart: koppla och miljöer
Koppla ProSmart i Test eller Production: fälten, inloggningskontrollen, byte av miljö, Kustom-testordrar och bortkoppling.
Här kopplar du ProSmart och väljer Test eller Production.
Var: Stack › ProSmart › Settings.
Koppla ProSmart
- Hämta Client ID och Client Secret från ProSmart. Test och Production har var sin client secret.
- Öppna Stack › ProSmart › Settings.
- Välj Test eller Production.
- Fyll i fälten i tabellen nedan.
- Tryck Connect ProSmart.
Statusen blir CONNECTED när ProSmart ger BunStack en token. Annars blir den ERROR, med orsaken.
| Fält | Vad du anger |
|---|---|
| ProSmart tenant | Tenant-namnet i ProSmart, till exempel FORETAGET. |
| Customer number (kundnr) | Kunden som ordrarna bokas på i miljön. Ett heltal. Se Kundnummer per land. |
| Customer per country | Valfritt. En egen kund per mottagarland. |
| API base URL | Förifylld per miljö. Ändra den bara om ProSmart ger dig en annan adress. |
| Freight article number | Valfritt. Artikeln som frakten bokas på. Tomt fält ger ingen fraktrad. |
| Client ID, Client Secret | Från ProSmart, en uppsättning per miljö. Client ID kan vara samma i båda. |
- Production använder
https://prosmartapi.se/prosmartapi/api. - Test använder
https://prosmartadc.se/prosmartapi/api, som är ProSmarts övningsbolag. - BunStack godtar bara https-adresser på prosmartapi.se och prosmartadc.se.
- Användarnamn och lösenord till ProSmarts webbapp behövs inte.
- Knappen heter Update connection när miljön redan är kopplad. Lämna hemlighetsfälten tomma när du ändrar andra fält.
Test och Production
Varje miljö har egen adress, tenant, kundnummer och egna nycklar. Miljön du sparar är den som används. BunStack skickar ordrar dit och läser lagret därifrån.
- Knappen heter Save and switch to Test eller Save and switch to Production när du sparar miljön som inte används.
- Integrationssidan visar TEST när Test används.
- Byt tillbaka genom att välja miljön och spara. Nycklarna ligger kvar, så lämna fälten tomma.
- Test och Production har var sitt kundregister och artikelregister. En artikel i Production kan saknas i Test.
- En push till Test är inte en push till Production. Samma order kan skickas till båda. Spärren mot dubbletter gäller inom en miljö.
- Testpushar är märkta TEST på ordern och under fliken Activity.
- Ett byte av miljö ändrar ingen order. Flaggorna på ordrarna ligger kvar.
Varning: Test kan inte ha samma adress och samma tenant som Production. Då skulle testordrar hamna i det riktiga lagret.
Varning: Sync stock now i Test skriver testmiljöns lager till dina produkter, i alla butiker som säljer dem. Integrationssidan frågar innan synken startar.
Kustom-testordrar
En order som Kustom tog betalt för i playground skickas inte till ProSmart Production. BunStack sparar på ordern vilken Kustom-miljö som tog betalningen. För äldre ordrar läser BunStack miljön från kassasessionen. Ett byte av Kustom till Live gör inte gamla testordrar till riktiga. Byt ProSmart till Test om du vill prova flödet.
Inloggningskontrollen
Knapparna för miljöerna visar hur ProSmart senast svarade på inloggningen, till exempel Login refused (HTTP 401) för Production medan Test används.
Check stored Production login och Check stored Test login provar den sparade inloggningen i den valda miljön. Miljön byts inte, och det du har skrivit ligger kvar. Har du skrivit nya nycklar utan att spara går knappen inte att trycka på. Spara först, eftersom kontrollen använder de sparade nycklarna.
Test connection provar miljön som används och visar ProSmarts svar.
| Svar | Orsak | Gör så här |
|---|---|---|
| 401 | Client secret eller tenant är fel. | Kontrollera Client Secret och ProSmart tenant. |
| 403 | Kontot saknar åtkomst till API:t. | Be ProSmart öppna API:t för kontot. |
| 404 | Adressen är fel. | Låt API base URL sluta vid API:ts rot, utan /token. |
| 5xx | ProSmart är nere. | Försök igen senare. |
| Inget svar inom 15 sekunder | API:t går inte att nå. | Försök igen senare. |
Fliken Activity
Fliken Activity listar de 20 senaste lagersynkerna och de 25 senaste orderpusharna. Varje push visar miljön, skickade och överhoppade rader och utleveransen.
Koppla bort
Disconnect raderar Client ID och Client Secret för båda miljöerna och stänger av integrationen. Lagersynk och orderpush slutar fungera. Tenant, kundnummer, adresser och orderinställningarna ligger kvar. Koppla igen genom att ange nycklarna på nytt.
Anropsgränser
BunStack kör en lagersynk per workspace åt gången. Varje anrop till ProSmart får 15 sekunder.