Testing Guide

Overview

This guide outlines the mandatory test scenarios for integrating with the MMR-SASK API. You must complete all test scenarios in the test environment before moving to production.

Once you complete all test cases, contact us to proceed with production deployment.

Test Environment

Use the development server for all testing:

https://api.rrc.dev.finventi.com

Test Scenarios

Report Natural Person Account
Report Legal Entity Account

Natural person accounts are reported with owner type F. This flow covers account creation, updates, and representative management.What you report for a natural person account:

Account details - IBAN, currency, account type, open/close dates
Owner information - Name, surname, birth date, address, nationality
Identification - Personal code or foreign identification code, document type and number
Representatives - Individuals authorized to manage the account on behalf of the owner

Beneficial owners (UBO) are not reported for natural person accounts.
Representatives can only be natural persons.

Test Case 1: Create Account

Objective: Report a newly opened account with owner and representatives to the tax authority.Use POST only for newly opened accounts. If the account was opened and closed on the same day, include closedDate in the request - no separate update is required.Request: POST /reports/sask/v1/accountsRequest Body:

[
  {
    "accountType": "CURRENT_ACCOUNT",
    "iban": "LT601010012345678901",
    "currency": "EUR",
    "openedDate": "2024-12-20",
    "owner": {
      "type": "F",
      "name": "Jonas",
      "surname": "Jonaitis",
      "birthDate": "1990-05-15",
      "addressCountry": "LT",
      "address": "Vilnius, Gedimino pr. 1",
      "codeCountry": "LT",
      "codeInForeignCountry": "39005150001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "AB123456",
      "nationalities": ["LT"]
    },
    "representatives": [
      {
        "dateFrom": "2024-12-20",
        "representative": {
          "type": "F",
          "name": "Petras",
          "surname": "Petraitis",
          "birthDate": "1985-03-20",
          "addressCountry": "LT",
          "address": "Kaunas, Laisves al. 10",
          "codeCountry": "LT",
          "codeInForeignCountry": "38503200001",
          "documentType": "LT_PASSPORT",
          "documentNumber": "CD789012",
          "nationalities": ["LT"]
        }
      }
    ]
  }
]

The representatives array is optional. Include it when the account has authorized representatives.

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_E5D11991C7B74CB0",
      ...
    }
  }
]

Store the returned refId for use in Test Cases 2, 3, and 4.

Test Case 2: Update Account

Objective: Update a previously reported account when account details or owner information changes.The refId from the original account submission is required to identify the record to update.Request: PUT /reports/sask/v1/accountsRequest Body:

[
  {
    "refId": "<refId from Test Case 1>",
    "accountType": "CURRENT_ACCOUNT",
    "iban": "LT601010012345678901",
    "currency": "EUR",
    "openedDate": "2024-12-20",
    "closedDate": "2025-06-30",
    "owner": {
      "type": "F",
      "name": "Jonas",
      "surname": "Jonaitis",
      "birthDate": "1990-05-15",
      "addressCountry": "LT",
      "address": "Vilnius, Gedimino pr. 1",
      "codeCountry": "LT",
      "codeInForeignCountry": "39005150001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "AB123456",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_E5D11991C7B74CB0",
      ...
    }
  }
]

Test Case 3: Create Representative

Objective: Add a new representative for an already reported account.The accountRefId in the URL must be the refId returned when the account was reported.Request: POST /reports/sask/v1/accounts/{accountRefId}/representativesRequest Body:

[
  {
    "dateFrom": "2024-12-18",
    "representative": {
      "type": "F",
      "name": "Petras",
      "surname": "Petraitis",
      "birthDate": "1985-03-20",
      "addressCountry": "LT",
      "address": "Kaunas, Laisves al. 10",
      "codeCountry": "LT",
      "codeInForeignCountry": "38503200001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "CD789012",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "a8306155-8731-4aea-9b36-d30e958fbe33",
      ...
    }
  }
]

Store the returned representative refId for Test Case 4.

Test Case 4: Update Representative

Objective: Update a representative when their information changes, or end the representative relationship by adding dateTo.Request: PUT /reports/sask/v1/accounts/{accountRefId}/representativesRequest Body:

