Remuneration_V2

Get the yearly remuneration calculation for an installation (insts_id) -
not a device_id. Computed live (not cached) by shelling out to the same
calculation the web's remuneration Calculadora uses.

/v2/remuneration/<insts-id>/?year=XXXX

Arguments

insts_id [*]: Installation id number.
year: (Optional) Year to calculate. Defaults to the current year.

Response

JSON object with the result. May return the following errors:

404 Not found : No installation found or don't have rights to get data
400 Wrong insts id or year: The id/year format is incorrect
502 Calculation failed : The underlying script errored, timed out,
or is not configured

Example

Get the remuneration calculation for insts_id 21, year 2025

GET /v2/remuneration/21?year=2025 HTTP/1.1
Host: apiexternal.mvscada.com
MV-API-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Content-Type: application/json

Response

Old installation, with código IT (RO/RI regulatory fields populated):

{
    "insts_id": 5,
    "year": 2025,
    "remuneration": {
        "months": [
            {
                "month": 1,
                "kwh": 3020,
                "pool": 253.11590703693005,
                "ro": 6.465819999999935,
                "ri": 1357.24,
                "coef_d": 1,
                "hours_acum": 100.66666666666667,
                "ro_max_h": 1575,
                "ro_max_h_reached": false,
                "invoice_total_cur": 571.3927385799999,
                "invoice_diferencia": 824.5086456169299
            },
            {"...": "..."}
        ],
        "hasCodIt": true,
        "modelo583": {
            "partial": {
                "label": "L1-L9 2025",
                "energy_mwh": 0,
                "base_imponible": 10944.12723025139,
                "tipo": 7.0,
                "cuota_integra": 766.0889061175974,
                "pago_fraccionado": 0,
                "cuota_diferencial": 766.0889061175974
            },
            "closing": {"...": "..."}
        },
        "roRetribution": 2.141
    }
}

New installation, without código IT (just energy * pool price, no RO/RI):

{
    "insts_id": 2307,
    "year": 2025,
    "remuneration": {
        "months": [
            {
                "month": 1,
                "kwh": 200716,
                "pool": 20184.495929999983,
                "ro": null,
                "ri": null,
                "coef_d": null,
                "hours_acum": null,
                "ro_max_h": null,
                "ro_max_h_reached": false,
                "invoice_total_cur": null,
                "invoice_diferencia": 20184.495929999983
            },
            {"...": "..."}
        ],
        "hasCodIt": false,
        "modelo583": null,
        "roRetribution": null
    }
}