NAV Refund Claims

NAV refund claims (inntektsmeldinger) allow employers to claim reimbursement from NAV (the Norwegian Labour and Welfare Administration) for employee absences. The API supports preparing and submitting claims for sick pay, parental leave, and care days.

Claims are created from existing employee leaves and submitted to NAV via the Altinn/Maskinporten integration.

Endpoints

List Claims

GET /api/v2/payroll/nav-claims

Retrieves a paginated list of NAV refund claims.

Query Parameters

Response

{
  "data": [
    {
      "id": 1,
      "created_by_id": 7,
      "created_at": "2024-06-01T10:00:00Z",
      "client_account_id": 7,
      "business_partner_id": 56,
      "leave_id": 12,
      "claim_type": "SYKEPENGER",
      "status": "SUBMITTED",
      "monthly_income": "45000.000000",
      "first_absence_date": "2024-05-15",
      "arbeidsforhold_id": "1",
      "payload": { },
      "response": { },
      "error_details": null,
      "submitted_at": "2024-06-01T10:05:00Z",
      "submitted_by_id": 7,
      "nav_case_id": "NAV-2024-12345",
      "nav_referanse_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "innsending_id": null,
      "aarsak_innsending": "Ny",
      "forespoersel_id": 1
    }
  ],
  "meta": {
    "page": 1,
    "pages": 1,
    "per_page": 50,
    "records": 1
  }
}

Get Claim

GET /api/v2/payroll/nav-claims/{id}

Retrieves a specific NAV refund claim by ID.

Response

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

Create Claim

POST /api/v2/payroll/nav-claims

Prepares a new NAV refund claim from an existing employee leave record. The claim is created in DRAFT status with a pre-calculated monthly income and NAV payload.

Request Body

Example Request

{
  "leave_id": 12,
  "nav_referanse_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "contact_name": "Ola Nordmann",
  "contact_phone": "+4791234567"
}

Response

Returns the created claim with status 201 Created.

How Monthly Income is Calculated

The system calculates the employee’s average monthly income by looking at the 3 most recent posted payroll runs before the leave start date. It sums all taxable earnings from those runs and divides by 3.

Leave Type to Claim Type Mapping

Submit Claim

POST /api/v2/payroll/nav-claims/{id}/submit

Submits a draft claim to NAV. The claim must be in DRAFT status and must have a nav_referanse_id (claims created against the old NAV API without a reference must be re-created). After submission, the status is updated to either SUBMITTED (success) or REJECTED (failure).

Response

Returns the updated claim object.

Submission Results

• Success: Status is set to SUBMITTED, nav_case_id is populated with the NAV case reference, and submitted_at is recorded.
• Failure: Status is set to REJECTED and error_details contains the error information from the NAV API.

Example Error Details (on rejection)

{
  "error_details": {
    "status_code": 422,
    "message": "Validation failed",
    "response_body": "..."
  }
}

Attributes

Claim Types

Claim Statuses

Error Responses

Business Rules

1. Claims are created from existing employee leave records — you cannot create a claim without a leave
2. Claims must be linked to a NAV forespørsel via nav_referanse_id — sync forespørsler first to obtain the reference
3. All claim fields are read-only after creation; the system calculates income and builds the NAV payload automatically
4. Only claims in DRAFT status can be submitted, and they must have a nav_referanse_id
5. The employer sick pay period (arbeidsgiverperioden) is 16 days and is automatically included in sick pay claims

Related Resources

• NAV Forespørsler — NAV inquiries that provide the nav_referanse_id required for creating claims
• Payroll Leaves — employee leave records that claims are based on
• Payroll Contracts — employment contracts
• Payroll Runs — used for monthly income calculation