Hoppa till innehållet
hobok

För utvecklare

Låt ditt eget system fakturera

Har du redan en webbshop, ett bokningssystem eller ett eget verktyg? Med hobok:s API skapar det fakturor, markerar dem betalda och hämtar kvittot — utan att någon loggar in här och fyller i ett formulär. Inkomsten hamnar i bokföringen och räknas med i årsrapporten, precis som allt annat.

Läs referensen Hämta OpenAPI-specen

Ingår i Plus. Dokumentationen är på engelska — den skrivs för den som bygger integrationen.

Skapa fakturor

Ett anrop ger en faktura med nästa nummer i din egen serie, en färdig PDF och — om du vill — ett mejl till kunden.

Markera betalda

Betalningen bokförs som en inkomst med valt betalningssätt, och kvittot skapas i samma anrop.

Hämta kvitton

Kvittot som PDF, eller mejlat till köparen. Samma dokument som appen skapar — svenskt, som sig bör.

Så ser det ut

En faktura, ett anrop

Nyckeln avgör vilken verksamhet fakturan hamnar i, så inget anrop behöver ange det.

Skapa fakturan

curl -X POST https://api.hobok.se/v1/invoices \
  -H "Authorization: Bearer hbk_…" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{
    "buyer": { "name": "Köparen AB", "email": "faktura@exempel.se" },
    "lines": [
      { "description": "Konsultation", "quantity": 2,
        "unit": "h", "unit_price": 1250 }
    ]
  }'

Markera den betald

curl -X POST https://api.hobok.se/v1/invoices/12/mark-paid \
  -H "Authorization: Bearer hbk_…" \
  -H "Idempotency-Key: pay-1001" \
  -H "Content-Type: application/json" \
  -d '{ "payment_method": "Swish" }'

Svaret innehåller hela fakturan och den inkomsttransaktion som just bokfördes — du behöver inte gissa vad som hamnade i böckerna.

Innan du bygger

Fyra saker som är värda att veta

Skicka alltid en Idempotency-Key

Ett anrop som tar slut på tid och skickas om skapar annars en andra faktura, eller bokför inkomsten två gånger. Med en nyckel spelas det första svaret upp i stället, och ingenting körs om.

Moms är alltid noll

En hobbyverksamhet är inte momsregistrerad och får inte ta ut moms. Ett vat_rate skilt från 0 avvisas — det nollas inte i tysthet, så ingen kan tro sig ha debiterat moms som aldrig debiterades.

Server till server, aldrig i en webbläsare

Nyckeln är ett lösenord. Den ska ligga på din server — inte i en app, inte i en webbsida, inte i ett publikt kodarkiv. Därför finns det inga CORS-headers: det finns ingenting att tillåta.

Id:n är dina egna

Varje id räknas inom din verksamhet och börjar på 1 — samma nummer som appens egna adresser använder.

Kom igång

Tre steg

  1. 1

    Skaffa Plus. API:et ingår i Plus och kontrolleras vid varje anrop.

  2. 2

    Skapa en nyckel. Under verksamhetens inställningar i appen. Nyckeln visas en enda gång — vi sparar bara ett avtryck av den.

  3. 3

    Testa med GET /me. Ett anrop som bekräftar att nyckeln fungerar och visar vilken verksamhet den hör till.

Hela referensen — 16 anrop

Kom igång med årets bokföring

Standard är gratis utan tidsgräns och innehåller hela bokföringen, hela årsrapporten och den ifyllda T2-blanketten. Inget kort behövs.

Skapa konto gratis Se priser