Skip to content
English
Ask our support
Contact us
  • There are no suggestions because the search field is empty.

Customs Clearance NO - "Dokumentkontroll" via API

Send Documents to Norwegian Customs (Tolletaten) via API

This guide explains how EmmaSped sends supporting documents to Norwegian Customs (Tolletaten) using our API. It covers prerequisites, how documents are uploaded, when they are transmitted automatically, how to send them on demand, and how to verify delivery.

1) Prerequisites

  1. Maskinporten integration

    • You must be connected to Maskinporten with a valid client certificate.

    • Your organization needs an Integration ID (IntegrasjonsID) registered with Digdir (Digitaliseringsdirektoratet).

    • This setup is the same as for Digitoll. If Digitoll is already working from your environment, you typically meet these requirements.

     

2) Where to add documents in EmmaSped

Documents are attached to the declaration in Scan inside the customs clearance view:

  • Paste/attached Doc: Paste directly from clipboard into Scan.

    Snag_c46b62

  • Email/Outlook integration: Forward/drag emails or attachments from Outlook; they appear under Scan for the selected declaration.

Tip: Give files clear names (e.g., INV_12345_2025-08-01.pdf) to simplify audit trails.

3) When documents are sent automatically

When a declaration is submitted in TVINN toward Digitoll (i.e., the flow uses Digitoll), EmmaSped will automatically send the attached documents via API to Tolletaten.

  • After a successful send, you can verify timestamp under "DOK KONTROLL SENDT" .

    Snag_c5c209

Note: If the declaration is addressed to a different customs office where Digitoll does not apply, Tolletaten will only request documents if a document control is initiated.

4) How to send documents on demand (manual send)

If documents are not sent automatically (e.g., non‑Digitoll cases) or if Customs requests them:

  1. Open the declaration in EmmaSped.

  2. Confirm the necessary files are present under SCAN.

  3. from TVINN table, Select/mark the declaration in the list.

  4. Go to the DoK Kontrol menu in the top‑right and choose "Send med API" 

    Snag_c367be

Expected system behavior

  • The system packages the current attachments from Scan and transmits them to Tolletaten via the API endpoint authorized through Maskinporten.

  • On success, the declaration shows that documents have been sent (see verification below).

5) How to verify that documents were sent

Use any of the following:

  • TVINN tabell: Look for "DOK KONTROLL SENDT" colum in the table.

  • TVINN table indicators (for document control cases):

    • Declaration status  5.

    • The Kontroll field show code D (document control/D).

If Customs later requests documents, repeat the Send with API action after confirming the correct attachments are in Scan.

6) Common scenarios

A) Digitoll flow

  • You submit the declaration in TVINN (toward Digitoll).

  • EmmaSped auto‑sends attached documents.

  • You see a date in "DOK KONTROLL SENDT". And in the note on the actual scan view

B) Other expedition unit / non‑Digitoll

  • Documents are not auto‑sent.

  • If Tolletaten starts a document control, TVINN may show status 5 and Control = D.

  • You then send with API manually from Dok kontroll → Send med API.

7) Troubleshooting

  • I don’t see “DOK KONTROLL SENDT”.

    • Refresh the declaration. Confirm files exist in Scan. If non‑Digitoll, use Send med API.

  • Maskinporten/authorization errors.

    • Verify the client certificate is valid, Integration ID is correct, scopes/permissions match the Digitoll setup, and system time is accurate.

  • File/format issues.

    • Re‑upload the file and retry. Large or password‑protected PDFs may be rejected.

  • TVINN shows status 5, Control = D, but Customs says they didn’t receive documents.

    • Re‑send via Send med API and check the log for a success entry. Ensure attachments are present in Scan at send time.

8) Best practices

  • Attach all expected documents before submitting to TVINN when using Digitoll routes, to benefit from auto‑send.

  • If you add docuemnts after the TVINN subition, you will need to manually click Send med API after uploading the documents.

10) Support

If you need help with Maskinporten/Digdir configuration or encounter repeated send failures, contact Emma Support with:

  • Declaration ID and timestamp

  • Whether the flow is Digitoll or not

  • Screenshot of Scan and Dok kontroll

  • Any error messages from the log