Integrationer og API
Integrationer: oversigt
Hvilke integrationer der findes, hvem der må tilslutte dem, hvordan nøgler gemmes, hvad Disconnect gør, og hvilke integrationer der er planlagt.
Her tilslutter du BunStack til betaling, fragt, forretningssystem og egne systemer.
Hvor: Stack i sidemenuen.
| Integration | Bruges til | Side |
|---|---|---|
| Kustom | Kassen: betaling, capture, refusion | Kustom |
| Sendify | Livepriser på fragt, pakkeshops, booking, labels, sporing | Sendify |
| PostNord | Pakkeshops, booking og labels på egen PostNord-aftale | PostNord |
| ProSmart | Lagerbeholdning pr. SKU og ordrer til forretningssystemet | ProSmart |
| Webhooks og API-nøgler | Egne forbindelser til dine systemer | Webhooks og API-nøgler |
| Produktfeeds | Google Merchant Center og Meta Catalog | Produktfeeds |
Regler for alle integrationer
| Regel | Hvad der gælder |
|---|---|
| Ejer | En integration hører til workspacet. Alle butikker i workspacet deler den. |
| Roller | Tilslutte, ændre og afbryde kræver admin eller owner. Test connection, lagersynk og ordrepush kræver editor. |
| Nøgler | BunStack gemmer API-nøgler, adgangskoder og client secrets krypteret i en boks i Stockholm. Admin viser dem aldrig igen. |
| Ændre senere | Lad hemmelighedsfelterne stå tomme, når du ændrer andre indstillinger. Den gemte værdi bliver liggende. |
| Log | Hver ændring står i Activity log. |
Status
Stack viser BunStack i midten og en gren for hver slags system: Payments, Shipping, Stock and ERP, Marketing og API and webhooks. Under grenens navn står, hvor mange af dens integrationer der er tilsluttet, for eksempel 1 of 2 connected. Linjen ind til midten viser, hvordan grenen står:
| Linje | Betyder |
|---|---|
| Grøn, med en prik der bevæger sig | Mindst én integration på grenen er tilsluttet. |
| Grå | Grenen har integrationer, der kan tilsluttes, men ingen er tilsluttet. |
| Grå og stiplet | Alt på grenen er planlagt. |
| Rød og stiplet | En integration på grenen har ERROR. Rækken over grenene nævner den og linker til dens side. |
Klik på en gren for at åbne den. Panelet viser grenens integrationer, hver med et stempel og Configure eller Connect:
| Status | Betyder |
|---|---|
| ON | Integrationen er tilsluttet. |
| ERROR | Den seneste kontrol mod leverandøren mislykkedes. Årsagen står på integrationens side. |
| OFF | Integrationen er ikke tilsluttet. |
| — | Stack kunne ikke læse status. |
Panelet for Payments viser også de lande, dine butikker sælger til, som ikke kan betale, pr. butik, med et link til Kustom › Markets. Det gør ikke linjen rød; linjen viser kun fejl i integrationerne.
Kan Stack ikke læse status, står Could not load integration status. øverst, og grenene viser —. Tryk Try again.
Testtilstand
Knappen Live · Test mode off (eller Test mode on) øverst til højre på Stack åbner Test mode. Den viser, om Kustom, Sendify og ProSmart står i test eller live, og skifter dem alle på én gang.
| Integration | Test | Live |
|---|---|---|
| Kustom | Test (playground) | Live |
| Sendify | Sandbox | Live |
| ProSmart | Test (practice company) | Production |
Hver integration gemmer test- og produktionsnøglerne hver for sig. Et skift sletter ingen nøgler, og du skal aldrig indsætte dem igen.
- Tryk Turn test mode on, eller Turn test mode off for at gå live.
- Læs, hvad der skiftes, og tryk Turn test mode on eller Go live.
Kortet viser derefter, hvordan det gik for hver integration.
- En integration, der mangler nøgler til miljøet, skiftes ikke. Kortet siger, hvor du lægger dem ind.
- Kustom går først live, når Kustom godkender live-nøglerne, og go-live-kontrollerne er grønne. Se Kustom.
- Ordrer, der allerede er betalt, refunderes og trækkes i det miljø, de blev betalt i. Bookede forsendelser spores i det miljø, de blev booket i.
- PostNord har intet testmiljø og påvirkes ikke.
- Står nogle i test og andre live, viser kortet MIXED og knapperne Put everything in test mode og Put everything live.
Disconnect
Disconnect sletter de gemte nøgler og slår integrationen fra. Hvad der stopper, og hvad der bliver liggende, står på hver integrations side.
Bemærk: Kustom kan ikke afbrydes, mens en live-butik bruger Kustom som kasse. Se Afbryd.
Hvor fejl vises
| Fejlen gælder | Der ser du den |
|---|---|
| Kontrollen af nøgler | Integrationens side |
| Kassen | Kunden ser en besked i kassen |
| Booking og ordrepush | Ordren og leveringsdialogen |
| Lagersynk | Lagersiden og integrationens side |
Planlagte integrationer
Planlagte integrationer er stiplede på deres gren. I grenens panel viser kortet Planned dem: Bring, Budbee, Instabox, DHL og DB Schenker under Shipping, Klaviyo og Google / Meta Ads under Marketing. Hver række har linket Details, og siden der beskriver, hvad forbindelsen skal gøre. Du kan ikke indtaste nøgler, og ingen data sendes. Ordrer og kunder kan du læse via API'et.
- Bring, Budbee, Instabox, DHL og DB Schenker kan vælges som transportør på en fragtmetode under Settings › Shipping. BunStack booker intet hos dem. Du markerer leveringen som sendt manuelt.
- Grenen API and webhooks åbner API-nøglerne, webhooks og API-referencen.
Klarna, Swish, Stripe, Fortnox, Visma og BankID findes ikke i admin. Kustom er den eneste kasse.