VRt.Agro [AG] (7.10.2580)

Veeroute Support Team: servicedesk@veeroute.com License: Proprietary

Veeroute Agro API.

Veeroute company website

Description

The service is designed to calculate the work plan of production facilities.

Objects overview

objects

Field

produces a certain crop of a certain moisture content
products from the field can only be moved to the Elevator or Factory

Elevator

consists of Gates, Dryers, short-term and long-term storage areas
dries the grain (if the moisture content of the crop is more than acceptable)
stores dry grain in short-term storage places (warehouses), while unloading and loading grain is allowed within one day
stores dry grain in long-term storage places (sleeves, trenches, mounds)
when stored in one storage, only one type of culture can be located
sells surplus grain to the Market
production processes inside the facility: drying, loading / unloading to a storage location, storage

Factory

consists of Gates, Dryers, Bunkers, Consumers
[if drying is present] dries the grain (if the moisture content of the crop is more than allowed)
stores dry grain in Bunkers (short-term storage tied to a specific crop)
maintains a minimum supply of grain for consumption in the Bunkers
Consumes grain from Bunkers
buys the missing grain from the Market
production processes inside the facility: drying, loading / unloading to a storage location, storage, consumption

Market

buys grain from elevators
sells grain to factories

Project

The project reflects the planned sequence of operations on agricultural crops, the types of operations are described below.

HARVEST

Crop harvesting:

between production facilities (Field and Elevator or Field)
the operation takes place within one day
on the Field there is a determination of grain moisture

	Object (target_key)	Subobject (target_detail_key)
Source	Field	-
Destination	Elevator or Factory	Gate

DRY

Drying culture:

inside the production facility (Elevator or Field)
duration of the operation - days
during the drying process, the mass and type of humidity changes (WET -> DRY)
the source indicates the mass of raw culture
in the appointment, the resulting mass of dry culture is indicated

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator or Factory	Gate
Destination	Elevator or Factory	Dryer

LOAD

Loading culture from the Gate to the Storage Location (long-term, short-term, silo):

between parts of one production facility (Elevator or Field)
the operation takes place within one day

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator or Factory	Gate or Dryer
Destination	Elevator or Factory	Storage location (long-term, short-term, bunker)

UNLOAD

Unloading the culture from the storage place to the gate:

between parts of one production facility (Elevator)
the operation takes place within one day

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator	Storage location (long-term, short-term, bunker)
Destination	Elevator	Gate

STORE

Culture storage:

the operation takes place within one day
storage location does not change

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator or Factory	Storage location (long-term, short-term, bunker)
Destination	Elevator or Factory	The same storage location

RELOCATE

Transportation between production facilities:

between production facilities (Elevator and Field)
the operation takes place within one day

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator	Gate
Destination	Factory	Gate

CONSUMPTION

Field crop consumption:

between parts of one production facility (Field)
the operation takes place within one day
consumption comes from the Bunker
in addition, we can consume directly from the Gate or Dryer without laying in the Bunker

	Object (target_key)	Subobject (target_detail_key)
Source	Factory	Hopper or Gate or Dryer
Destination	Factory	Consumer

SELL

Sale of culture:

between production facilities (Elevator and Market)
the operation takes place within one day

	Object (target_key)	Subobject (target_detail_key)
Source	Elevator	Gate
Destination	Market	Contract

BUY

Buying culture:

between production facilities (Market and Factory)
the operation takes place within one day

	Object (target_key)	Subobject (target_detail_key)
Source	Market	Contract
Destination	Factory	Gate

Entity relationship diagram

erd

Plan

Production plan calculation.

Planning (SYNC)

Production plan calculation.

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

Data for calculation.

required	Array of objects (crop) [ 1 .. 501 ] items unique List of crops.
required	Array of objects (field) [ 1 .. 20001 ] items unique List of fields.
	Array of objects (elevator) [ 1 .. 501 ] items unique List of elevators.
required	Array of objects (factory) [ 1 .. 501 ] items unique List of factories.
required	Array of objects (market) [ 1 .. 501 ] items unique List of markets.
required	Array of objects (movement_matrix) [ 1 .. 8040402 ] items unique Matrix describing the cost (in kilometers and monetary units) of moving grain between objects (in both directions). If there is no corresponding entry in the matrix between the objects, the movement of grain between them is considered impossible.
	Array of objects (leftover) [ 0 .. 25001 ] items List of leftovers.
required	object (plan_settings) Plan settings.
dataset_name	string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" The name of the dataset. A technical field that does not affect calculation.

Responses

Response Schema: application/json

