API/Magazzino

2026-07-02T11:01:12Z

Admin:

2026-06-04T12:52:43Z

Admin:

[https://wiki.monvisoenergia.it/index.php?title=API ◀ Torna al menù API]

'''Elenco dei contratti di fornitura'''

Nell'header delle richieste va specificata l'autenticazione

X-API-TOKEN: {chiave da 128 caratteri fornita per l'impianto in questione)

GET https://smartbiogas.it/api/v1/suppliercontracts

Risultato: Json dei contratti di fornitura dell'impianto
[
{
"plant_suppliers_contracts_id": idContrattoDiFornitura,
"f_contract_number": "Numero o codice del contratto",
"f_certificate_number": "Numero o codice del certificato",
"f_date_start": "Data in formato ISO di partenza del contratto",
"f_date_end": "Data in formato ISO di chiusura del contratto",
"soggetto_id": idSoggetto del fornitore
},
{
"plant_suppliers_contracts_id": 47,
"f_contract_number": "",
"f_certificate_number": "",
"f_date_start": "2025-05-12",
"f_date_end": "2026-05-12",
"soggetto_id": 1876
},
...
]

'''Ricerca filtrando un fornitore'''

GET https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id={idSoggetto}

esempio https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id=1875

Risultato: stesso Json ma con 0 o più contratti filtrati per il fornitore passato nei criteri

'''Dati del contratto'''

GET https://smartbiogas.it/api/v1/suppliercontracts/{idContrattoDiFornitura}

esempio https://smartbiogas.it/api/v1/suppliercontracts/47

Risultato: stesso Json di sopra ma con un solo record e dettagli maggiori
{
"plant_suppliers_contracts_id": 47,
"f_contract_number": "",
"f_certificate_number": "",
"f_date_start": "2025-05-12",
"f_date_end": "2026-05-12",
"soggetto_id": 1876,
"feedstocks": [
{
"substrati_id": idProdotto,
"f_substrati_description": "Descrizione multilingua del prodotto",
"f_substrati_qta": quantità stipulata nel contratto in tons/anno
"f_contract_price": prezzo del contratto in €/anno
},
{
"substrati_id": 6,
"f_substrati_description": "{\"it\":\"Mais pianta intera insilato\",\"en\":\"Maize whole plant silage\",\"es\":\"Maize whole plant silage\",\"fr\":\"Maïs plante entière ensilée\"}",
"f_substrati_qta": 2500,
"f_contract_price": 1000,
},
],
...
}

Plant/Asservito a processi

2026-05-27T13:19:49Z

Admin: Merge edit by 79.135.39.194

Indicare se l'impianto è asservito ad un processo produttivo interno o esterno all'azienda al sensi della Delibera ARERA 174/2026.

L'asservimento può essere:

* Solo elettricità ceduta all'utenza
* Solo calore ceduto all'utenza
* Calore ed elettricità
Selezionare l'opzione in base alle informazioni tecniche ed agli eventuali contatori di energia presenti in impianto

2026-05-07T09:32:23Z

Admin: Admin moved page EN/Api/Impianto to EN/Api/Plant

[[EN/API|◀ Back to API Menu]]

'''Plant Data'''

Authentication must be specified in the request header:

X-API-TOKEN: {128-character key provided for the specific plant}

GET https://smartbiogas.it/api/v1/plant

Result: Json with an array of results
{
"plant_id": ''plantId'' 79,
"f_cod": ''identification code'' "CN24",
"plant_name": ''Description'' "Mene'",
"eu_countries_id": ''countryId'' 19,
"eu_cities_id": ''cityId'' 65678,
"f_plant_address": ''Address'' "Località Spessa Soprana 142\/A",
"f_plant_latlon": ''LAT_LON'' "44.7183308223895_7.7189437817964",
"f_plant_power": ''Plant power in kW'' 999,
"soggetto_proprietario": ''single object of the sole plant owner''
{
"soggetto_id": ''subjectId'' 77,
"f_soggetto_name": ''Company name'' "Menè Società Cooperativa Agricola",
"f_vat": ''VAT number'' "03328400043",
"soggetti_soci": ''Array of connected partners/shareholders''
[
{
"soggetto_id": ''partnerSubjectId'',
"f_soggetto_name": ''Partner company name'',
"f_vat": ''Partner VAT number''
},
{
"soggetto_id": 2095,
"f_soggetto_name": "Massimino Soc. Semplice Agr.",
"f_vat": "00230660045"
},
...
]
}
}

EN/Api/Plant

2026-05-07T09:32:08Z

Admin: Created page with "◀ Back to API Menu '''Plant Data''' Authentication must be specified in the request header: X-API-TOKEN: {128-character key provided for the specific plant} GET https://smartbiogas.it/api/v1/plant Result: Json with an array of results { "plant_id": ''plantId'' 79, "f_cod": ''identification code'' "CN24", "plant_name": ''Description'' "Mene'", "eu_countries_id": ''countryId'' 19, "eu_cities_id": ''cityId'' 65678, "f_plant_ad..."

EN/API/Analisi

2026-05-07T09:30:59Z

Admin: Admin moved page EN/API/Analisi to EN/API/Analysis

#REDIRECT [[EN/API/Analysis]]

EN/API/Analysis

2026-05-07T09:30:59Z

Admin: Admin moved page EN/API/Analisi to EN/API/Analysis

[[EN/API|◀ Back to API Menu]]

'''List of analyses for the plant in question'''

GET https://smartbiogas.it/api/v1/analysis

Result: Json with an array of results
[
{
"analisys_id": analysisId,
"f_data": "Date in ISO format YYYY-MM-DD",
"analisys_type_id": analysisTypeId,
"soggetto_id": laboratoryId (from API/Subjects),
"substrati_id": feedstockId,
"f_cod": "Analysis type code"
},
{
"analisys_id": 2379,
"f_data": "2017-08-10",
"analisys_type_id": 6,
"soggetto_id": -1,
"substrati_id": -1,
"f_cod": "GA-BAS"
},
...
]

'''Single analysis details:'''

GET https://smartbiogas.it/api/v1/analysis/{analysisId}

Example: https://smartbiogas.it/api/v1/analysis/1136

Result: Same Json as above but with a single record and more details. There is also a field called "parametri" (parameters) containing an array of determinands.
{
"analisys_id": 1136,
"f_data": "2013-11-25",
"analisys_type_id": 7,
"soggetto_id": -1,
"substrati_id": -1,
"ID": 7,
"F_Descrizione": "Emissions - analysis according to Legislative Decree 152\/2006",
"ID_Checklist": 145,
"substrati_analisi_id": 7,
"set_analisi_id": 1,
"f_cod": "FU-BAS",
"f_substrati_cod": "FU",
"f_substrati_description": "CHP Emissions",
"f_set_cod": "BAS",
"f_set_description": "Basic analysis",
"parametri": [
{
"analysis_parameter_id": analysisParameterId,
"determinand_id": INT determinandId,
"determinand_cod": TEXT "determinand code",
"determinand_description": "determinand description",
"sample_type_id": sampleTypeId,
"sample_type_cod": "sample type code",
"sample_type_description": "sample type description",
"f_metodo": "text reporting the methods used for the analyses",
"f_value": DECIMAL value of the analysis,
"unita_misura_id": measurementUnitId,
"f_um": "measurement unit description",
"f_note": "any notes regarding the reading"
},
{
"analysis_parameter_id": 7,
"determinand_id": 5,
"determinand_cod": "NOx_NO2",
"determinand_description": "Nitrogen oxides",
"sample_type_id": 2,
"sample_type_cod": "as-is",
"sample_type_description": "on an as-is basis",
"f_metodo": "Standards UNI EN 14789:2017 – UNI EN 14792:2017 – UNI EN 15058:2017",
"unita_misura_id": 38,
"f_value": "481.0000",
"f_um": "mg\/Nmc",
"f_note": "test note"
},
...
]
}

=== Inserting an analysis ===
It is possible to submit an analysis by providing a JSON containing all the data via the following API.

POST https://smartbiogas.it/api/v1/analysis

In the POST request, use this format along with the X-API-TOKEN key to identify the plant.

In the f_document field, insert only a PDF document (encoded in BASE64).
{
"f_data": DATE in ISO format,
"analysis_type_id": analysisTypeId,
"soggetto_id": subjectId (of the laboratory performing the analysis. Leave -1 if not specified),
"substrati_id": feedstockId (only if the analysis is performed on a specific material, otherwise leave -1),
"f_code": TEXT document code/number,
"f_document": TEXT Document file encoded in BASE64,
"parametri" :[
{
"analysis_parameter_id": analysisParameterId,
"lca_unita_misura_id": measurementUnitId,
"f_value" : DECIMAL value of the measurement in the specified unit

},
...

]
}

Example:
{
"f_data": "2026-01-31",
"analysis_type_id": 7,
"soggetto_id": -1,
"substrati_id": -1,
"f_code":"38572.024",
"f_document":"JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVyIC9GbGF0ZURlY29kZT4....",
"parametri" :[
{
"analysis_parameter_id": 7,
"lca_unita_misura_id": 38,
"f_value" : 0.23

},
{
"analysis_parameter_id": 7,
"lca_unita_misura_id": 38,
"f_value" : 4.82

}

]
}

EN/API/Analysis

2026-05-07T09:30:48Z

Admin: Created page with "◀ Back to API Menu '''List of analyses for the plant in question''' GET https://smartbiogas.it/api/v1/analysis Result: Json with an array of results [ { "analisys_id": analysisId, "f_data": "Date in ISO format YYYY-MM-DD", "analisys_type_id": analysisTypeId, "soggetto_id": laboratoryId (from API/Subjects), "substrati_id": feedstockId, "f_cod": "Analysis type code" }, { "analisys_id": 2379, "f_data": "2017-08-10", "analisy..."

EN/API/ContrattiDiFornitura

2026-05-07T09:29:45Z

Admin: Admin moved page EN/API/ContrattiDiFornitura to EN/API/SuppliersContracts

#REDIRECT [[EN/API/SuppliersContracts]]

EN/API/SuppliersContracts

2026-05-07T09:29:45Z

Admin: Admin moved page EN/API/ContrattiDiFornitura to EN/API/SuppliersContracts

[[EN/API|◀ Back to API Menu]]

'''List of supply contracts'''

Authentication must be specified in the request header:

X-API-TOKEN: {128-character key provided for the specific plant}

GET https://smartbiogas.it/api/v1/suppliercontracts

Result: Json of the plant's supply contracts
[
{
"plant_suppliers_contracts_id": supplyContractId,
"f_contract_number": "Contract number or code",
"f_certificate_number": "Certificate number or code",
"f_date_start": "Contract start date in ISO format",
"f_date_end": "Contract end date in ISO format",
"soggetto_id": supplierSubjectId
},
{
"plant_suppliers_contracts_id": 47,
"f_contract_number": "",
"f_certificate_number": "",
"f_date_start": "2025-05-12",
"f_date_end": "2026-05-12",
"soggetto_id": 1876
},
...
]

'''Search filtering by supplier'''

GET https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id={subjectId}

Example: https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id=1875

Result: Same Json but with 0 or more contracts filtered by the supplier passed in the criteria

'''Contract details'''

GET https://smartbiogas.it/api/v1/suppliercontracts/{supplyContractId}

Example: https://smartbiogas.it/api/v1/suppliercontracts/47

Result: Same Json as above but with a single record and more details
{
"plant_suppliers_contracts_id": 47,
"f_contract_number": "",
"f_certificate_number": "",
"f_date_start": "2025-05-12",
"f_date_end": "2026-05-12",
"soggetto_id": 1876,
"feedstocks": [
{
"substrati_id": productId,
"f_substrati_description": "Multilingual description of the product",
"f_substrati_qta": quantity stipulated in the contract
},
{
"substrati_id": 6,
"f_substrati_description": "{\"it\":\"Mais pianta intera insilato\",\"en\":\"Maize whole plant silage\",\"es\":\"Maize whole plant silage\",\"fr\":\"Maïs plante entière ensilée\"}",
"f_substrati_qta": 2500
},
],
...
}

EN/API/SuppliersContracts

2026-05-07T09:29:31Z

Admin: Created page with "◀ Back to API Menu '''List of supply contracts''' Authentication must be specified in the request header: X-API-TOKEN: {128-character key provided for the specific plant} GET https://smartbiogas.it/api/v1/suppliercontracts Result: Json of the plant's supply contracts [ { "plant_suppliers_contracts_id": supplyContractId, "f_contract_number": "Contract number or code", "f_certificate_number": "Certificate number or code", "f..."

Talk:Substrati/Porosity

2026-05-07T09:29:02Z

Admin: Blanked the page

EN/API/Magazzino

2026-05-07T09:10:25Z

Admin: Admin moved page EN/API/Magazzino to EN/API/Warehouse

#REDIRECT [[EN/API/Warehouse]]

EN/API/Warehouse

2026-05-07T09:10:25Z

Admin: Admin moved page EN/API/Magazzino to EN/API/Warehouse

[[EN/API|◀ Back to API Menu]]

'''List of warehouses (internal and external) of a plant'''

Authentication must be specified in the request header:

X-API-TOKEN: {128-character key provided for the specific plant}

In Smartbiogas, the warehouse is divided into as many units as there are feedstocks (i.e., stored materials) and by origin (Internal or External).

For example:
A plant might have 2 warehouses for Maize:
- one internal for maize coming from the fields of the company owning the plant or its partners.
- one external for maize purchased from external entities.

A plant may have only one (usually internal) if it does not purchase maize from third parties.

This structure is repeated for each feedstock. For example, we might have 1 internal warehouse for slurry, one for manure, one for Maize, and perhaps one external for Wheat.

Warehouse movements are then associated with a specific warehouse. This creates a logical container that groups all movements of a feedstock (internal or external). For each movement, data such as supplier, date/time, quantity, weighing code, vehicle license plate, etc., are saved.

'''Warehouse List'''

List of all warehouses for a plant.

GET https://smartbiogas.it/api/v1/warehouse

Result: Json with an array of results
[
{
"warehouse_id": warehouseId,
"location_id": -1 -> INTERNAL, 1 -> EXTERNAL,
"substrati_id": feedstockId,
"f_json_description": "{\"it\": \"Italian Desc\", \"en\": \"English Desc\", \"fr\": \"French Desc\", \"es\": \"Spanish Desc\"}",
"f_location_description": "Description of the location_id (Internal/External)"
},
{
"warehouse_id": 5332,
"location_id": -1,
"substrati_id": -10,
"f_json_description": "{\"it\": \"Digestato solido\", \"en\": \"Solid digestate\", \"fr\": \"\", \"es\": \"\"}",
"f_location_description": "Internal"
},
...
]

'''Single warehouse details:'''

GET <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}</nowiki>

Example: https://smartbiogas.it/api/v1/warehouse/5869

Result: Same Json as above but with a single record

=== Warehouse movements ===
Once the warehouse is identified, you can manage movements using the following APIs:

GET [https://smartbiogas.it/api/v1/warehouse/3857/movements]

Result: Json with a list of movements
[
{
"movement_id": movementId,
"warehouse_id": warehouseId,
"f_quantity": "Quantity in tons",
"f_movement_datetime": "Date/time in ISO format",
"f_movement_type": See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]]
},
{
"movement_id": 448825,
"warehouse_id": 3857,
"f_quantity": "-9.000",
"f_movement_datetime": "2013-02-01 23:59:59",
"f_movement_type": 11
},
...
]

