Testing Guide

Overview

Complete both scenarios in the test environment before moving to production: report persons for a sub-report and year, then correct one of them. Run them once for each sub-report, since SIPL, SLIK and SKIS carry different person data and are authorised separately. See Testing for the test environment and the practices shared by every report.

Test Scenarios

Report Persons
Correct Reported Person

Create a submission for one sub-report and year, push your persons, then submit.

Test Case 1: Create Submission

Objective: Create a new submission for one sub-report and reporting year.Request: POST /reports/mai55/v1/submissionsRequest Body:

{
  "type": "SIPL",
  "reportingYear": 2025,
  "webhookUrl": "https://example.com/mai55/webhook"
}

webhookUrl is optional. Include it and the connector calls it with the final verdict once the submission finishes processing:

{"submissionId": "6f1b0c1e-6c0b-4c39-9a2e-1d9d2f0f7a11", "status": "ACCEPTED"}

Whitelist the sending IP addresses first. They are listed under Webhook. Test whichever route you plan to use in production.

Expected Response: HTTP 201 Created

{
  "submissionId": "6f1b0c1e-6c0b-4c39-9a2e-1d9d2f0f7a11",
  "type": "SIPL",
  "kind": "SUBMISSION"
}

Confirm kind is SUBMISSION and type matches what you asked for. Store the submissionId. It scopes every call in Test Cases 2 to 4.

Test Case 2: Push Persons

Objective: Add the persons you report for the year. Call this as many times as you need.Push to the path matching the submission’s sub-report. Pushing to another one is rejected.

SIPL
SLIK
SKIS

Request: POST /reports/mai55/v1/submissions/{submissionId}/sipl/personsThe example pushes two: a natural person and a legal entity.

[
  {
    "clientPersonId": "CLIENT-000123",
    "individual": {
      "firstName": "Jonas",
      "lastName": "Jonaitis",
      "personCode": "39001010000"
    },
    "accounts": [
      {
        "accountNumber": "LT121000011101001000",
        "accountType": "CURRENT_ACCOUNT",
        "income": 18500.00
      }
    ]
  },
  {
    "clientPersonId": "CLIENT-000124",
    "organisation": {
      "name": "UAB Inventi",
      "code": "123456789",
      "issuedBy": "LT"
    },
    "accounts": [
      {
        "accountNumber": "LT601010012345678901",
        "accountType": "CURRENT_ACCOUNT",
        "income": 42500.00
      }
    ]
  }
]

Only persons whose income across all their accounts reaches 15,000 EUR are reportable under SIPL. The total is summed from the accounts rather than sent.

Request: POST /reports/mai55/v1/submissions/{submissionId}/slik/personsBalances as they stood at the end of the reporting year.

[
  {
    "clientPersonId": "CLIENT-000123",
    "individual": {
      "firstName": "Jonas",
      "lastName": "Jonaitis",
      "personCode": "39001010000"
    },
    "accounts": [
      {
        "accountNumber": "LT121000011101001000",
        "accountType": "CURRENT_ACCOUNT",
        "balance": 15320.44
      },
      {
        "accountNumber": "LT601010012345678901",
        "accountType": "SAVINGS_ACCOUNT",
        "balance": 4800.00
      }
    ]
  }
]

Request: POST /reports/mai55/v1/submissions/{submissionId}/skis/personsDebts still outstanding on 31 December of the reporting year.

[
  {
    "clientPersonId": "CLIENT-000123",
    "individual": {
      "firstName": "Jonas",
      "lastName": "Jonaitis",
      "personCode": "39001010000"
    },
    "debts": [
      {
        "agreementNumber": "CR-2024-000123",
        "agreementDate": "2024-03-15",
        "repaymentDate": "2029-03-15",
        "debtKind": "Consumer credit",
        "debtAmount": 15000.00,
        "reportableDebtAmount": 9800.50,
        "repaymentType": "Periodic payments in equal amounts",
        "jointLiability": 2,
        "interestRate": 7.5
      }
    ]
  }
]

clientPersonId is your own key. It must be unique within the submission, and it is how you amend or withdraw the person later. Send the optional Idempotency-Key header so a retry returns the original response instead of pushing the batch twice.

Expected Response: HTTP 201 Created

[
  {
    "status": "SUCCESS",
    "clientPersonId": "CLIENT-000123",
    "errors": []
  },
  {
    "status": "SUCCESS",
    "clientPersonId": "CLIENT-000124",
    "errors": []
  }
]

Test Case 3: Submit

Objective: Hand the submission off to be reported to the tax authority.Request: POST /reports/mai55/v1/submissions/{submissionId}:submitNo request body.Expected Response: HTTP 200 OK

After this call the submission is no longer editable. Push all persons first.

Test Case 4: Track Progress

Objective: Follow the submission until the tax authority accepts it.