required	object (tracedata) Data for request tracing.
required	Array of objects (project) [ 0 .. 1000001 ] items Production plan. The sequence of work.
required	object (plan_statistics) General statistics.
	Array of objects (entity_warning_list) [ 0 .. 100001 ] items List of warnings. Depending on the flag `calculation_settings.treat_warnings_as_errors` - triggered checks are interpreted as errors or result in the removal of incorrect data from the calculation.
	object (unplanned_items) Unplanned items list.
calculation_progress required	integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Calculation progress as a percentage. The progress displays the current number of completed steps.
required	object (calculation_info) Calculation information.

Request samples

Payload
Python

Content type

application/json

{"crops": [{"key": "bean",
"base_humidity": 180,
"compatible_storage_types": ["granary"
],
"compatible_silo_types": [ ],
"attributes": [{"key": "full_name",
"value": "Бобы сои"
}
]
}
],
"fields": [{"key": "field_1",
"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 1000
}
],
"humidity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-03"
},
"humidity": 220
},
{"date_window": {"from": "2024-01-04",
"to": "2024-01-05"
},
"humidity": 170
}
],
"amount": 5000,
"attributes": [{"key": "full_number",
"value": "57-4-6-130-227"
}
]
}
],
"elevators": [{"key": "elevator_1",
"gate": {"key": "gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
],
"output_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
]
},
"dryers": [{"key": "dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 15000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 5000
}
]
}
]
}
],
"storages": [{"key": "storage_1",
"type": "granary",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 5000
},
{"date_window": {"from": "2024-01-06",
"to": "2024-01-10"
},
"capacity": 4100
}
]
}
],
"silos": [{"key": "silo_1",
"type": "trench",
"deployment_cost": 1888,
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-07-15"
},
"capacity": 50000
}
]
}
],
"attributes": [ ]
}
],
"factories": [{"key": "factory_1",
"gate": {"key": "factory_gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 2000
}
],
"output_capacity_forecast": [ ]
},
"dryers": [{"key": "factory_dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 17000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 2700
}
]
}
]
}
],
"bunkers": [{"key": "bunker_1",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 5000
}
]
}
],
"consumers": [{"key": "factory_line_1",
"crop_key": "bean",
"consumption_forecast": [{"date_window": {"from": "2024-01-05",
"to": "2024-01-11"
},
"capacity": 500
},
{"date_window": {"from": "2024-01-12",
"to": "2024-01-15"
},
"capacity": 20
}
],
"stock_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-12"
},
"min_stock_days": 2
}
]
}
],
"attributes": [ ]
}
],
"markets": [{"key": "market_1",
"contracts": [{"key": "contract_1",
"type": "BUY",
"target_keys": ["elevator_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 280
}
]
}
]
},
{"key": "contract_2",
"type": "SELL",
"target_keys": ["factory_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 320
}
]
}
]
}
],
"attributes": [ ]
}
],
"movement_matrix": [{"source_key": "field_1",
"destination_key": "factory_1",
"distance": 100,
"cost_per_transport": 5000
},
{"source_key": "field_1",
"destination_key": "elevator_1",
"distance": 70,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "factory_1",
"distance": 40,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
},
{"source_key": "factory_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
}
],
"leftovers": [{"crop_key": "bean",
"humidity": 50,
"target_key": "field_1",
"target_detail_key": null,
"amount": 4990
}
],
"plan_settings": {"project_settings": {"configuration": "OPTIMIZE_DISTANCE",
"start_date": "2024-01-01",
"end_date": "2024-01-15",
"transport_capacity": 23
},
"calculation_settings": {"result_ttl": "PT20M",
"treat_warnings_as_errors": false
}
}
}

Response samples

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "example_username",
"company": "example_company",
"env": "edge7",
"pod": "aaaaaaaa-2222-cccc-4444-eeeeeeeeeeee",
"service": "AGRO",
"operation": "run_plan_calculation",
"time": "2024-11-21T16:55:35.370332Z"
},
"project": [{"type": "RELOCATE",
"crop_key": "bean",
"source": {"date": "2024-11-15",
"target_key": "field_1",
"target_type": "FIELD",
"crop_type": "DRY",
"mass": 100,
"humidity": 15
},
"destination": {"date": "2024-11-15",
"target_key": "factory_1",
"target_type": "FACTORY",
"crop_type": "DRY",
"mass": 100,
"humidity": 15
},
"measurements": {"distance": 50,
"cost": 4500
}
}
],
"statistics": {"days_count": 1,
"crops_count": 1,
"fields_count": 1,
"fields_part_count": 0,
"elevators_count": 1,
"factory_count": 1,
"markets_count": 1,
"total_distance": 1888,
"total_cost": 100.1,
"unplanned_crops_count": 0,
"unplanned_fields_count": 0,
"unplanned_elevators_count": 0,
"unplanned_factories_count": 0,
"unplanned_markets_count": 0
},
"calculation_progress": 100,
"calculation_info": {"status": "FINISHED_IN_TIME",
"result_version": 142,
"preparing_time": "PT1M10S",
"business_validation_time": "PT1M10S",
"math_validation_time": "PT1M10S",
"waiting_time": "PT15S",
"calculation_time": "PT1M10S"
},
"warnings": [ ]
}