'''Search single movement by movementId'''

GET <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}/movements/{movementId}</nowiki>

Example: https://smartbiogas.it/api/v1/warehouse/3857/movements/350000

Result: Json with movement details
[
{
"movement_id": movementId,
"warehouse_id": warehouseId,
"f_quantity": "quantity in tons",
"f_movement_datetime": "Date/time in ISO format",
"f_movement_type": See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]],
"f_targa": "Vehicle license plate",
"f_trasportatore": "operator identifier",
"f_disinfezione": 0 -> without disinfection / 1 -> with disinfection,
"f_price": "price in euros per ton",
"f_distance": "trip distance in km",
"f_provenienza": "origin identifier",
"plant_suppliers_contracts_id": contractId (-1 if no contract),
"f_contract_number": Contract number/code (only if contractId <> -1),
"f_partita": "Batch number associated with the movement",
"f_ddt_number": "Waybill (DDT) number",
"f_num_pesata": "Weighing number",
"f_tipo_documento": -1 -> no document, 1 -> Waybill (DDT), 2 -> immediate invoice, 3 -> other
},
{
"movement_id": 350000,
"warehouse_id": 3857,
"f_quantity": "3500.000",
"f_movement_datetime": "2013-01-01 00:00:00",
"f_movement_type": 1,
"f_targa": "",
"f_trasportatore": "",
"f_disinfezione": 0,
"f_price": "0.00",
"f_distance": "0",
"f_provenienza": "",
"plant_suppliers_contracts_id": -1,
"f_contract_number": null,
"f_partita": "",
"f_ddt_number": "",
"f_num_pesata": "",
"f_tipo_documento": -1
}
]

