anskaffelser / eforms-sdk-nor

7 stars 1 forks source link

eForms SDK NOR

This repository contains the resources used to create a modified edition of the official eForms SDK distribution with modifications for the Norwegian market.

Please see the releases page to download modified distributions of the official eForms SDK for use in the Norwegian market. For all documentation of how to use and interpret eForms please refer to the official eForms documentation.

The Doffin API

The Doffin API is available at the following endpoints:

These are hosted as two independent systems, so you need to register for each environment that you want to access. For example, to start using using the test/dev API's you first have to sign up as a user, log in and create one or more subscriptions.

Each endpoint provides two APIs:

Important regarding the Notices API

Once you have created a subscription for the Notices API please contact charlotte.kolle@dfo.no to get the subscription activated.

For now we are not returning any validation results. Please make sure that you are using valid and well-formed eForms messages before testing the integration. To test for validity and well-formness during development please use:

Please note that eForms messages using these extensions will fail validation in TED unless you pre-process with using the xslt-filter provided in this repository.

The endpoint supports the eForms-versions included in the newest release of this repository.

Why do we need a Norwegian SDK?

This SDK completes the official SDK with two extensions needed for the Norwegian market:

This SDK is not tailoring of eForms for Norway (changing the content in eForms). For now, we have opted not to do any tailoring.

How to identify Norwegian eForms?

To indicate that you are submitting Norwegian eForms to us please extend the content in your CustomizationID-element where you indicate which version of eForms you are submitting with one of the following two constants:

Example:

<cbc:CustomizationID>eforms-sdk-1.8#extended#urn:fdc:anskaffelser.no:2023:eforms:national</cbc:CustomizationID> 

b