[
  {
    "refId": "<representative refId from Test Case 3>",
    "dateFrom": "2024-12-18",
    "dateTo": "2025-12-31",
    "representative": {
      "type": "F",
      "name": "Petras",
      "surname": "Petraitis",
      "birthDate": "1985-03-20",
      "addressCountry": "LT",
      "address": "Kaunas, Laisves al. 10",
      "codeCountry": "LT",
      "codeInForeignCountry": "38503200001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "CD789012",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "a8306155-8731-4aea-9b36-d30e958fbe33",
      ...
    }
  }
]

Legal entity (juridical person) accounts are reported with owner type J. This flow covers account creation, updates, and beneficial owner reporting.What you report for a legal entity account:

Account details - IBAN, currency, account type, open/close dates
Owner information - Company name, registration code, address
Representatives - Individuals authorized to manage the account on behalf of the legal entity
Beneficiaries - Ultimate beneficial owners of the legal entity (natural persons)

Beneficial owners (UBO) are not required for Lithuanian companies.
Beneficial owners and representatives can only be natural persons.

Test Case 1: Create Account

Objective: Report a newly opened account for a legal entity to the tax authority.Use POST only for newly opened accounts. If the account was opened and closed on the same day, include closedDate in the request - no separate update is required.Request: POST /reports/sask/v1/accountsRequest Body:

[
  {
    "accountType": "CURRENT_ACCOUNT",
    "iban": "LT701010098765432100",
    "currency": "EUR",
    "openedDate": "2024-12-20",
    "owner": {
      "type": "J",
      "surname": "UAB Example Company",
      "codeCountry": "LT",
      "codeInForeignCountry": "305697289",
      "addressCountry": "LT",
      "address": "Vilnius, Lvovo g. 25"
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_J1K2L3M4N5O6",
      ...
    }
  }
]

Store the returned refId for use in Test Case 2.

Test Case 2: Update Account

[
  {
    "refId": "<refId from Test Case 1>",
    "accountType": "CURRENT_ACCOUNT",
    "iban": "LT701010098765432100",
    "currency": "EUR",
    "openedDate": "2024-12-20",
    "closedDate": "2025-06-30",
    "owner": {
      "type": "J",
      "surname": "UAB Example Company",
      "codeCountry": "LT",
      "codeInForeignCountry": "305697289",
      "addressCountry": "LT",
      "address": "Vilnius, Lvovo g. 25"
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_J1K2L3M4N5O6",
      ...
    }
  }
]

Test Case 3: Create Beneficiary

Objective: Report a beneficial owner (natural person) for a legal entity.Beneficiaries are reported separately from accounts using the legal entity’s identification code.Request: POST /reports/sask/v1/beneficiariesRequest Body:

[
  {
    "codeInForeignCountry": "305697289",
    "name": "UAB Example Company",
    "dateFrom": "2024-12-18",
    "country": "LV",
    "address": "Vilnius, Lvovo g. 25",
    "beneficiary": {
      "type": "F",
      "name": "Jonas",
      "surname": "Jonaitis",
      "birthDate": "1990-05-15",
      "addressCountry": "LT",
      "address": "Vilnius, Gedimino pr. 1",
      "codeCountry": "LT",
      "codeInForeignCountry": "39005150001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "AB123456",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_F1A2B3C4D5E6",
      ...
    }
  }
]

Store the returned refId for Test Case 4.

Test Case 4: Update Beneficiary

Objective: Update a beneficiary when their information changes, or end the beneficial ownership by adding dateTo.The refId from the original beneficiary submission is required to identify the record to update.Request: PUT /reports/sask/v1/beneficiariesRequest Body:

[
  {
    "refId": "<refId from Test Case 3>",
    "codeInForeignCountry": "305697289",
    "name": "UAB Example Company",
    "dateFrom": "2024-12-18",
    "dateTo": "2025-12-31",
    "country": "LV",
    "address": "Vilnius, Lvovo g. 25",
    "beneficiary": {
      "type": "F",
      "name": "Jonas",
      "surname": "Jonaitis",
      "birthDate": "1990-05-15",
      "addressCountry": "LT",
      "address": "Vilnius, Gedimino pr. 1",
      "codeCountry": "LT",
      "codeInForeignCountry": "39005150001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "AB123456",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "305697289_20250303_F1A2B3C4D5E6",
      ...
    }
  }
]