'''Insert warehouse movement'''

POST https://smartbiogas.it/api/v1/warehouse/3857/movements

The call must include the X-API-TOKEN authentication and a JSON formatted as follows:
{
"f_quantity": INT quantity in tons,
"f_movement_datetime": DATETIME "date/time in ISO format",
"f_movement_type": INT See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]],
"soggetto_id": INT subjectId or -1 if supplier/recipient is missing (e.g., internal production or agricultural use),
"f_targa": TEXT "Vehicle license plate",
"f_trasportatore": TEXT "Operator identification",
"f_disinfezione": BIT 0 -> no disinfection, 1 -> disinfection performed,
"f_price" : DECIMAL price per ton in euros,
"f_distance" : INT distance in KM,
"f_provenienza" : TEXT "Origin identifier",
"plant_suppliers_contracts_id" : INT contractId (-1 if not present),
"f_partita" : TEXT "Batch code linked to the movement",
"f_ddt_number": TEXT "Waybill (DDT) number",
"f_num_pesata": INT weighing number,
"f_tipo_documento": -1 -> no document, 1 -> Waybill (DDT), 2 -> Immediate invoice, 3 -> other
}

Example:
{
"f_quantity": 101,
"f_movement_datetime": "2027-01-01 02:58:59",
"f_movement_type": 1,
"soggetto_id": 2278,
"f_targa": "ZZ 999 YY",
"f_trasportatore": "Mario Rossi",
"f_disinfezione": 0,
"f_price" : 0.23,
"f_distance" : 25,
"f_provenienza" : "North Field",
"plant_suppliers_contracts_id" : -1,
"f_partita" : "",
"f_ddt_number": "2027/001",
"f_num_pesata": 123456,
"f_tipo_documento": 1
}

