Integraatiot ja API
Integraatiot: yleiskatsaus
Mitä integraatioita on, kuka saa kytkeä ne, miten avaimet tallennetaan, mitä Disconnect tekee ja mitkä integraatiot ovat suunnitteilla.
Täällä kytket BunStackiin maksun, rahdin, toiminnanohjausjärjestelmän ja omat järjestelmäsi.
Missä: Stack sivuvalikossa.
| Integraatio | Käyttö | Sivu |
|---|---|---|
| Kustom | Kassa: maksu, veloitus, hyvitys | Kustom |
| Sendify | Rahdin livehinnat, noutopisteet, varaus, osoitekortit, seuranta | Sendify |
| PostNord | Noutopisteet, varaus ja osoitekortit omalla PostNord-sopimuksella | PostNord |
| ProSmart | Varastosaldo SKU:ittain ja tilaukset toiminnanohjausjärjestelmään | ProSmart |
| Webhookit ja API-avaimet | Omat yhteydet järjestelmiisi | Webhookit ja API-avaimet |
| Tuotesyötteet | Google Merchant Center ja Meta Catalog | Tuotesyötteet |
Säännöt kaikille integraatioille
| Sääntö | Mikä pätee |
|---|---|
| Omistaja | Integraatio kuuluu workspaceen. Kaikki workspacen kaupat jakavat sen. |
| Roolit | Kytkeminen, muuttaminen ja irtikytkentä vaativat roolin admin tai owner. Test connection, varastosynkronointi ja tilausten lähetys vaativat roolin editor. |
| Avaimet | BunStack tallentaa API-avaimet, salasanat ja client secretit salattuina holviin Tukholmassa. Admin ei näytä niitä enää koskaan. |
| Muutokset myöhemmin | Jätä salaisuuskentät tyhjiksi, kun muutat muita asetuksia. Tallennettu arvo säilyy. |
| Loki | Jokainen muutos näkyy kohdassa Activity log. |
Tila
Stack näyttää BunStackin keskellä ja haaran jokaiselle järjestelmätyypille: Payments, Shipping, Stock and ERP, Marketing ja API and webhooks. Haaran nimen alla lukee, montako sen integraatioista on kytketty, esimerkiksi 1 of 2 connected. Viiva keskelle näyttää haaran tilan:
| Viiva | Tarkoittaa |
|---|---|
| Vihreä, ja sitä pitkin liikkuu piste | Vähintään yksi haaran integraatio on kytketty. |
| Harmaa | Haarassa on integraatioita, jotka voi kytkeä, mutta mikään ei ole kytketty. |
| Harmaa katkoviiva | Kaikki haaran integraatiot ovat suunniteltuja. |
| Punainen katkoviiva | Jollakin haaran integraatiolla on ERROR. Haarojen yläpuolella oleva rivi nimeää sen ja linkittää sen sivulle. |
Avaa haara napsauttamalla sitä. Paneeli listaa haaran integraatiot, jokaisella leima ja Configure tai Connect:
| Tila | Tarkoittaa |
|---|---|
| ON | Integraatio on kytketty. |
| ERROR | Viimeisin tarkistus toimittajaa vasten epäonnistui. Syy näkyy integraation sivulla. |
| OFF | Integraatiota ei ole kytketty. |
| — | Sivu Stack ei voinut lukea tilaa. |
Payments-paneeli näyttää myös maat, joihin kauppasi myyvät mutta joista ei voi maksaa, kaupoittain, ja linkin kohtaan Kustom › Markets. Se ei muuta viivaa punaiseksi; viiva näyttää vain integraatioiden virheet.
Jos sivu Stack ei voi lukea tilaa, ylhäällä näkyy Could not load integration status. ja haaroissa näkyy —. Paina Try again.
Testitila
Painike Live · Test mode off (tai Test mode on) sivun Stack oikeassa yläkulmassa avaa kohdan Test mode. Se näyttää, ovatko Kustom, Sendify ja ProSmart testissä vai livenä, ja vaihtaa ne kaikki kerralla.
| Integraatio | Test | Live |
|---|---|---|
| Kustom | Test (playground) | Live |
| Sendify | Sandbox | Live |
| ProSmart | Test (practice company) | Production |
Jokainen integraatio tallentaa testi- ja tuotantoavaimet erikseen. Vaihto ei poista avaimia, eikä sinun tarvitse koskaan liittää niitä uudelleen.
- Paina Turn test mode on, tai Turn test mode off, kun siirryt liveen.
- Lue, mitä vaihdetaan, ja paina Turn test mode on tai Go live.
Kortti näyttää sen jälkeen, miten vaihto onnistui kunkin integraation kohdalla.
- Integraatiota, jolta puuttuvat avaimet ympäristöön, ei vaihdeta. Kortti kertoo, mihin ne lisätään.
- Kustom siirtyy liveen vasta, kun Kustom hyväksyy live-avaimet ja go-live-tarkistukset ovat vihreitä. Katso Kustom.
- Jo maksetut tilaukset hyvitetään ja veloitetaan siinä ympäristössä, jossa ne maksettiin. Varattuja lähetyksiä seurataan siinä ympäristössä, jossa ne varattiin.
- PostNordilla ei ole testiympäristöä, eikä vaihto koske sitä.
- Jos osa on testissä ja osa livenä, kortti näyttää MIXED ja painikkeet Put everything in test mode ja Put everything live.
Disconnect
Disconnect poistaa tallennetut avaimet ja kytkee integraation pois päältä. Mikä pysähtyy ja mikä säilyy, kerrotaan kunkin integraation sivulla.
Huom: Kustomia ei voi kytkeä irti, kun jokin live-kauppa käyttää Kustomia kassana. Katso Kytke irti.
Missä virheet näkyvät
| Virhe koskee | Missä näet sen |
|---|---|
| Avainten tarkistusta | Integraation sivulla |
| Kassaa | Asiakas näkee viestin kassalla |
| Varausta ja tilausten lähetystä | Tilauksella ja toimitusikkunassa |
| Varastosynkronointia | Varastosivulla ja integraation sivulla |
Suunnitellut integraatiot
Suunnitellut integraatiot näkyvät haarassaan katkoviivalla. Haaran paneelissa kortti Planned listaa ne: Bring, Budbee, Instabox, DHL ja DB Schenker kohdassa Shipping, Klaviyo ja Google / Meta Ads kohdassa Marketing. Jokaisella rivillä on linkki Details, ja sen sivu kuvaa, mitä yhteys tulee tekemään. Et voi syöttää avaimia, eikä dataa lähetetä. Tilauksia ja asiakkaita voit lukea API:n kautta.
- Bring, Budbee, Instabox, DHL ja DB Schenker voi valita toimitustavan kuljetusliikkeeksi kohdassa Settings › Shipping. BunStack ei varaa niiltä mitään. Merkitset toimituksen lähetetyksi käsin.
- Haara API and webhooks avaa API-avaimet, webhookit ja API-viitteen.
Klarna, Swish, Stripe, Fortnox, Visma ja BankID eivät ole adminissa. Kustom on ainoa kassa.