Test Case 5: Create Representative

Objective: Add a new representative for an already reported legal entity account.The accountRefId in the URL must be the refId returned when the account was reported.Request: POST /reports/sask/v1/accounts/{accountRefId}/representativesRequest Body:

[
  {
    "dateFrom": "2024-12-20",
    "representative": {
      "type": "F",
      "name": "Petras",
      "surname": "Petraitis",
      "birthDate": "1985-03-20",
      "addressCountry": "LT",
      "address": "Kaunas, Laisves al. 10",
      "codeCountry": "LT",
      "codeInForeignCountry": "38503200001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "CD789012",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "b9417266-9842-5bfb-0c47-e41f069gcf44",
      ...
    }
  }
]

Store the returned representative refId for Test Case 6.

Test Case 6: Update Representative

[
  {
    "refId": "<representative refId from Test Case 5>",
    "dateFrom": "2024-12-20",
    "dateTo": "2025-12-31",
    "representative": {
      "type": "F",
      "name": "Petras",
      "surname": "Petraitis",
      "birthDate": "1985-03-20",
      "addressCountry": "LT",
      "address": "Kaunas, Laisves al. 10",
      "codeCountry": "LT",
      "codeInForeignCountry": "38503200001",
      "documentType": "LT_PASSPORT",
      "documentNumber": "CD789012",
      "nationalities": ["LT"]
    }
  }
]

Expected Response:

[
  {
    "status": "SUCCESS",
    "data": {
      "refId": "b9417266-9842-5bfb-0c47-e41f069gcf44",
      ...
    }
  }
]

Batch Submission Tests

Test Case: Batch Submission - All Success (HTTP 200/201)

Objective: Verify batch submission where all records are valid.Steps:

Submit multiple valid records in a single request
Verify HTTP 200 or 201 response
Confirm all items have status: SUCCESS

Expected Result:

HTTP 201 Created
[
  { "status": "SUCCESS", "data": { "refId": "..." } },
  { "status": "SUCCESS", "data": { "refId": "..." } },
  { "status": "SUCCESS", "data": { "refId": "..." } }
]

Test Case: Batch Submission - Partial Success (HTTP 207)

Objective: Verify batch submission where some records fail validation.Steps:

Submit multiple records where at least one has invalid data
Verify HTTP 207 response
Confirm successful items have status: SUCCESS
Confirm failed items have status: FAILED with error details

Expected Result:

HTTP 207 Multi-Status
[
  { "status": "SUCCESS", "data": { "refId": "..." } },
  { "status": "FAILED", "data": { ... }, "errors": [{ "field": "...", "message": "..." }] }
]

Test Case: Batch Submission - All Failed (HTTP 400)

Objective: Verify batch submission where all records fail validation.Steps:

Submit multiple records where all have invalid data
Verify HTTP 400 response
Confirm all items have status: FAILED with error details

Expected Result:

HTTP 400 Bad Request
[
  { "status": "FAILED", "data": { ... }, "errors": [{ "field": "...", "message": "..." }] },
  { "status": "FAILED", "data": { ... }, "errors": [{ "field": "...", "message": "..." }] }
]

Best Practices

Store Reference IDs

Always save the refId returned for each created record. You need this ID to update or delete records later.

Handle Partial Success

When you receive HTTP 207, check each item in the response array. Some items succeeded while others failed.

Validate Before Submission

Validate your data locally before sending to reduce failed submissions and improve processing speed.

Getting Started

Regulatory Reporting Connector

PLAIS

Overview

Test Environment

Test Scenarios

Batch Submission Tests

Best Practices

Store Reference IDs

Handle Partial Success

Validate Before Submission

​Overview

​Test Environment

​Test Scenarios

​Batch Submission Tests

​Best Practices

Store Reference IDs

Handle Partial Success

Validate Before Submission

Overview

Test Environment

Test Scenarios

Batch Submission Tests

Best Practices