04 EP: Calculate a Controlling Balance

Request Structure

Main JSON Object Structure (Collapsed)

The main structure of a controlling balance request depicts the calculation process and is divided into the following main objects:

{
    "nutrientCycle": {
        "animalStock": [{
        "storage": {
        "fieldSpreading": {
        "lifetimePerformance": {
        "farmManureTrading": {
        "fodder": {
        "fieldCultivation": {
    },
    "additionalModules": {
        "impex": [{
        "linearCorrection": {
    }
}

The request, identically to the planning balance calculation, is divided in nutrientCycle and additionalModules. While the objects of nutrientCycle calculate the main part of NC, additionalModules can be used for an upstream IMPEX and LK calculation. IMPEX and LK results can subsequently used for nutrientCycle calculations. For detailed description of each object see 03 EP: Calculate a Planning Balance.

Input difference between controlling balance and planning balance

The main difference in request body between controlling balance and planning balance lays within the permitted input fileds:

• All input fields with the prefix temp are forbidden for calculating a controlling balance
• The input field generateReport is ignored, as with every calculation of a controlling balance a PDF is generated for each module separately
• generateFacilitySpecificSlurryProduct & generateFacilitySpecificSlurryProduct are forbidden to be set to true. With controlling balance facility specific product can't be generated.