'''Update data of a single movement'''

PATCH <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}/movements/{movementId}</nowiki>

The same JSON used for insertion must be passed; the system will update the data instead of adding a new movement.

Since the movement is linked to a specific warehouse (identified by warehouseId), the feedstock type, warehouse location (internal/external), and the plant itself cannot be changed via this method.

Result of insertion and update: Json with status information:
{
"error_code": see [[EN/API/API Error Codes|API Error Codes]],
"movement_id": movementId (for insertion, returns the new ID; for updates, returns the ID target of the operation),
"message": "Message explaining the outcome or error"
}

Examples:
{
"error_code": 0,
"movement_id": 4578898,
"message": "Movement inserted correctly"
}

{
"error_code": 10,
"movement_id": 4578694,
"message": "Duplicate detected"
}
In this case, an attempt was made to insert the same movement twice.
A movement is unique based on these keys:
- warehouse_id (which identifies the plant, feedstock, and Internal/External status)
- Date/time (to the second)
- Movement Type

If the system detects an existing record with these matching conditions, it returns error 10.

{
"error_code": 11,
"message": "Date not valid: yyyy"
}

EN/API/Warehouse

2026-05-07T09:10:13Z

Admin: Created page with "◀ Back to API Menu '''List of warehouses (internal and external) of a plant''' Authentication must be specified in the request header: X-API-TOKEN: {128-character key provided for the specific plant} In Smartbiogas, the warehouse is divided into as many units as there are feedstocks (i.e., stored materials) and by origin (Internal or External). For example: A plant might have 2 warehouses for Maize: - one internal for maize coming from t..."