Planning (ASYNC)

The result can be obtained using the result method, removing - with delete.

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

Data for calculation.

required	Array of objects (crop) [ 1 .. 501 ] items unique List of crops.
required	Array of objects (field) [ 1 .. 20001 ] items unique List of fields.
	Array of objects (elevator) [ 1 .. 501 ] items unique List of elevators.
required	Array of objects (factory) [ 1 .. 501 ] items unique List of factories.
required	Array of objects (market) [ 1 .. 501 ] items unique List of markets.
required	Array of objects (movement_matrix) [ 1 .. 8040402 ] items unique Matrix describing the cost (in kilometers and monetary units) of moving grain between objects (in both directions). If there is no corresponding entry in the matrix between the objects, the movement of grain between them is considered impossible.
	Array of objects (leftover) [ 0 .. 25001 ] items List of leftovers.
required	object (plan_settings) Plan settings.
dataset_name	string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" The name of the dataset. A technical field that does not affect calculation.

Responses

Response Schema: application/json

required	object (tracedata) Data for request tracing.
process_code required	string <uuid> (process_code) Example: "11111111-2222-3333-4444-555555555555" Process code - calculation identifier.

Request samples

Payload

Content type

application/json

{"crops": [{"key": "bean",
"base_humidity": 180,
"compatible_storage_types": ["granary"
],
"compatible_silo_types": [ ],
"attributes": [{"key": "full_name",
"value": "Бобы сои"
}
]
}
],
"fields": [{"key": "field_1",
"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 1000
}
],
"humidity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-03"
},
"humidity": 220
},
{"date_window": {"from": "2024-01-04",
"to": "2024-01-05"
},
"humidity": 170
}
],
"amount": 5000,
"attributes": [{"key": "full_number",
"value": "57-4-6-130-227"
}
]
}
],
"elevators": [{"key": "elevator_1",
"gate": {"key": "gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
],
"output_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
]
},
"dryers": [{"key": "dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 15000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 5000
}
]
}
]
}
],
"storages": [{"key": "storage_1",
"type": "granary",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 5000
},
{"date_window": {"from": "2024-01-06",
"to": "2024-01-10"
},
"capacity": 4100
}
]
}
],
"silos": [{"key": "silo_1",
"type": "trench",
"deployment_cost": 1888,
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-07-15"
},
"capacity": 50000
}
]
}
],
"attributes": [ ]
}
],
"factories": [{"key": "factory_1",
"gate": {"key": "factory_gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 2000
}
],
"output_capacity_forecast": [ ]
},
"dryers": [{"key": "factory_dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 17000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 2700
}
]
}
]
}
],
"bunkers": [{"key": "bunker_1",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 5000
}
]
}
],
"consumers": [{"key": "factory_line_1",
"crop_key": "bean",
"consumption_forecast": [{"date_window": {"from": "2024-01-05",
"to": "2024-01-11"
},
"capacity": 500
},
{"date_window": {"from": "2024-01-12",
"to": "2024-01-15"
},
"capacity": 20
}
],
"stock_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-12"
},
"min_stock_days": 2
}
]
}
],
"attributes": [ ]
}
],
"markets": [{"key": "market_1",
"contracts": [{"key": "contract_1",
"type": "BUY",
"target_keys": ["elevator_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 280
}
]
}
]
},
{"key": "contract_2",
"type": "SELL",
"target_keys": ["factory_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 320
}
]
}
]
}
],
"attributes": [ ]
}
],
"movement_matrix": [{"source_key": "field_1",
"destination_key": "factory_1",
"distance": 100,
"cost_per_transport": 5000
},
{"source_key": "field_1",
"destination_key": "elevator_1",
"distance": 70,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "factory_1",
"distance": 40,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
},
{"source_key": "factory_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
}
],
"leftovers": [{"crop_key": "bean",
"humidity": 50,
"target_key": "field_1",
"target_detail_key": null,
"amount": 4990
}
],
"plan_settings": {"project_settings": {"configuration": "OPTIMIZE_DISTANCE",
"start_date": "2024-01-01",
"end_date": "2024-01-15",
"transport_capacity": 23
},
"calculation_settings": {"result_ttl": "PT20M",
"treat_warnings_as_errors": false
}
}
}

