Integraatiot ja API
ProSmart: kytkentä ja ympäristöt
Kytke ProSmart Testissä tai Productionissa: kentät, kirjautumisen tarkistus, ympäristön vaihto, Kustomin testitilaukset ja irtikytkentä.
Täällä kytket ProSmartin ja valitset Testin tai Productionin.
Missä: Stack › ProSmart › Settings.
Kytke ProSmart
- Hae ProSmartilta Client ID ja Client Secret. Testillä ja Productionilla on kummallakin oma client secret.
- Avaa Stack › ProSmart › Settings.
- Valitse Test tai Production.
- Täytä alla olevan taulukon kentät.
- Paina Connect ProSmart.
Tila on CONNECTED, kun ProSmart antaa BunStackille tokenin. Muuten tila on ERROR ja syy näkyy.
| Kenttä | Mitä syötät |
|---|---|
| ProSmart tenant | Tenantin nimi ProSmartissa, esimerkiksi FORETAGET. |
| Customer number (kundnr) | Asiakas, jolle tilaukset kirjataan ympäristössä. Kokonaisluku. Katso Asiakasnumero maittain. |
| Customer per country | Valinnainen. Oma asiakas jokaiselle vastaanottajamaalle. |
| API base URL | Valmiiksi täytetty ympäristöittäin. Muuta vain, jos ProSmart antaa sinulle toisen osoitteen. |
| Freight article number | Valinnainen. Tuote, jolle rahti kirjataan. Tyhjä kenttä ei anna rahtiriviä. |
| Client ID, Client Secret | ProSmartilta, yksi sarja ympäristöä kohti. Client ID voi olla sama molemmissa. |
- Production käyttää osoitetta
https://prosmartapi.se/prosmartapi/api. - Test käyttää osoitetta
https://prosmartadc.se/prosmartapi/api, joka on ProSmartin harjoitusyritys. - BunStack hyväksyy vain https-osoitteet verkkotunnuksissa prosmartapi.se ja prosmartadc.se.
- ProSmartin verkkosovelluksen käyttäjätunnusta ja salasanaa ei tarvita.
- Painikkeen nimi on Update connection, kun ympäristö on jo kytketty. Jätä salaisuuskentät tyhjiksi, kun muutat muita kenttiä.
Test ja Production
Jokaisella ympäristöllä on oma osoite, tenant, asiakasnumero ja omat avaimet. Tallentamasi ympäristö on käytössä. Tilaukset lähetetään sinne, ja varasto luetaan sieltä.
- Painikkeen nimi on Save and switch to Test tai Save and switch to Production, kun tallennat ympäristön, joka ei ole käytössä.
- Integraation sivu näyttää TEST, kun Test on käytössä.
- Vaihda takaisin valitsemalla ympäristö ja tallentamalla. Avaimet säilyvät, joten jätä kentät tyhjiksi.
- Testillä ja Productionilla on kummallakin oma asiakasrekisteri ja tuoterekisteri. Productionin tuote voi puuttua Testistä.
- Lähetys Testiin ei ole lähetys Productioniin. Saman tilauksen voi lähettää molempiin. Kaksoiskappaleiden esto koskee yhtä ympäristöä.
- Testilähetykset on merkitty tilauksella ja välilehdellä Activity merkinnällä TEST.
- Ympäristön vaihto ei muuta yhtään tilausta. Tilausten merkinnät säilyvät.
Varoitus: Testillä ei voi olla samaa osoitetta ja samaa tenanttia kuin Productionilla. Silloin testitilaukset päätyisivät oikeaan varastoon.
Varoitus: Sync stock now Testissä kirjoittaa testiympäristön varaston tuotteillesi kaikissa kaupoissa, jotka myyvät niitä. Integraation sivu kysyy ennen synkronoinnin alkua.
Kustomin testitilaukset
Tilausta, jonka Kustom veloitti playgroundissa, ei lähetetä ProSmart Productioniin. BunStack tallentaa tilaukselle, mikä Kustom-ympäristö otti maksun. Vanhemmat tilaukset luetaan kassaistunnosta. Kustomin vaihtaminen Liveen ei tee vanhoista testitilauksista oikeita. Vaihda ProSmart Testiin, jos haluat kokeilla kulkua.
Kirjautumisen tarkistus
Ympäristöjen painikkeet näyttävät, miten ProSmart viimeksi vastasi kirjautumiseen, esimerkiksi Login refused (HTTP 401) Productionille, kun Test on käytössä.
Check stored Production login ja Check stored Test login kokeilevat tallennettua kirjautumista valitussa ympäristössä. Ympäristö ei vaihdu, ja kirjoittamasi tiedot säilyvät. Jos olet kirjoittanut uudet avaimet tallentamatta, painiketta ei voi painaa. Tallenna ensin, koska tarkistus käyttää tallennettuja avaimia.
Test connection kokeilee käytössä olevaa ympäristöä ja näyttää ProSmartin vastauksen.
| Vastaus | Syy | Toimi näin |
|---|---|---|
| 401 | Client secret tai tenant on väärä. | Tarkista Client Secret ja ProSmart tenant. |
| 403 | Tililtä puuttuu API-käyttöoikeus. | Pyydä ProSmartia avaamaan API tilille. |
| 404 | Osoite on väärä. | Anna API base URL -osoitteen päättyä API:n juureen ilman /token-osaa. |
| 5xx | ProSmart on alhaalla. | Yritä myöhemmin uudelleen. |
| Ei vastausta 15 sekunnissa | API:a ei tavoiteta. | Yritä myöhemmin uudelleen. |
Välilehti Activity
Välilehti Activity listaa 20 viimeisintä varastosynkronointia ja 25 viimeisintä tilausten lähetystä. Jokainen lähetys näyttää ympäristön, lähetetyt ja ohitetut rivit sekä toimituksen.
Kytke irti
Disconnect poistaa molempien ympäristöjen Client ID:n ja Client Secretin ja kytkee integraation pois päältä. Varastosynkronointi ja tilausten lähetys pysähtyvät. Tenant, asiakasnumero, osoitteet ja tilausasetukset säilyvät. Kytke uudelleen syöttämällä avaimet uudestaan.
Kutsurajat
BunStack ajaa yhden varastosynkronoinnin kerrallaan workspacea kohti. Jokainen kutsu ProSmartiin saa 15 sekuntia.