A-melding Submissions

A-melding (arbeidsgiver-melding) is the mandatory Norwegian employment and income report that employers must submit to Skatteetaten (the Norwegian Tax Administration) for each payroll period. The API allows you to preview, submit, and track a-melding submissions.

Submissions are created from posted payroll runs and sent to Skatteetaten via the Altinn/Maskinporten integration.

Endpoints

List Submissions

GET /api/v2/payroll/amelding-submissions

Retrieves a paginated list of a-melding submissions.

Query Parameters

Submissions are returned newest period first — period_year, period_month and id are all sorted descending — so the current period’s newest attempt is the first row and a replaced attempt follows it. The last row is the oldest.

Response

{
  "data": [
    {
      "id": 1,
      "created_by_id": 7,
      "created_at": "2024-06-01T10:00:00Z",
      "client_account_id": 7,
      "period_year": 2024,
      "period_month": 6,
      "meldings_id": "m-1234567890",
      "erstatter_meldings_id": null,
      "status": "ACCEPTED",
      "idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "payload": { },
      "response": { },
      "feedback": { },
      "error_details": null,
      "submitted_at": "2024-06-01T10:05:00Z",
      "submitted_by_id": 7,
      "dialog_id": null,
      "transmission_id": null,
      "dialogporten_dialog_id": null
    }
  ],
  "meta": {
    "page": 1,
    "pages": 1,
    "per_page": 100,
    "records": 1
  }
}

Get Submission

GET /api/v2/payroll/amelding-submissions/{id}

Retrieves a specific a-melding submission by ID.

Response

Returns a single submission object (same shape as the list response items).

Preview Submission

POST /api/v2/payroll/amelding-submissions/preview

Generates a preview of the a-melding payload that would be sent to Skatteetaten, without actually submitting it. Use this to review the data before submitting.

Request Body

Example Request

{
  "client_account_id": 7,
  "period_year": 2024,
  "period_month": 6
}

Response

{
  "payload": { },
  "warnings": [
    {
      "contract_id": 42,
      "business_partner_id": 56,
      "employee_name": "Ola Nordmann",
      "missing_fields": ["work_percentage", "last_salary_change_date"],
      "invalid_fields": []
    }
  ]
}

The payload object contains the full a-melding JSON structure that would be sent to Skatteetaten, including employee income details, tax deductions, and employer information.

warnings lists the ordinary employment contracts in the period that Skatteetaten will flag with an immediate deviation (MAGNET_EDAG-291) even though it accepts the submission. Each entry covers one contract:

warnings is an empty array when nothing needs attention. Only contracts with employment_type EMPLOYED and an employee with a personal number are checked — employees without one are left out of the payload, so they raise no warning.

Submit A-melding

POST /api/v2/payroll/amelding-submissions

Prepares and submits an a-melding to Skatteetaten for a given payroll period. The submission is created, then immediately sent to Skatteetaten via the Altinn integration.

Request Body

Example Request

{
  "client_account_id": 7,
  "period_year": 2024,
  "period_month": 6
}

Response

Returns the created submission object with status SUBMITTED on success. A submission that never reached Skatteetaten (authentication, network, or API error) is still returned with 200 OK, but with status SEND_FAILED and the reason in error_details — check status rather than the HTTP code.

{
  "id": 1,
  "created_by_id": 7,
  "created_at": "2024-06-01T10:00:00Z",
  "client_account_id": 7,
  "period_year": 2024,
  "period_month": 6,
  "meldings_id": "m-1234567890",
  "erstatter_meldings_id": null,
  "status": "SUBMITTED",
  "idempotency_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "payload": { },
  "response": { },
  "feedback": null,
  "error_details": null,
  "submitted_at": "2024-06-01T10:05:00Z",
  "submitted_by_id": 7,
  "dialog_id": "d-abcdef123456",
  "transmission_id": "t-abcdef123456",
  "dialogporten_dialog_id": null
}

Submission Flow

1. The system prepares the a-melding payload from posted payroll runs for the specified period
2. The payload is sent to Skatteetaten via the Altinn/Maskinporten integration
3. On success, the status is set to SUBMITTED and background tasks are queued to sync feedback from Skatteetaten
4. If the send fails, the status is set to SEND_FAILED and error_details records the upstream status code, message, and response body
5. If Skatteetaten already received a submission for the same period, the new submission replaces it: erstatter_meldings_id references the latest SUBMITTED or ACCEPTED attempt, skipping newer failed or rejected ones

Attributes

Submission Statuses

Error Responses

Business Rules

1. A-meldinger are built from posted payroll runs — you must have completed payroll runs for the period before submitting
2. period_year must be between 2020 and 2100, and period_month must be between 1 and 12
3. Submitting a new a-melding for a period Skatteetaten has already received creates a replacement (korrigert a-melding). Failed and rejected attempts are skipped when picking what to replace, so a retry after a SEND_FAILED does not replace anything
4. After successful submission, background tasks automatically sync feedback from Skatteetaten
5. A REJECTED finding never overrides an ACCEPTED submission — a late rejection for an a-melding that has since been accepted is logged and the status left alone
6. All fields on the submission are read-only — the system builds the payload automatically from payroll data

Related Resources

• Payroll Runs — the payroll data used to build the a-melding
• Payroll Reports — aggregated payroll report views
• Payroll Contracts — employment contracts
• NAV Forespørsler — NAV inquiries related to employees
• Integrations — Altinn and Maskinporten integration setup