Response samples

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "username_for_login",
"company": "smart_company",
"service": "UNIVERSAL",
"operation": "run_plan_calculation",
"env": "edge7",
"pod": "11111111-2222-3333-4444-555555555555",
"time": "2024-11-21T09:30:00+03:00"
},
"process_code": "11111111-2222-3333-4444-555555555555"
}

Cancel calculation

Cancel calculation process by the calculation identifier.

Authorizations:

ApiKeyAuth

path Parameters

process_code

required

string <uuid> (process_code)

Example: 11111111-2222-3333-4444-555555555555

Unique process identifier.

Responses

Response samples

400
402
404
429
500

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "example_username",
"company": "example_company",
"env": "edge7",
"pod": "aaaaaaaa-2222-cccc-4444-eeeeeeeeeeee",
"service": "AGRO",
"operation": "run_plan_calculation",
"time": "2024-11-21T09:30:00+03:00"
},
"message": "bad task data",
"schema_errors": [ ],
"logical_errors": [ ],
"warnings": [ ]
}

Calculation state

Read calculation state by the calculation identifier.

Authorizations:

ApiKeyAuth

path Parameters

process_code

required

string <uuid> (process_code)

Example: 11111111-2222-3333-4444-555555555555

Unique process identifier.

Responses

Response Schema: application/json

required	object (tracedata) Data for request tracing.
calculation_progress required	integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Calculation progress as a percentage. The progress displays the current number of completed steps.
required	object (calculation_info) Calculation information.

Response Schema: application/json

required	object (tracedata) Data for request tracing.
calculation_progress required	integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Calculation progress as a percentage. The progress displays the current number of completed steps.
required	object (calculation_info) Calculation information.

Response samples

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "username_for_login",
"company": "smart_company",
"service": "UNIVERSAL",
"operation": "run_plan_calculation",
"env": "edge7",
"pod": "11111111-2222-3333-4444-555555555555",
"time": "2024-11-21T09:30:00+03:00"
},
"calculation_progress": 52,
"calculation_info": {"status": "FINISHED_IN_TIME",
"result_version": 133,
"preparing_time": "PT1H45M",
"business_validation_time": "PT1H45M",
"math_validation_time": "PT1H45M",
"waiting_time": "PT1H45M",
"calculation_time": "PT1H45M"
}
}

Getting the result

Getting the result based on the calculation identifier.

Authorizations:

ApiKeyAuth

path Parameters

process_code

required

string <uuid> (process_code)

Example: 11111111-2222-3333-4444-555555555555

Unique process identifier.

Responses

Response Schema: application/json

required	object (tracedata) Data for request tracing.
required	Array of objects (project) [ 0 .. 1000001 ] items Production plan. The sequence of work.
required	object (plan_statistics) General statistics.
	Array of objects (entity_warning_list) [ 0 .. 100001 ] items List of warnings. Depending on the flag `calculation_settings.treat_warnings_as_errors` - triggered checks are interpreted as errors or result in the removal of incorrect data from the calculation.
	object (unplanned_items) Unplanned items list.
calculation_progress required	integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Calculation progress as a percentage. The progress displays the current number of completed steps.
required	object (calculation_info) Calculation information.

Response Schema: application/json

required	object (tracedata) Data for request tracing.
required	Array of objects (project) [ 0 .. 1000001 ] items Production plan. The sequence of work.
required	object (plan_statistics) General statistics.
	Array of objects (entity_warning_list) [ 0 .. 100001 ] items List of warnings. Depending on the flag `calculation_settings.treat_warnings_as_errors` - triggered checks are interpreted as errors or result in the removal of incorrect data from the calculation.
	object (unplanned_items) Unplanned items list.
calculation_progress required	integer <int32> (calculation_progress) [ 0 .. 100 ] Example: "52" Calculation progress as a percentage. The progress displays the current number of completed steps.
required	object (calculation_info) Calculation information.

