Om tjenesten
API-et støtter innsending av underlagsdokumenter via API.
For å kunne bruke tjenesten må scope for autentisering mot Maskinporten settes til toll:goodsdeclaration/document.write
Grensesnittbeskrivelse
Tjenesten gjøres tilgjengelig som en REST-tjeneste over HTTPS, med data på JSON-format.
HTTP Request
Metode: POST
URL: https://api.toll.no/api/goodsdeclaration/document/v2/declaration-id/{DeklarasjonsID}/document
Headers
- Authorization: Bearer Token
Token som kreves er en Maskinporten JWT med scopet toll:goodsdeclaration/document.write
Body
- Media Type: Form Data
- Innhold:
- metadata: {"declarationId": "Sett inn deklarasjons-id her", "documentType": "Sett inn dokumenttype her"}
- file: Ditt dokument
- Dokumenttype må være en av
- faktura
- tillatelser
- fraktregning
- opprinnelsesdokumentasjon
- fraktbrev
-
Filtype må være en av
- jpg
- png
- txt
- doc
- docx
- xls
- xlsx
- Maks 10MB i filstørrelse per vedlegg. Dersom vedlegget er større, må du dele denne opp i flere deler som hver er mindre enn 10MB.
- NB! Rekkefølgen på feltene i innholdet må være samme som oppgitt over
Eksempel i Postman
Body
Auth
Autentisering – Datautveksling mellom næringslivet og Tolletaten
Våre API-er benytter Maskinporten for identitets- og tilgangsstyring. På siden Maskinporten - Tolletaten finner du informasjon bl.a. om
- hvordan du kommer i gang med integrasjon via Maskinporten om du ikke har gjort det før, inkludert registreringsskjema for tilgang hos Tolletaten
- tilgangsstyring for våre API-er
- hvordan sette opp en klient for å autentisere via Maskinporten
- drift og overvåking/feilsøking.