Use these calls instead of the webhook, or alongside it whenever you want to check a submission by hand.

Request: GET /reports/mai55/v1/submissions/{submissionId}/statusExpected Response: HTTP 200 OK

{
  "submissionId": "6f1b0c1e-6c0b-4c39-9a2e-1d9d2f0f7a11",
  "type": "SIPL",
  "status": "PROCESSING"
}

Poll until status becomes REPORTED.

To change a sub-report and year you have already reported, create a submission for the same pair again. The same endpoints now act on what the tax authority already holds, keyed by clientPersonId.

Test Case 1: Create Correction

Objective: Create a correction round for a sub-report and year you have already reported.Request: POST /reports/mai55/v1/submissionsRequest Body:

{
  "type": "SIPL",
  "reportingYear": 2025
}

Expected Response: HTTP 201 Created

{
  "submissionId": "b3c9a4d2-1f77-4f0e-8d3a-5c6b7e8f9a01",
  "type": "SIPL",
  "kind": "CORRECTION"
}

Confirm that kind is now CORRECTION and use this submissionId for the subsequent requests.

Only one round per sub-report and year runs at a time. If the first submission is still being processed, this call returns HTTP 409. Wait for it to reach REPORTED and try again.

Test Case 2: Update Person

Objective: Amend an already-reported person.Send the complete person with all their accounts or debts, not just the changed ones. PUT replaces the person rather than merging into them, so whatever you leave out stops being reported.Amend through the path matching the submission’s sub-report, exactly as when you pushed.

SIPL
SLIK
SKIS

Request: PUT /reports/mai55/v1/submissions/{submissionId}/sipl/persons/{clientPersonId}Here the income paid into the account changed.

{
  "clientPersonId": "CLIENT-000123",
  "individual": {
    "firstName": "Jonas",
    "lastName": "Jonaitis",
    "personCode": "39001010000"
  },
  "accounts": [
    {
      "accountNumber": "LT121000011101001000",
      "accountType": "CURRENT_ACCOUNT",
      "income": 21750.00
    }
  ]
}

Request: PUT /reports/mai55/v1/submissions/{submissionId}/slik/persons/{clientPersonId}Here the current account’s year-end balance was restated. The savings account is unchanged but still sent, because leaving it out would stop it being reported.

{
  "clientPersonId": "CLIENT-000123",
  "individual": {
    "firstName": "Jonas",
    "lastName": "Jonaitis",
    "personCode": "39001010000"
  },
  "accounts": [
    {
      "accountNumber": "LT121000011101001000",
      "accountType": "CURRENT_ACCOUNT",
      "balance": 16980.10
    },
    {
      "accountNumber": "LT601010012345678901",
      "accountType": "SAVINGS_ACCOUNT",
      "balance": 4800.00
    }
  ]
}

Request: PUT /reports/mai55/v1/submissions/{submissionId}/skis/persons/{clientPersonId}Here the amount still owed at the end of the year was restated.

{
  "clientPersonId": "CLIENT-000123",
  "individual": {
    "firstName": "Jonas",
    "lastName": "Jonaitis",
    "personCode": "39001010000"
  },
  "debts": [
    {
      "agreementNumber": "CR-2024-000123",
      "agreementDate": "2024-03-15",
      "repaymentDate": "2029-03-15",
      "debtKind": "Consumer credit",
      "debtAmount": 15000.00,
      "reportableDebtAmount": 8450.00,
      "repaymentType": "Periodic payments in equal amounts",
      "jointLiability": 2,
      "interestRate": 7.5
    }
  ]
}

Expected Response: HTTP 200 OK

{
  "status": "SUCCESS",
  "clientPersonId": "CLIENT-000123",
  "errors": []
}

Amending a person the tax authority has never seen is rejected. Add such a person with POST instead.

Test Case 3: Delete Person

Objective: Withdraw a reported person’s entry, with every account or debt it carried.Request: DELETE /reports/mai55/v1/submissions/{submissionId}/{sipl|slik|skis}/persons/{clientPersonId}Use the path matching the submission’s sub-report. No request body.Expected Response: HTTP 204 No Content

A person the tax authority has never seen returns HTTP 404. A person you withdrew earlier may be pushed again under the same clientPersonId in a later round, and is reported afresh rather than as a correction.

Test Case 4: Submit Correction

Objective: Send the correction to the tax authority.Like the first submission, a correction only reaches the tax authority once you submit it.Request: POST /reports/mai55/v1/submissions/{submissionId}:submitExpected Response: HTTP 200 OKTrack it with GET .../status as in the first scenario. You can open as many correction rounds for a sub-report and year as you need, one at a time.

Getting Started

Regulatory Reporting Connector

PLAIS

Overview

Test Scenarios

​Overview

​Test Scenarios

Overview

Test Scenarios