Response samples

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "example_username",
"company": "example_company",
"env": "edge7",
"pod": "aaaaaaaa-2222-cccc-4444-eeeeeeeeeeee",
"service": "AGRO",
"operation": "run_plan_calculation",
"time": "2024-11-21T16:55:35.370332Z"
},
"project": [{"type": "RELOCATE",
"crop_key": "bean",
"source": {"date": "2024-11-15",
"target_key": "field_1",
"target_type": "FIELD",
"crop_type": "DRY",
"mass": 100,
"humidity": 15
},
"destination": {"date": "2024-11-15",
"target_key": "factory_1",
"target_type": "FACTORY",
"crop_type": "DRY",
"mass": 100,
"humidity": 15
},
"measurements": {"distance": 50,
"cost": 4500
}
}
],
"statistics": {"days_count": 1,
"crops_count": 1,
"fields_count": 1,
"fields_part_count": 0,
"elevators_count": 1,
"factory_count": 1,
"markets_count": 1,
"total_distance": 1888,
"total_cost": 100.1,
"unplanned_crops_count": 0,
"unplanned_fields_count": 0,
"unplanned_elevators_count": 0,
"unplanned_factories_count": 0,
"unplanned_markets_count": 0
},
"calculation_progress": 100,
"calculation_info": {"status": "FINISHED_IN_TIME",
"result_version": 142,
"preparing_time": "PT1M10S",
"business_validation_time": "PT1M10S",
"math_validation_time": "PT1M10S",
"waiting_time": "PT15S",
"calculation_time": "PT1M10S"
},
"warnings": [ ]
}

Result removal

Removal of the planning result by the calculation identifier.

Authorizations:

ApiKeyAuth

path Parameters

process_code

required

string <uuid> (process_code)

Example: 11111111-2222-3333-4444-555555555555

Unique process identifier.

Responses

Response samples

400
402
404
429
500

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "example_username",
"company": "example_company",
"env": "edge7",
"pod": "aaaaaaaa-2222-cccc-4444-eeeeeeeeeeee",
"service": "AGRO",
"operation": "run_plan_calculation",
"time": "2024-11-21T09:30:00+03:00"
},
"message": "bad task data",
"schema_errors": [ ],
"logical_errors": [ ],
"warnings": [ ]
}

Data validation

Checking data before planning.

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

Data for calculation.

required	Array of objects (crop) [ 1 .. 501 ] items unique List of crops.
required	Array of objects (field) [ 1 .. 20001 ] items unique List of fields.
	Array of objects (elevator) [ 1 .. 501 ] items unique List of elevators.
required	Array of objects (factory) [ 1 .. 501 ] items unique List of factories.
required	Array of objects (market) [ 1 .. 501 ] items unique List of markets.
required	Array of objects (movement_matrix) [ 1 .. 8040402 ] items unique Matrix describing the cost (in kilometers and monetary units) of moving grain between objects (in both directions). If there is no corresponding entry in the matrix between the objects, the movement of grain between them is considered impossible.
	Array of objects (leftover) [ 0 .. 25001 ] items List of leftovers.
required	object (plan_settings) Plan settings.
dataset_name	string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" The name of the dataset. A technical field that does not affect calculation.

Responses

Response Schema: application/json

required	object (tracedata) Data for request tracing.
required	Array of objects (entity_warning_list) [ 0 .. 100001 ] items List of warnings. Depending on the flag `calculation_settings.treat_warnings_as_errors` - triggered checks are interpreted as errors or result in the removal of incorrect data from the calculation.

Request samples

Payload

Content type

application/json