[[EN/API|◀ Back to API Menu]]

'''List of warehouses (internal and external) of a plant'''

Authentication must be specified in the request header:

X-API-TOKEN: {128-character key provided for the specific plant}

In Smartbiogas, the warehouse is divided into as many units as there are feedstocks (i.e., stored materials) and by origin (Internal or External).

For example:
A plant might have 2 warehouses for Maize:
- one internal for maize coming from the fields of the company owning the plant or its partners.
- one external for maize purchased from external entities.

A plant may have only one (usually internal) if it does not purchase maize from third parties.

This structure is repeated for each feedstock. For example, we might have 1 internal warehouse for slurry, one for manure, one for Maize, and perhaps one external for Wheat.

Warehouse movements are then associated with a specific warehouse. This creates a logical container that groups all movements of a feedstock (internal or external). For each movement, data such as supplier, date/time, quantity, weighing code, vehicle license plate, etc., are saved.

'''Warehouse List'''

List of all warehouses for a plant.

GET https://smartbiogas.it/api/v1/warehouse

Result: Json with an array of results
[
{
"warehouse_id": warehouseId,
"location_id": -1 -> INTERNAL, 1 -> EXTERNAL,
"substrati_id": feedstockId,
"f_json_description": "{\"it\": \"Italian Desc\", \"en\": \"English Desc\", \"fr\": \"French Desc\", \"es\": \"Spanish Desc\"}",
"f_location_description": "Description of the location_id (Internal/External)"
},
{
"warehouse_id": 5332,
"location_id": -1,
"substrati_id": -10,
"f_json_description": "{\"it\": \"Digestato solido\", \"en\": \"Solid digestate\", \"fr\": \"\", \"es\": \"\"}",
"f_location_description": "Internal"
},
...
]

