Den här guiden är en översikt för er som ska koppla ihop ert system med DokumentAdress. Läs den först — de övriga guiderna går på djupet i varje del.
Vad plattformen gör
- Tar emot dokument — via e-post till en adress vi ger er, via uppladdning i vårt gränssnitt, eller via API från ert system.
- Tolkar innehållet — leverantör, belopp, moms, förfallodatum, radartiklar, OCR-referens. Osäkra fält märks för manuell granskning.
- Lämnar vidare — till ert ekonomisystem, som e-fakturafil, som bokföringsfil, eller via webhook till er egen mottagare.
- Samlar in tid, resor och utlägg från personal — antingen i vår färdiga widget eller i ert eget gränssnitt mot samma API.
Grundbegrepp
| Begrepp | Betydelse |
|---|---|
| Organisation | Ert företag hos oss. All data är låst till er organisation. |
Enhet (tenant_ref) | En butik, ett kontor eller en arbetsplats inom organisationen. |
| API-nyckel | ds_live_<prefix>.<hemlighet>. Bor på er server, aldrig i webbläsaren. |
| Scope | Vad nyckeln får göra: documents:read, documents:write, attachments:read, webhooks:manage. |
| Personlig kod | dwt_…. Kortlivad kod för en enskild anställd, används i personalens vy. |
Bas-URL och autentisering
https://<er-instans>/api/public/v1
Authorization: Bearer ds_live_…
Content-Type: application/json
Allt är JSON. Enda undantaget är själva filuppladdningen, som är en PUT
med råa bytes mot en signerad länk vi ger er.
Två sätt att bygga
Färdig widget — ni bäddar in vår vy i en <iframe>. Snabbast igång, ni
behöver bara skapa en personlig kod per anställd.
Eget gränssnitt — ni bygger er egen vy mot samma API. Vår widget har inga privilegier er egen vy saknar; den är bara en färdig klient.
Ni kan blanda: färdig widget i ett skede, eget gränssnitt senare, utan att data eller uppsättning ändras.
Innan ni börjar
- Be oss om en API-nyckel med de scopes ni behöver.
- Bestäm era
tenant_ref— en per enhet, t.ex.nordbutik-linkoping. - Säg till vilken domän ni kör på, om ni ska bädda in någon av våra vyer.
- Peka ut en webhookmottagare om ni vill bli aviserade i stället för att fråga oss.
Felkoder som gäller överallt
| Status | Betydelse |
|---|---|
| 400 | Felaktigt anrop — rätta och skicka om |
| 401 | Fel eller utgången nyckel/kod |
| 402 | Funktionen ingår inte i abonnemanget, eller månadstaket är nått |
| 403 | Nyckeln saknar rätt scope |
| 404 | Okänt id |
| 409 | Otillåten övergång, t.ex. låst löneperiod |
| 413 | För stor kropp |
| 422 | Data godkändes inte vid validering |
| 429 | För många anrop — backa av och försök igen |
Läs alltid error.code, aldrig felmeddelandets text. Texten kan ändras,
koden gör det inte.