{"crops": [{"key": "bean",
"base_humidity": 180,
"compatible_storage_types": ["granary"
],
"compatible_silo_types": [ ],
"attributes": [{"key": "full_name",
"value": "Бобы сои"
}
]
}
],
"fields": [{"key": "field_1",
"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 1000
}
],
"humidity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-03"
},
"humidity": 220
},
{"date_window": {"from": "2024-01-04",
"to": "2024-01-05"
},
"humidity": 170
}
],
"amount": 5000,
"attributes": [{"key": "full_number",
"value": "57-4-6-130-227"
}
]
}
],
"elevators": [{"key": "elevator_1",
"gate": {"key": "gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
],
"output_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
]
},
"dryers": [{"key": "dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 15000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 5000
}
]
}
]
}
],
"storages": [{"key": "storage_1",
"type": "granary",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 5000
},
{"date_window": {"from": "2024-01-06",
"to": "2024-01-10"
},
"capacity": 4100
}
]
}
],
"silos": [{"key": "silo_1",
"type": "trench",
"deployment_cost": 1888,
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-07-15"
},
"capacity": 50000
}
]
}
],
"attributes": [ ]
}
],
"factories": [{"key": "factory_1",
"gate": {"key": "factory_gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 2000
}
],
"output_capacity_forecast": [ ]
},
"dryers": [{"key": "factory_dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 17000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 2700
}
]
}
]
}
],
"bunkers": [{"key": "bunker_1",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 5000
}
]
}
],
"consumers": [{"key": "factory_line_1",
"crop_key": "bean",
"consumption_forecast": [{"date_window": {"from": "2024-01-05",
"to": "2024-01-11"
},
"capacity": 500
},
{"date_window": {"from": "2024-01-12",
"to": "2024-01-15"
},
"capacity": 20
}
],
"stock_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-12"
},
"min_stock_days": 2
}
]
}
],
"attributes": [ ]
}
],
"markets": [{"key": "market_1",
"contracts": [{"key": "contract_1",
"type": "BUY",
"target_keys": ["elevator_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 280
}
]
}
]
},
{"key": "contract_2",
"type": "SELL",
"target_keys": ["factory_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 320
}
]
}
]
}
],
"attributes": [ ]
}
],
"movement_matrix": [{"source_key": "field_1",
"destination_key": "factory_1",
"distance": 100,
"cost_per_transport": 5000
},
{"source_key": "field_1",
"destination_key": "elevator_1",
"distance": 70,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "factory_1",
"distance": 40,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
},
{"source_key": "factory_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
}
],
"leftovers": [{"crop_key": "bean",
"humidity": 50,
"target_key": "field_1",
"target_detail_key": null,
"amount": 4990
}
],
"plan_settings": {"project_settings": {"configuration": "OPTIMIZE_DISTANCE",
"start_date": "2024-01-01",
"end_date": "2024-01-15",
"transport_capacity": 23
},
"calculation_settings": {"result_ttl": "PT20M",
"treat_warnings_as_errors": false
}
}
}

Response samples

Content type

application/json

{"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "username_for_login",
"company": "smart_company",
"service": "UNIVERSAL",
"operation": "run_plan_calculation",
"env": "edge7",
"pod": "11111111-2222-3333-4444-555555555555",
"time": "2024-11-21T09:30:00+03:00"
},
"warnings": [{"type": "NO_COMPATIBLE_STORAGE",
"info": "entity warning",
"entities": [{"entity_key": "order_0001",
"entity_type": "TASK",
"child_entity": { }
}
]
}
]
}

Clipping (SYNC)

Data clipping.

Authorizations:

ApiKeyAuth

path Parameters

clip_key

required

string [ 1 .. 1024 ] characters

Example: crop_key_1

Target essence key.

query Parameters

clip_strategy

string (clip_strategy)

Example: clip_strategy=CROP_WITH_TRANSIT_ELEVATORS

Data clipping strategy.

Request Body schema: application/json
required

Data for clipping.

required	Array of objects (crop) [ 1 .. 501 ] items unique List of crops.
required	Array of objects (field) [ 1 .. 20001 ] items unique List of fields.
	Array of objects (elevator) [ 1 .. 501 ] items unique List of elevators.
required	Array of objects (factory) [ 1 .. 501 ] items unique List of factories.
required	Array of objects (market) [ 1 .. 501 ] items unique List of markets.
required	Array of objects (movement_matrix) [ 1 .. 8040402 ] items unique Matrix describing the cost (in kilometers and monetary units) of moving grain between objects (in both directions). If there is no corresponding entry in the matrix between the objects, the movement of grain between them is considered impossible.
	Array of objects (leftover) [ 0 .. 25001 ] items List of leftovers.
required	object (plan_settings) Plan settings.
dataset_name	string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" The name of the dataset. A technical field that does not affect calculation.

Responses

Response Schema: application/json

required	Array of objects (crop) [ 1 .. 501 ] items unique List of crops.
required	Array of objects (field) [ 1 .. 20001 ] items unique List of fields.
	Array of objects (elevator) [ 1 .. 501 ] items unique List of elevators.
required	Array of objects (factory) [ 1 .. 501 ] items unique List of factories.
required	Array of objects (market) [ 1 .. 501 ] items unique List of markets.
required	Array of objects (movement_matrix) [ 1 .. 8040402 ] items unique Matrix describing the cost (in kilometers and monetary units) of moving grain between objects (in both directions). If there is no corresponding entry in the matrix between the objects, the movement of grain between them is considered impossible.
	Array of objects (leftover) [ 0 .. 25001 ] items List of leftovers.
required	object (plan_settings) Plan settings.
dataset_name	string (dataset_name) [ 0 .. 512 ] characters Example: "custom_dataset_one" The name of the dataset. A technical field that does not affect calculation.

Request samples

Payload

Content type

application/json

