API-aanroepen om boekjaarovergang te controleren

Binnen MKG zijn de procesnummeringen gebaseerd op het boekjaar waar nu in wordt gewerkt. Als een gebruiker in boekjaar 2025 werkt en bijvoorbeeld een nieuwe verkooporder aanmaakt, begint het verkoopordernummer met 3025. Na het aanmaken van een nieuw boekjaar zal het verkoopordernummer beginnen met 3026, nadat je bent gewisseld naar boekjaar 2026 en een nieuwe verkooporder aanmaakt.

De API voert acties uit via een API-gebruiker wat ook werkt in een bepaald boekjaar. Om ervoor te zorgen dat de procesnummeringen en boekingen in het juiste boekjaar blijven gebeuren kun je API-calls uitvoeren om te controleren in welke boekjaar de API-gebruiker nu zit en om te wisselen van boekjaar. Twee voorbeelden van API-calls:

Voorbeeld 1: Controle huidige API-gebruiker

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"
                    }
                ]
            }
        ]
    }
}

Voorbeeld 2: Wisselen van boekjaar

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"
                    }
                ]
            }
        ]
    }
}