API Calls to Check Fiscal Year Transition

Within MKG, process numbering is based on the fiscal year currently in use. If a user is working in fiscal year 2025 and creates a new sales order, the sales order number will start with 3025. After creating a new fiscal year, the sales order number will begin with 3026, once you have switched to fiscal year 2026 and create a new sales order.

The API executes actions through an API user, which also operates in a specific fiscal year. To ensure that process numbering and bookings continue to occur in the correct fiscal year, you can execute API calls to check which fiscal year the API user is currently in and to switch fiscal years. Two examples of API calls:

Example 1: Check Current API User

GET {{restUrl}}/Settings?Settings=Administration,FiscalYear,Language

Response:

{
    "response": {
        "ResultData": [
            {
                "t_setting":[
                    {
                        "t_name": "Administration",
                        "t_value": "1"
                    },
                    {
                        "t_name": "FiscalYear",
                        "t_value": "2025"
                    },
                    {
                        "t_name": "Language",
                        "t_value": "1043"
                    }
                ]
            }
        ]
    }
}

Example 2: Switch Fiscal Year

PUT {{restUrl}}/Settings

Body:

{
    "request": {
        "InputData": {
            "t_setting": [
                {
                    "t_name": "Administration",
                    "t_value": "1"
                },
                {
                    "t_name": "FiscalYear",
                    "t_value": "2026"
                }
            ]
        }
    }
}

Response:

{
    "response": {
        "ResultData": [
            {
                "t_setting": [
                    {
                        "t_name": "Administration",
                        "t_value": "1"
                    },
                    {
                        "t_name": "FiscalYear",
                        "t_value": "2026"
                    }
                ]
            }
        ]
    }
}