{"crops": [{"key": "bean",
"base_humidity": 180,
"compatible_storage_types": ["granary"
],
"compatible_silo_types": [ ],
"attributes": [{"key": "full_name",
"value": "Бобы сои"
}
]
}
],
"fields": [{"key": "field_1",
"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 1000
}
],
"humidity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-03"
},
"humidity": 220
},
{"date_window": {"from": "2024-01-04",
"to": "2024-01-05"
},
"humidity": 170
}
],
"amount": 5000,
"attributes": [{"key": "full_number",
"value": "57-4-6-130-227"
}
]
}
],
"elevators": [{"key": "elevator_1",
"gate": {"key": "gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
],
"output_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
]
},
"dryers": [{"key": "dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 15000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 5000
}
]
}
]
}
],
"storages": [{"key": "storage_1",
"type": "granary",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 5000
},
{"date_window": {"from": "2024-01-06",
"to": "2024-01-10"
},
"capacity": 4100
}
]
}
],
"silos": [{"key": "silo_1",
"type": "trench",
"deployment_cost": 1888,
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-07-15"
},
"capacity": 50000
}
]
}
],
"attributes": [ ]
}
],
"factories": [{"key": "factory_1",
"gate": {"key": "factory_gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 2000
}
],
"output_capacity_forecast": [ ]
},
"dryers": [{"key": "factory_dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 17000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 2700
}
]
}
]
}
],
"bunkers": [{"key": "bunker_1",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 5000
}
]
}
],
"consumers": [{"key": "factory_line_1",
"crop_key": "bean",
"consumption_forecast": [{"date_window": {"from": "2024-01-05",
"to": "2024-01-11"
},
"capacity": 500
},
{"date_window": {"from": "2024-01-12",
"to": "2024-01-15"
},
"capacity": 20
}
],
"stock_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-12"
},
"min_stock_days": 2
}
]
}
],
"attributes": [ ]
}
],
"markets": [{"key": "market_1",
"contracts": [{"key": "contract_1",
"type": "BUY",
"target_keys": ["elevator_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 280
}
]
}
]
},
{"key": "contract_2",
"type": "SELL",
"target_keys": ["factory_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 320
}
]
}
]
}
],
"attributes": [ ]
}
],
"movement_matrix": [{"source_key": "field_1",
"destination_key": "factory_1",
"distance": 100,
"cost_per_transport": 5000
},
{"source_key": "field_1",
"destination_key": "elevator_1",
"distance": 70,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "factory_1",
"distance": 40,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
},
{"source_key": "factory_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
}
],
"leftovers": [{"crop_key": "bean",
"humidity": 50,
"target_key": "field_1",
"target_detail_key": null,
"amount": 4990
}
],
"plan_settings": {"project_settings": {"configuration": "OPTIMIZE_DISTANCE",
"start_date": "2024-01-01",
"end_date": "2024-01-15",
"transport_capacity": 23
},
"calculation_settings": {"result_ttl": "PT20M",
"treat_warnings_as_errors": false
}
}
}

Response samples

Content type

application/json