'''Single warehouse details:'''

GET <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}</nowiki>

Example: https://smartbiogas.it/api/v1/warehouse/5869

Result: Same Json as above but with a single record

=== Warehouse movements ===
Once the warehouse is identified, you can manage movements using the following APIs:

GET [https://smartbiogas.it/api/v1/warehouse/3857/movements]

Result: Json with a list of movements
[
{
"movement_id": movementId,
"warehouse_id": warehouseId,
"f_quantity": "Quantity in tons",
"f_movement_datetime": "Date/time in ISO format",
"f_movement_type": See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]]
},
{
"movement_id": 448825,
"warehouse_id": 3857,
"f_quantity": "-9.000",
"f_movement_datetime": "2013-02-01 23:59:59",
"f_movement_type": 11
},
...
]

'''Search single movement by movementId'''

GET <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}/movements/{movementId}</nowiki>

Example: https://smartbiogas.it/api/v1/warehouse/3857/movements/350000

Result: Json with movement details
[
{
"movement_id": movementId,
"warehouse_id": warehouseId,
"f_quantity": "quantity in tons",
"f_movement_datetime": "Date/time in ISO format",
"f_movement_type": See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]],
"f_targa": "Vehicle license plate",
"f_trasportatore": "operator identifier",
"f_disinfezione": 0 -> without disinfection / 1 -> with disinfection,
"f_price": "price in euros per ton",
"f_distance": "trip distance in km",
"f_provenienza": "origin identifier",
"plant_suppliers_contracts_id": contractId (-1 if no contract),
"f_contract_number": Contract number/code (only if contractId <> -1),
"f_partita": "Batch number associated with the movement",
"f_ddt_number": "Waybill (DDT) number",
"f_num_pesata": "Weighing number",
"f_tipo_documento": -1 -> no document, 1 -> Waybill (DDT), 2 -> immediate invoice, 3 -> other
},
{
"movement_id": 350000,
"warehouse_id": 3857,
"f_quantity": "3500.000",
"f_movement_datetime": "2013-01-01 00:00:00",
"f_movement_type": 1,
"f_targa": "",
"f_trasportatore": "",
"f_disinfezione": 0,
"f_price": "0.00",
"f_distance": "0",
"f_provenienza": "",
"plant_suppliers_contracts_id": -1,
"f_contract_number": null,
"f_partita": "",
"f_ddt_number": "",
"f_num_pesata": "",
"f_tipo_documento": -1
}
]

'''Insert warehouse movement'''

POST https://smartbiogas.it/api/v1/warehouse/3857/movements

The call must include the X-API-TOKEN authentication and a JSON formatted as follows:
{
"f_quantity": INT quantity in tons,
"f_movement_datetime": DATETIME "date/time in ISO format",
"f_movement_type": INT See [[EN/API/Warehouse Movement Types|Warehouse Movement Types]],
"soggetto_id": INT subjectId or -1 if supplier/recipient is missing (e.g., internal production or agricultural use),
"f_targa": TEXT "Vehicle license plate",
"f_trasportatore": TEXT "Operator identification",
"f_disinfezione": BIT 0 -> no disinfection, 1 -> disinfection performed,
"f_price" : DECIMAL price per ton in euros,
"f_distance" : INT distance in KM,
"f_provenienza" : TEXT "Origin identifier",
"plant_suppliers_contracts_id" : INT contractId (-1 if not present),
"f_partita" : TEXT "Batch code linked to the movement",
"f_ddt_number": TEXT "Waybill (DDT) number",
"f_num_pesata": INT weighing number,
"f_tipo_documento": -1 -> no document, 1 -> Waybill (DDT), 2 -> Immediate invoice, 3 -> other
}

