Wenche.SkdClient (wenche v0.3.0)

Copy Markdown View Source

SKD API client for aksjonærregisteroppgave (RF-1086).

Skatteetaten has its own REST API for reporting — independent of Altinn instance flow. Authentication uses a Maskinporten token directly (not exchanged for Altinn token).

Submission flow:

  1. POST /{year}/1086H — send Hovedskjema, get back hovedskjemaid
  2. POST /{year}/{id}/1086U — send Underskjema for each shareholder
  3. POST /{year}/{id}/bekreft — confirm all sub-forms submitted

Summary

Functions

Confirms that all sub-forms have been submitted.

Creates a new SKD client config.

Sends Hovedskjema (RF-1086) to SKD.

Sends Underskjema (RF-1086-U) for one shareholder.

Functions

bekreft(client, regnskapsaar, hovedskjemaid, antall_underskjema)

Confirms that all sub-forms have been submitted.

Returns {:ok, response_map} with forsendelse-ID and dialog-ID, or {:error, reason}.

new(maskinporten_token, opts \\ [])

Creates a new SKD client config.

Returns a map with base URL, token, and req_options for use in other functions.

Options

  • :env"test" or "prod" (default: "prod")
  • :req_options — extra options passed to Req (default: [])

send_hovedskjema(client, regnskapsaar, xml)

Sends Hovedskjema (RF-1086) to SKD.

Returns {:ok, hovedskjemaid} or {:error, reason}.

send_underskjema(client, regnskapsaar, hovedskjemaid, xml)

Sends Underskjema (RF-1086-U) for one shareholder.

Returns :ok or {:error, reason}.