Integrationer & API
Integrationer: översikt
Vilka integrationer som finns, vem som får koppla dem, hur nycklar lagras, vad Disconnect gör och vilka integrationer som är planerade.
Här kopplar du BunStack till betalning, frakt, affärssystem och egna system.
Var: Stack i sidomenyn.
| Integration | Används till | Sida |
|---|---|---|
| Kustom | Kassan: betalning, capture, återbetalning | Kustom |
| Sendify | Livepriser på frakt, ombud, bokning, etiketter, spårning | Sendify |
| PostNord | Ombud, bokning och etiketter på eget PostNord-avtal | PostNord |
| ProSmart | Lagersaldo per SKU och ordrar till affärssystemet | ProSmart |
| Webhooks och API-nycklar | Egna kopplingar till dina system | Webhooks och API-nycklar |
| Produktfeeds | Google Merchant Center och Meta Catalog | Produktfeeds |
Regler för alla integrationer
| Regel | Vad gäller |
|---|---|
| Ägare | En integration tillhör workspacet. Alla butiker i workspacet delar den. |
| Roller | Koppla, ändra och koppla bort kräver admin eller owner. Test connection, lagersynk och orderpush kräver editor. |
| Nycklar | BunStack lagrar API-nycklar, lösenord och client secrets krypterade i ett valv i Stockholm. Admin visar dem aldrig igen. |
| Ändra senare | Lämna hemlighetsfälten tomma när du ändrar andra inställningar. Det lagrade värdet ligger kvar. |
| Logg | Varje ändring står i Activity log. |
Status
Stack visar BunStack i mitten och en gren för varje slags system: Payments, Shipping, Stock and ERP, Marketing och API and webhooks. Under grenens namn står hur många av dess integrationer som är anslutna, till exempel 1 of 2 connected. Linjen in till mitten visar läget:
| Linje | Betyder |
|---|---|
| Grön, med en prick som rör sig | Minst en integration på grenen är ansluten. |
| Grå | Grenen har integrationer som går att ansluta, men ingen är ansluten. |
| Grå och streckad | Allt på grenen är planerat. |
| Röd och streckad | En integration på grenen har ERROR. Raden ovanför kartan namnger den och leder till dess sida. |
Klicka på en gren för att öppna den. Panelen listar grenens integrationer, var och en med en stämpel och Configure eller Connect:
| Status | Betyder |
|---|---|
| ON | Integrationen är ansluten. |
| ERROR | Den senaste kontrollen mot leverantören misslyckades. Orsaken står på integrationens sida. |
| OFF | Integrationen är inte ansluten. |
| — | Stack kunde inte läsa statusen. |
Panelen för Payments visar också länderna dina butiker säljer till som inte kan betala, per butik, med en länk till Kustom › Markets. Det gör inte linjen röd; linjen visar bara fel i integrationerna.
Kan Stack inte läsa statusen står Could not load integration status. överst, och grenarna visar —. Tryck Try again.
Testläge
Knappen Live · Test mode off (eller Test mode on) uppe till höger på Stack öppnar Test mode. Den visar om Kustom, Sendify och ProSmart står i test eller live, och byter alla på en gång.
| Integration | Test | Live |
|---|---|---|
| Kustom | Test (playground) | Live |
| Sendify | Sandbox | Live |
| ProSmart | Test (practice company) | Production |
Varje integration sparar test- och produktionsnycklarna var för sig. Ett byte raderar inga nycklar, och du behöver aldrig klistra in dem igen.
- Tryck Turn test mode on, eller Turn test mode off för att gå live.
- Läs vad som byts och tryck Turn test mode on eller Go live.
Kortet visar sedan hur det gick för varje integration.
- En integration som saknar nycklar för miljön byts inte. Kortet säger var du lägger in dem.
- Kustom går live först när Kustom godtar live-nycklarna och go-live-kontrollerna är gröna. Se Kustom.
- Ordrar som redan är betalda återbetalas och dras i den miljö de betalades i. Bokade försändelser spåras i den miljö de bokades i.
- PostNord har ingen testmiljö och påverkas inte.
- Står vissa i test och andra live visar kortet MIXED och knapparna Put everything in test mode och Put everything live.
Disconnect
Disconnect raderar de lagrade nycklarna och stänger av integrationen. Handbokens sida för varje integration beskriver vad som slutar fungera och vad som ligger kvar.
Obs: Kustom går inte att koppla bort medan en live-butik har Kustom som kassa. Se Koppla bort.
Var fel syns
| Felet gäller | Där ser du det |
|---|---|
| Kontrollen av nycklar | Integrationens sida |
| Kassan | Kunden ser ett meddelande i kassan |
| Bokning och orderpush | Ordern och leveransdialogen |
| Lagersynk | Lagersidan och integrationens sida |
Planerade integrationer
Planerade integrationer står streckade på sin gren. I grenens panel listar kortet Planned dem: Bring, Budbee, Instabox, DHL och DB Schenker under Shipping, Klaviyo och Google / Meta Ads under Marketing. Varje rad har länken Details, som öppnar en beskrivning av vad kopplingen ska göra. Du kan inte ange nycklar, och ingen data skickas. Ordrar och kunder kan du läsa via API:t.
- Bring, Budbee, Instabox, DHL och DB Schenker går att välja som transportör på ett fraktsätt under Settings › Shipping. BunStack bokar inget hos dem. Du markerar leveransen som skickad för hand.
- Grenen API and webhooks öppnar API-nycklarna, webhooks och API-referensen.
Klarna, Swish, Stripe, Fortnox, Visma och BankID finns inte i admin. Kustom är den enda kassan.