Example:
{
"f_quantity": 101,
"f_movement_datetime": "2027-01-01 02:58:59",
"f_movement_type": 1,
"soggetto_id": 2278,
"f_targa": "ZZ 999 YY",
"f_trasportatore": "Mario Rossi",
"f_disinfezione": 0,
"f_price" : 0.23,
"f_distance" : 25,
"f_provenienza" : "North Field",
"plant_suppliers_contracts_id" : -1,
"f_partita" : "",
"f_ddt_number": "2027/001",
"f_num_pesata": 123456,
"f_tipo_documento": 1
}

'''Update data of a single movement'''

PATCH <nowiki>https://smartbiogas.it/api/v1/warehouse/{warehouseId}/movements/{movementId}</nowiki>

The same JSON used for insertion must be passed; the system will update the data instead of adding a new movement.

Since the movement is linked to a specific warehouse (identified by warehouseId), the feedstock type, warehouse location (internal/external), and the plant itself cannot be changed via this method.

Result of insertion and update: Json with status information:
{
"error_code": see [[EN/API/API Error Codes|API Error Codes]],
"movement_id": movementId (for insertion, returns the new ID; for updates, returns the ID target of the operation),
"message": "Message explaining the outcome or error"
}

Examples:
{
"error_code": 0,
"movement_id": 4578898,
"message": "Movement inserted correctly"
}

{
"error_code": 10,
"movement_id": 4578694,
"message": "Duplicate detected"
}
In this case, an attempt was made to insert the same movement twice.
A movement is unique based on these keys:
- warehouse_id (which identifies the plant, feedstock, and Internal/External status)
- Date/time (to the second)
- Movement Type

If the system detects an existing record with these matching conditions, it returns error 10.

{
"error_code": 11,
"message": "Date not valid: yyyy"
}

EN/API/PlantsList

2026-05-07T09:08:53Z

Admin:

[[EN/API|◀ Back to API Menu]]

'''Plant list'''

This API is restricted, and a request must be made to gain access. It is intended for data providers managing multiple plants, such as analytical laboratories.

GET https://smartbiogas.it/api/v1/plants

Result: Json with an array of results
[
{
"plant_cod": CHAR(4) "Plant code",
"plant_name": TEXT "Plant description",
"eu_countries_id": countryId,
"eu_cities_id": cityId,
"f_plant_address": TEXT "Physical address",
"f_api_token": TEXT "API access token",
"f_regione_sociale": TEXT "Company name of the plant owner",
"f_vat": TEXT "VAT number"
},
{
"plant_cod": "XX01",
"plant_name": "Test Plant",
"eu_countries_id": 19,
"eu_cities_id": 63804,
"f_plant_address": "Via roma 1, 10100 torino",
"f_api_token": "sdunai3ughncfi7tb3....",
"f_regione_sociale": "Consorzio Monviso Energia",
"f_vat": "10178660014"
},
...
]

EN/API/Elenco Impianti

2026-05-07T09:08:29Z

Admin: Admin moved page EN/API/Elenco Impianti to EN/API/PlantsList

#REDIRECT [[EN/API/PlantsList]]

EN/API/PlantsList

2026-05-07T09:08:29Z

Admin: Admin moved page EN/API/Elenco Impianti to EN/API/PlantsList

[https://wiki.monvisoenergia.it/index.php?title=EN/API ◀ Back to API Menu]

'''Plant list'''

This API is restricted, and a request must be made to gain access. It is intended for data providers managing multiple plants, such as analytical laboratories.

GET https://smartbiogas.it/api/v1/plants

Result: Json with an array of results
[
{
"plant_cod": CHAR(4) "Plant code",
"plant_name": TEXT "Plant description",
"eu_countries_id": countryId,
"eu_cities_id": cityId,
"f_plant_address": TEXT "Physical address",
"f_api_token": TEXT "API access token",
"f_regione_sociale": TEXT "Company name of the plant owner",
"f_vat": TEXT "VAT number"
},
{
"plant_cod": "XX01",
"plant_name": "Test Plant",
"eu_countries_id": 19,
"eu_cities_id": 63804,
"f_plant_address": "Via roma 1, 10100 torino",
"f_api_token": "sdunai3ughncfi7tb3....",
"f_regione_sociale": "Consorzio Monviso Energia",
"f_vat": "10178660014"
},
...
]