Partner-API
Bygg in installationen i din kassa
Sälj produkt och installation i ett och samma köp. Partner-API:t skapar installationsordrar från din kassa, skickar varje händelse i livscykeln tillbaka till dina system och ger rätt installationspris redan vid köpet. Kunden klickar på köp, och Done samordnar resten.
Det här täcker API:t
Ett fokuserat API för installationens livscykel efter köpet.
Idempotent orderskapande
Skapa ordrar med dina egna referens-id:n. Anrop kan skickas om utan risk: samma referens skapar aldrig en dubblettinstallation.
Hämta, uppdatera, avboka
Läs orderns fullständiga status när som helst, uppdatera uppgifter när kunden ändrar sig och avboka ordern när köpet återbetalas.
Webhooks för hela livscykeln
Prenumerera på händelser från matchad till fakturerad, med full orderinformation i varje anrop, så att du aldrig behöver polla efter status.
Artikel- och pris-API
Hämta installationsartiklar och priser och visa korrekta kostnader i kassan, inklusive moms och avdrag.
En token per partner
Varje integration autentiserar med en egen token. Din token ser dina ordrar och inget annat.
Statussynk åt båda håll
Dina system är alltid uppdaterade om installationen, och Done tar in ändringar du gör på din sida.
Webhooks
Sex händelser täcker hela livscykeln
Varje webhook innehåller hela ordern, så att dina system kan agera utan att fråga efter mer. Inga pollningsloopar, inga synkjobb.
| Händelse | Skickas när |
|---|---|
| order.matched En installatör har tackat ja till uppdraget | En installatör har tackat ja till uppdraget |
| order.scheduled Installationsdatum är bokat med kunden | Installationsdatum är bokat med kunden |
| order.report_submitted Installatören har skickat in installationsrapporten | Installatören har skickat in installationsrapporten |
| order.completed Installationen är klar och godkänd | Installationen är klar och godkänd |
| order.invoiced Kundfakturan har skickats | Kundfakturan har skickats |
| order.cancelled Ordern har avbokats, med orsak | Ordern har avbokats, med orsak |
Exempel på anrop (förenklat, inte hela schemat):
POST https://api.example.com/done-webhooks
{
"event": "order.completed",
"occurredAt": "2026-05-28T14:32:00Z",
"order": {
"id": "ord_7k2f9d",
"externalReference": "your-order-18243",
"status": "completed",
"installedAt": "2026-05-28",
"report": {
"submitted": true,
"documents": ["installation-report.pdf"]
}
}
}Tre vanliga sätt att integrera
Börja med ett av dem och bygg vidare.
Tillval i kassan
Erbjud installation som en rad i kassan, prissatt via artikel-API:t. Ordern skapas i Done så snart betalningen har gått igenom.
Installation efter köpet
Sälj först och lägg till installationen sedan: skapa ordern från ditt CRM eller ordersystem när affären är klar och följ den via webhooks.
Inbäddad statussida
Visa hur installationen går i din egen app eller på Mina sidor med orderdata från API:t, medan Done sköter samordningen i bakgrunden.
Pris redan vid köpet
Visa det riktiga installationspriset före kassan
”Pris på förfrågan” får färre kunder att köpa till installation. Pris-API:t returnerar det faktiska installationspriset för det kunden köper, så att du kan visa en totalsumma i kassan och stå för den.
- Momsen beräknas rätt i varje enskilt fall
- I Sverige räknas grön teknik-avdraget in
- Artikelkatalogen sköts per partner i Backoffice
- Ändra priser utan att röra integrationen
Vanliga frågor
Få tillgång till API-dokumentationen
Kontakta sälj, så får ditt team dokumentationen för Partner-API:t och en plan för integrationen.
Kontakta sälj