{"crops": [{"key": "bean",
"base_humidity": 180,
"compatible_storage_types": ["granary"
],
"compatible_silo_types": [ ],
"attributes": [{"key": "full_name",
"value": "Бобы сои"
}
]
}
],
"fields": [{"key": "field_1",
"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 1000
}
],
"humidity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-03"
},
"humidity": 220
},
{"date_window": {"from": "2024-01-04",
"to": "2024-01-05"
},
"humidity": 170
}
],
"amount": 5000,
"attributes": [{"key": "full_number",
"value": "57-4-6-130-227"
}
]
}
],
"elevators": [{"key": "elevator_1",
"gate": {"key": "gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
],
"output_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 100
}
]
},
"dryers": [{"key": "dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 15000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 5000
}
]
}
]
}
],
"storages": [{"key": "storage_1",
"type": "granary",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-05"
},
"capacity": 5000
},
{"date_window": {"from": "2024-01-06",
"to": "2024-01-10"
},
"capacity": 4100
}
]
}
],
"silos": [{"key": "silo_1",
"type": "trench",
"deployment_cost": 1888,
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-07-15"
},
"capacity": 50000
}
]
}
],
"attributes": [ ]
}
],
"factories": [{"key": "factory_1",
"gate": {"key": "factory_gate_1",
"input_capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 2000
}
],
"output_capacity_forecast": [ ]
},
"dryers": [{"key": "factory_dryer_1",
"chamber_variants": [{"crop_key": "bean",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 17000
}
],
"productivity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"productivity": 2700
}
]
}
]
}
],
"bunkers": [{"key": "bunker_1",
"capacity_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-10"
},
"capacity": 5000
}
]
}
],
"consumers": [{"key": "factory_line_1",
"crop_key": "bean",
"consumption_forecast": [{"date_window": {"from": "2024-01-05",
"to": "2024-01-11"
},
"capacity": 500
},
{"date_window": {"from": "2024-01-12",
"to": "2024-01-15"
},
"capacity": 20
}
],
"stock_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-12"
},
"min_stock_days": 2
}
]
}
],
"attributes": [ ]
}
],
"markets": [{"key": "market_1",
"contracts": [{"key": "contract_1",
"type": "BUY",
"target_keys": ["elevator_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 280
}
]
}
]
},
{"key": "contract_2",
"type": "SELL",
"target_keys": ["factory_1"
],
"pricelist": [{"crop_key": "bean",
"price_forecast": [{"date_window": {"from": "2024-01-01",
"to": "2024-01-15"
},
"price": 320
}
]
}
]
}
],
"attributes": [ ]
}
],
"movement_matrix": [{"source_key": "field_1",
"destination_key": "factory_1",
"distance": 100,
"cost_per_transport": 5000
},
{"source_key": "field_1",
"destination_key": "elevator_1",
"distance": 70,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "factory_1",
"distance": 40,
"cost_per_transport": 5000
},
{"source_key": "elevator_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
},
{"source_key": "factory_1",
"destination_key": "market_1",
"distance": 5,
"cost_per_transport": 5000
}
],
"leftovers": [{"crop_key": "bean",
"humidity": 50,
"target_key": "field_1",
"target_detail_key": null,
"amount": 4990
}
],
"plan_settings": {"project_settings": {"configuration": "OPTIMIZE_DISTANCE",
"start_date": "2024-01-01",
"end_date": "2024-01-15",
"transport_capacity": 23
},
"calculation_settings": {"result_ttl": "PT20M",
"treat_warnings_as_errors": false
}
}
}

System

System functions. Auxiliary functionality common to all services.

Checking the availability

Checking the service availability.

Responses

Response Schema: application/json

health

required

number <double> [ 0 .. 1 ]

Example: "0.999"

The current health indicator of the service.

0.0 means the service is not ready to perform tasks.
1.0 means the service is fully ready to perform tasks.

Response samples

200
404
429
500

Content type

application/json

{"health": 0.999
}

Getting the service version

Getting the service version.

Responses

Response Schema: application/json

major required	integer <int32> [ 1 .. 100 ] Example: "7" Product version. Within a single version, compatibility of common data structures between services is guaranteed. A version change indicates changes that are incompatible with previous versions of the product (and all services).
minor required	integer <int32> [ 0 .. 111 ] Example: "15" Minor version of the service. A version change indicates new functionality. The update is backward compatible with the major version of the service.
build required	string [ 1 .. 64 ] characters Example: "3754RC" Build version. Contains backwards compatible bug fixes and docs update.

Response samples

200
404
429
500

Content type

application/json

{"major": 7,
"minor": 15,
"build": "3754RC"
}

Getting the documentation

Getting the file with this service documentation.

path Parameters

filename

required

string [ 6 .. 128 ] characters

Example: file_en.html

File name.

Responses

Response Schema:
text/html

string (file_html)

File with data in HTML format.

Response samples

404
429
500

Content type

application/json

{"resource_key": "resource_key",
"detail": {"tracedata": {"process_code": "11111111-2222-3333-4444-555555555555",
"request_code": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"username": "username_for_login",
"company": "smart_company",
"service": "UNIVERSAL",
"operation": "run_plan_calculation",
"env": "edge7",
"pod": "11111111-2222-3333-4444-555555555555",
"time": "2024-11-21T09:30:00+03:00"
}
}
}

VRt.Agro [AG] (7.10.2580)

Description

Objects overview

Field

Elevator

Factory

Market

Project

HARVEST

DRY

LOAD

UNLOAD

STORE

RELOCATE

CONSUMPTION

SELL

BUY

Entity relationship diagram

Plan

Planning (SYNC)

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Planning (ASYNC)

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Cancel calculation

Authorizations:

path Parameters

Responses

Response samples

Calculation state

Authorizations:

path Parameters

Responses

Response Schema: application/json

Response Schema: application/json

Response samples

Getting the result

Authorizations:

path Parameters

Responses

Response Schema: application/json

Response Schema: application/json

Response samples

Result removal

Authorizations:

path Parameters

Responses

Response samples

Data validation

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Clipping (SYNC)

Authorizations:

path Parameters

query Parameters

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

System

Checking the availability

Responses

Response Schema: application/json

Response samples

Getting the service version

Responses

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Response Schema:
text/html