Добавить задачу

Поставить MVRP-задачу в очередь на обработку.

Request

POST

https://courier.yandex.ru/vrs/api/v1/add/mvrp

Query parameters

Name

Description

apikey*

Type: string

Ключ доступа к API.

parent_task_id

Type: string

Идентификатор родительской задачи.

Body

application/json
{
    "depot": {
        "address": "string",
        "crossdock_safety_waiting_duration_s": 3600,
        "description": "string",
        "finish_service_duration_s": 0,
        "flexible_start_time": false,
        "hard_time_window": "string",
        "hard_window": false,
        "id": 0,
        "load_service_duration_s": 0,
        "point": {
            "lat": 0,
            "lon": 0
        },
        "preliminary_service_duration_s": 0,
        "preset_id": "string",
        "ref": "string",
        "service_duration_s": {
            "fixed": 0,
            "scaled": 0
        },
        "time_window": "string",
        "time_windows": [
            {
                "hard_time_window": "string",
                "time_window": "string"
            }
        ],
        "title": "string",
        "type": "depot",
        "unload_service_duration_s": 0,
        "use_in_proximity": false,
        "time_windows_unloading": {
            "hard_time_window": "string",
            "hard_window": false,
            "penalty": {
                "out_of_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            },
            "time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "time_windows_refilling": {
            "hard_time_window": "string",
            "hard_window": false,
            "penalty": {
                "out_of_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            },
            "time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "time_windows_loading": {
            "hard_time_window": "string",
            "hard_window": false,
            "penalty": {
                "out_of_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            },
            "time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ]
        },
        "throughput": {
            "kg_per_hour": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ],
            "units_per_hour": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ],
            "vehicle_count": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ]
        },
        "penalty": {
            "throughput": {
                "fixed": 1000,
                "kg": 50,
                "unit": 100,
                "vehicle": 100000
            },
            "package_throughput": {
                "fixed": 1000,
                "kg": 50,
                "unit": 100
            },
            "out_of_time": {
                "fixed": 1000,
                "minute": 17
            },
            "late": {
                "fixed": 1000,
                "minute": 17
            },
            "early": {
                "fixed": 1000,
                "minute": 17
            }
        },
        "package_throughput": {
            "kg_per_hour": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ],
            "units_per_hour": [
                {
                    "time_window": "string",
                    "value": 0
                }
            ]
        }
    },
    "depots": [
        {
            "address": "string",
            "crossdock_safety_waiting_duration_s": 3600,
            "description": "string",
            "finish_service_duration_s": 0,
            "flexible_start_time": false,
            "hard_time_window": "string",
            "hard_window": false,
            "id": 0,
            "load_service_duration_s": 0,
            "point": {
                "lat": 0,
                "lon": 0
            },
            "preliminary_service_duration_s": 0,
            "preset_id": "string",
            "ref": "string",
            "service_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ],
            "title": "string",
            "type": "depot",
            "unload_service_duration_s": 0,
            "use_in_proximity": false,
            "time_windows_unloading": {
                "hard_time_window": "string",
                "hard_window": false,
                "penalty": {
                    "out_of_time": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "late": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "early": {
                        "fixed": 1000,
                        "minute": 17
                    }
                },
                "time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "time_windows_refilling": {
                "hard_time_window": "string",
                "hard_window": false,
                "penalty": {
                    "out_of_time": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "late": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "early": {
                        "fixed": 1000,
                        "minute": 17
                    }
                },
                "time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "time_windows_loading": {
                "hard_time_window": "string",
                "hard_window": false,
                "penalty": {
                    "out_of_time": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "late": {
                        "fixed": 1000,
                        "minute": 17
                    },
                    "early": {
                        "fixed": 1000,
                        "minute": 17
                    }
                },
                "time_window": "string",
                "time_windows": [
                    {
                        "hard_time_window": "string",
                        "time_window": "string"
                    }
                ]
            },
            "throughput": {
                "kg_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "units_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "vehicle_count": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ]
            },
            "penalty": {
                "throughput": {
                    "fixed": 1000,
                    "kg": 50,
                    "unit": 100,
                    "vehicle": 100000
                },
                "package_throughput": {
                    "fixed": 1000,
                    "kg": 50,
                    "unit": 100
                },
                "out_of_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                }
            },
            "package_throughput": {
                "kg_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "units_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ]
            }
        }
    ],
    "initial_routes": [
        {
            "fixed_order": false,
            "immutable": false,
            "route": [
                {
                    "actual_arrival_time_s": 0,
                    "actual_departure_time_s": 0,
                    "actual_service_start_time_s": 0,
                    "arrival_time_s": 0,
                    "departure_time_s": 0,
                    "load_to_head": [
                        0,
                        "string"
                    ],
                    "load_to_trailer": [
                        0,
                        "string"
                    ],
                    "multi_order": false,
                    "waiting_duration_s": 0,
                    "node": {
                        "type": "depot",
                        "value": {
                            "actual_total_service_duration_s": 0,
                            "added_shared_service_duration_s": 0,
                            "anchor_mode": "Decoupling",
                            "delivered_orders": [
                                0,
                                "string"
                            ],
                            "delivery_deadline": "string",
                            "fixed_position": false,
                            "fixed_run": false,
                            "fixed_shift": false,
                            "fixed_vehicle": false,
                            "id": 0,
                            "keep_in_vehicle": false,
                            "loaded_orders": [
                                0,
                                "string"
                            ],
                            "parking_mode": "ParkingBegin",
                            "parking_type": "trailer",
                            "picked_orders": [
                                0,
                                "string"
                            ],
                            "pickup_id": 0,
                            "pickup_ids": [
                                0,
                                "string"
                            ],
                            "service_waiting_duration_s": 0,
                            "total_service_duration_s": 0,
                            "trailer_decoupled": false,
                            "trailer_used": false,
                            "undroppable": false,
                            "unfeasible_reasons": [
                                {
                                    "custom_type": "string",
                                    "overload": 0,
                                    "text": "string",
                                    "type": "OVERLOAD_WEIGHT"
                                },
                                {
                                    "late_duration_s": 0,
                                    "text": "string",
                                    "type": "FAILED_HARD_TIME_WINDOW"
                                },
                                {
                                    "tags": [
                                        "string"
                                    ],
                                    "text": "string",
                                    "type": "REQUIRED_TAGS_VIOLATION"
                                },
                                {
                                    "tags": [
                                        "string"
                                    ],
                                    "text": "string",
                                    "type": "EXCLUDED_TAGS_VIOLATION"
                                },
                                {
                                    "overrun_s": 0,
                                    "text": "string",
                                    "type": "TRANSIT_TIME_VIOLATION"
                                },
                                {
                                    "incompatibilities": [
                                        {
                                            "incompatible_order_id": 0,
                                            "types": [
                                                {
                                                    "other_type": "string",
                                                    "self_type": "string"
                                                }
                                            ]
                                        }
                                    ],
                                    "text": "string",
                                    "type": "INCOMPATIBLE_LOAD_TYPES_VIOLATION"
                                },
                                {
                                    "incompatibilities": [
                                        {
                                            "incompatible_order_id": 0,
                                            "zones": [
                                                {
                                                    "other_zone": "string",
                                                    "self_zone": "string"
                                                }
                                            ]
                                        }
                                    ],
                                    "text": "string",
                                    "type": "INCOMPATIBLE_ZONES_VIOLATION"
                                },
                                {
                                    "tags": [
                                        "string"
                                    ],
                                    "text": "string",
                                    "type": "ALLOWED_ZONES_VIOLATION"
                                },
                                {
                                    "tags": [
                                        "string"
                                    ],
                                    "text": "string",
                                    "type": "FORBIDDEN_ZONES_VIOLATION"
                                },
                                {
                                    "text": "string",
                                    "type": "OTHER"
                                }
                            ],
                            "zones": [
                                "string"
                            ],
                            "split_info": {
                                "order_ratio": 0,
                                "part_id": 0,
                                "parts_count": 0,
                                "units": 0,
                                "volume_cbm": 0,
                                "weight_kg": 0
                            }
                        }
                    }
                }
            ],
            "vehicle_id": 0,
            "shift": {
                "balanced_group_id": "string",
                "id": "string",
                "start": {
                    "actual_arrival_time_s": 0,
                    "actual_departure_time_s": 0,
                    "actual_service_start_time_s": 0,
                    "actual_waiting_duration_s": 0,
                    "arrival_time_s": 0,
                    "departure_time_s": 0,
                    "load_to_head": [
                        0,
                        "string"
                    ],
                    "load_to_trailer": [
                        0,
                        "string"
                    ],
                    "multi_order": false,
                    "stop_sequence_number": 0,
                    "transit_distance_m": 0,
                    "transit_duration_s": 0,
                    "violations": [
                        {
                            "pickup_id": 0,
                            "type": "FAILED_DELIVERY_DEADLINE"
                        },
                        {
                            "high_risk": false,
                            "pickup_id": 0,
                            "probability": 0,
                            "type": "FAILED_DELIVERY_DEADLINE"
                        }
                    ],
                    "waiting_duration_s": 0,
                    "probably_failed_time_window": {
                        "duration_s": 0,
                        "high_risk": false,
                        "how": "EARLY",
                        "probability": 0
                    },
                    "overtime": {
                        "duration_s": 0
                    },
                    "node": {
                        "type": "depot",
                        "used_hard_time_window": "string",
                        "used_time_window": "string",
                        "value": {
                            "actual_total_service_duration_s": 0,
                            "address": "string",
                            "crossdock_safety_waiting_duration_s": 3600,
                            "delivered_orders": [
                                0,
                                "string"
                            ],
                            "description": "string",
                            "finish_service_duration_s": 0,
                            "fixed_position": false,
                            "flexible_start_time": false,
                            "hard_time_window": "string",
                            "hard_window": false,
                            "id": 0,
                            "load_service_duration_s": 0,
                            "loaded_orders": [
                                0,
                                "string"
                            ],
                            "picked_orders": [
                                0,
                                "string"
                            ],
                            "point": {
                                "lat": 0,
                                "lon": 0
                            },
                            "preliminary_service_duration_s": 0,
                            "preset_id": "string",
                            "ref": "string",
                            "routing_mode": "driving",
                            "service_duration_s": {
                                "fixed": 0,
                                "scaled": 0
                            },
                            "time_window": "string",
                            "time_windows": [
                                {
                                    "hard_time_window": "string",
                                    "time_window": "string"
                                }
                            ],
                            "title": "string",
                            "total_service_duration_s": 0,
                            "trailer_decoupled": false,
                            "trailer_used": false,
                            "type": "depot",
                            "unfeasible_reasons": [
                                {
                                    "late_duration_s": 0,
                                    "text": "string",
                                    "type": "FAILED_HARD_TIME_WINDOW"
                                },
                                {
                                    "overrun_s": 0,
                                    "text": "string",
                                    "type": "TRANSIT_TIME_VIOLATION"
                                },
                                {
                                    "text": "string",
                                    "type": "OTHER"
                                }
                            ],
                            "unload_service_duration_s": 0,
                            "use_in_proximity": false,
                            "time_windows_unloading": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "time_windows_refilling": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "time_windows_loading": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "throughput": {
                                "kg_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "units_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "vehicle_count": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ]
                            },
                            "penalty": {
                                "throughput": {
                                    "fixed": 1000,
                                    "kg": 50,
                                    "unit": 100,
                                    "vehicle": 100000
                                },
                                "package_throughput": {
                                    "fixed": 1000,
                                    "kg": 50,
                                    "unit": 100
                                },
                                "out_of_time": {
                                    "fixed": 1000,
                                    "minute": 17
                                },
                                "late": {
                                    "fixed": 1000,
                                    "minute": 17
                                },
                                "early": {
                                    "fixed": 1000,
                                    "minute": 17
                                }
                            },
                            "package_throughput": {
                                "kg_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "units_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ]
                            }
                        },
                        "used_projection": {
                            "lat": 0,
                            "lon": 0
                        }
                    },
                    "failed_time_window": {
                        "duration_s": 0,
                        "how": "EARLY"
                    }
                },
                "end": {
                    "actual_arrival_time_s": 0,
                    "actual_departure_time_s": 0,
                    "actual_service_start_time_s": 0,
                    "actual_waiting_duration_s": 0,
                    "arrival_time_s": 0,
                    "departure_time_s": 0,
                    "load_to_head": [
                        0,
                        "string"
                    ],
                    "load_to_trailer": [
                        0,
                        "string"
                    ],
                    "multi_order": false,
                    "stop_sequence_number": 0,
                    "transit_distance_m": 0,
                    "transit_duration_s": 0,
                    "violations": [
                        {
                            "pickup_id": 0,
                            "type": "FAILED_DELIVERY_DEADLINE"
                        },
                        {
                            "high_risk": false,
                            "pickup_id": 0,
                            "probability": 0,
                            "type": "FAILED_DELIVERY_DEADLINE"
                        }
                    ],
                    "waiting_duration_s": 0,
                    "probably_failed_time_window": {
                        "duration_s": 0,
                        "high_risk": false,
                        "how": "EARLY",
                        "probability": 0
                    },
                    "overtime": {
                        "duration_s": 0
                    },
                    "node": {
                        "type": "depot",
                        "used_hard_time_window": "string",
                        "used_time_window": "string",
                        "value": {
                            "actual_total_service_duration_s": 0,
                            "address": "string",
                            "crossdock_safety_waiting_duration_s": 3600,
                            "delivered_orders": [
                                0,
                                "string"
                            ],
                            "description": "string",
                            "finish_service_duration_s": 0,
                            "fixed_position": false,
                            "flexible_start_time": false,
                            "hard_time_window": "string",
                            "hard_window": false,
                            "id": 0,
                            "load_service_duration_s": 0,
                            "loaded_orders": [
                                0,
                                "string"
                            ],
                            "picked_orders": [
                                0,
                                "string"
                            ],
                            "point": {
                                "lat": 0,
                                "lon": 0
                            },
                            "preliminary_service_duration_s": 0,
                            "preset_id": "string",
                            "ref": "string",
                            "routing_mode": "driving",
                            "service_duration_s": {
                                "fixed": 0,
                                "scaled": 0
                            },
                            "time_window": "string",
                            "time_windows": [
                                {
                                    "hard_time_window": "string",
                                    "time_window": "string"
                                }
                            ],
                            "title": "string",
                            "total_service_duration_s": 0,
                            "trailer_decoupled": false,
                            "trailer_used": false,
                            "type": "depot",
                            "unfeasible_reasons": [
                                {
                                    "late_duration_s": 0,
                                    "text": "string",
                                    "type": "FAILED_HARD_TIME_WINDOW"
                                },
                                {
                                    "overrun_s": 0,
                                    "text": "string",
                                    "type": "TRANSIT_TIME_VIOLATION"
                                },
                                {
                                    "text": "string",
                                    "type": "OTHER"
                                }
                            ],
                            "unload_service_duration_s": 0,
                            "use_in_proximity": false,
                            "time_windows_unloading": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "time_windows_refilling": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "time_windows_loading": {
                                "hard_time_window": "string",
                                "hard_window": false,
                                "penalty": {
                                    "out_of_time": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "late": {
                                        "fixed": 1000,
                                        "minute": 17
                                    },
                                    "early": {
                                        "fixed": 1000,
                                        "minute": 17
                                    }
                                },
                                "time_window": "string",
                                "time_windows": [
                                    {
                                        "hard_time_window": "string",
                                        "time_window": "string"
                                    }
                                ]
                            },
                            "throughput": {
                                "kg_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "units_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "vehicle_count": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ]
                            },
                            "penalty": {
                                "throughput": {
                                    "fixed": 1000,
                                    "kg": 50,
                                    "unit": 100,
                                    "vehicle": 100000
                                },
                                "package_throughput": {
                                    "fixed": 1000,
                                    "kg": 50,
                                    "unit": 100
                                },
                                "out_of_time": {
                                    "fixed": 1000,
                                    "minute": 17
                                },
                                "late": {
                                    "fixed": 1000,
                                    "minute": 17
                                },
                                "early": {
                                    "fixed": 1000,
                                    "minute": 17
                                }
                            },
                            "package_throughput": {
                                "kg_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ],
                                "units_per_hour": [
                                    {
                                        "time_window": "string",
                                        "value": 0
                                    }
                                ]
                            }
                        },
                        "used_projection": {
                            "lat": 0,
                            "lon": 0
                        }
                    },
                    "failed_time_window": {
                        "duration_s": 0,
                        "how": "EARLY"
                    }
                }
            }
        }
    ],
    "locations": [
        {
            "address": "string",
            "allow_trailers": false,
            "can_be_merged": true,
            "can_be_split": false,
            "client_id": 0,
            "client_service_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "comments": "string",
            "crossdock_mode": "deny",
            "crossdock_service_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "custom_value": 0,
            "delivery_deadline": "string",
            "delivery_to": 0,
            "delivery_to_any": [
                0,
                "string"
            ],
            "depot_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "depot_expiring_time": "string",
            "depot_id": [
                0,
                "string"
            ],
            "depot_ready_time": "string",
            "description": "string",
            "dropped_ratio": 0,
            "hard_time_window": "string",
            "hard_window": false,
            "id": 0,
            "ignore_zones_compatibility": false,
            "in_lifo_order": false,
            "load_types": [
                "string"
            ],
            "max_split_parts": 10,
            "max_total_vehicles": 0,
            "may_drop_in_crossdock": true,
            "optional_tags": [
                {
                    "tag": "string",
                    "value": 0
                }
            ],
            "parking_service_duration_s": 0,
            "phone": "string",
            "pickup_from_any": false,
            "pickup_must_reach_depot": false,
            "point": {
                "lat": 0,
                "lon": 0
            },
            "preset_id": "string",
            "quant": 0,
            "ref": "string",
            "required_tags": [
                "string"
            ],
            "sequence_order": 0,
            "service_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "service_durations": {
                "client": {
                    "fixed": 0,
                    "scaled": 0
                },
                "crossdock": {
                    "fixed": 0,
                    "scaled": 0
                },
                "depot": {
                    "fixed": 0,
                    "scaled": 0
                },
                "location": {
                    "fixed": 0,
                    "scaled": 0
                },
                "parking": 0,
                "stop": {
                    "fixed": 0,
                    "scaled": 0
                }
            },
            "shared_service_duration_s": {
                "fixed": 0,
                "scaled": 0
            },
            "shared_with_company_ids": [
                0
            ],
            "soft_depot_expiring_time": "string",
            "soft_depot_ready_time": "string",
            "split_parts_must_fill_whole_vehicle": false,
            "time_window": "string",
            "time_windows": [
                {
                    "hard_time_window": "string",
                    "time_window": "string"
                }
            ],
            "title": "string",
            "type": "depot",
            "use_in_proximity": true,
            "transit_time": {
                "hard_limit_s": 0,
                "limit_s": 0
            },
            "throughput": {
                "kg_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "units_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "vehicle_count": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ]
            },
            "shipment_size": {
                "units": 0,
                "volume_cbm": 0,
                "weight_kg": 0,
                "volume": {
                    "align": "all_axes",
                    "depth_m": 0,
                    "height_m": 0,
                    "type": "bulk",
                    "width_m": 0
                },
                "custom": 0
            },
            "rolling_throughput": {
                "kg_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "units_per_hour": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ],
                "vehicle_count": [
                    {
                        "time_window": "string",
                        "value": 0
                    }
                ]
            },
            "penalty": {
                "drop": {
                    "fixed": 0,
                    "scaled": 1000000
                },
                "transit_time": {},
                "time_between_visits": {
                    "fixed": 1000,
                    "minute": 17
                },
                "throughput": {
                    "fixed": 1000,
                    "kg": 50,
                    "unit": 100,
                    "vehicle": 100000
                },
                "rolling_throughput": {
                    "fixed": 1000,
                    "kg": 50,
                    "unit": 100,
                    "vehicle": 100000
                },
                "out_of_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "late": {
                    "fixed": 1000,
                    "minute": 17
                },
                "early": {
                    "fixed": 1000,
                    "minute": 17
                },
                "depot_ready_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "depot_expiring_time": {
                    "fixed": 1000,
                    "minute": 17
                },
                "delivery_deadline": {
                    "fixed": 1000,
                    "minute": 17
                }
            }
        }
    ],
    "options": {
        "absolute_time": false,
        "avoid_tolls": false,
        "avoid_zones": [
            "string"
        ],
        "balanced_groups": [
            {
                "id": "string",
                "penalty": {
                    "custom_value": 0,
                    "hour": 0,
                    "ignore_unused_vehicles": false,
                    "km": 0,
                    "served_order": 0,
                    "stop": 0,
                    "unit": 0,
                    "weight_kg": 0
                }
            }
        ],
        "close_location_groups_radius_m": 0,
        "close_locations_during_post_optimization_only": false,
        "critical_lateness_risk_probability": 20,
        "date": "string",
        "enable_vehicle_classes": true,
        "fix_planned_shifts": false,
        "force_merge_multiorders": false,
        "global_proximity_factor": 0,
        "ignore_min_stops_for_unused": false,
        "ignore_zones": false,
        "immutable": false,
        "incompatible_load_types": [
            [
                "string"
            ]
        ],
        "incompatible_zones": [
            [
                "string"
            ]
        ],
        "load_when_ready": false,
        "location_groups": [
            {
                "dependent": false,
                "location_ids": [
                    0,
                    "string"
                ],
                "solid": false,
                "title": "string"
            }
        ],
        "matrix_router": "main",
        "max_distance_to_projection_m": 1000000000,
        "max_drop_penalty_percentage": 100,
        "max_split_orders_percentage": 100,
        "merge_multiorders": false,
        "merge_multiorders_of_different_clients": true,
        "minimize_lateness_risk": false,
        "multiorder_radius_m": 1,
        "penalize_late_service": false,
        "points_throughputs": [
            {
                "throughput": {
                    "kg_per_hour": [
                        {
                            "time_window": "string",
                            "value": 0
                        }
                    ],
                    "units_per_hour": [
                        {
                            "time_window": "string",
                            "value": 0
                        }
                    ],
                    "vehicle_count": [
                        {
                            "time_window": "string",
                            "value": 0
                        }
                    ]
                },
                "point": {
                    "lat": 0,
                    "lon": 0
                },
                "penalty": {
                    "throughput": {
                        "fixed": 1000,
                        "kg": 50,
                        "unit": 100,
                        "vehicle": 100000
                    }
                }
            }
        ],
        "post_optimization": false,
        "preset_id": "string",
        "proximity_factor": 0,
        "quality": "low",
        "restart_on_drop": false,
        "routing_mode": "driving",
        "template_rest_schedules": [
            {
                "breaks": [
                    {
                        "after_last_location": false,
                        "at_rest_place": false,
                        "before_first_location": false,
                        "continuous_travel_time_range": "string",
                        "driving_time_range": "string",
                        "exact_time_range": "string",
                        "merge_with_types": [
                            "string"
                        ],
                        "necessary_route_duration_s": 0,
                        "repeatable": false,
                        "rest_duration_s": 0,
                        "route_duration_s": 0,
                        "travel_time_range": "string",
                        "type": "string",
                        "work_time_range_from_start": "string",
                        "work_time_range_till_rest": "string",
                        "penalty": {
                            "late": {
                                "fixed": 1000,
                                "minute": 17
                            },
                            "early": {
                                "fixed": 1000,
                                "minute": 17
                            }
                        }
                    }
                ],
                "id": "string"
            }
        ],
        "time_zone": 0,
        "wait_in_multiorders": true,
        "weighted_drop_penalty": false,
        "penalty": {
            "split_orders_percentage": {
                "fixed": 1000,
                "per_percent": 50
            },
            "multiorders": {
                "per_extra_point": 0,
                "per_extra_vehicle": 0,
                "per_extra_visit": 0
            },
            "drop_penalty_percentage": {
                "fixed": 1000,
                "per_percent": 50
            },
            "close_location_groups": {
                "per_extra_point": 0,
                "per_extra_vehicle": 0,
                "per_extra_visit": 0
            }
        }
    },
    "vehicles": [
        {
            "allow_different_depots_in_route": false,
            "allowed_zones": [
                "string"
            ],
            "can_change_depot_between_runs": false,
            "close_locations": [
                {
                    "distance_till_service_m": {
                        "penalty": 0,
                        "value": 1000000000
                    },
                    "duration_till_service_s": {
                        "penalty": 0,
                        "value": 1000000000
                    },
                    "routing_mode": "driving",
                    "search_radius_m": 0,
                    "soft_search_radius_m": 0
                }
            ],
            "cost": {
                "fixed": 3000,
                "hour": 100,
                "km": 8,
                "location": 0,
                "run": 0,
                "tonne_km": 0,
                "waiting_hour": 0
            },
            "crossdock_mode": "deny",
            "depot_extra_service_duration_s": 0,
            "depot_id": [
                0,
                "string"
            ],
            "depots_only_at_run_beginning": false,
            "ending_depot_id": [
                0,
                "string"
            ],
            "excluded_tags": [
                "string"
            ],
            "finish_at": 0,
            "finish_route_in_starting_depot": false,
            "finish_run_in_starting_depot": false,
            "first_edges_penalty_factor": 0,
            "fixed_planned_route": false,
            "fixed_work_breaks": [
                {
                    "shift_id": "string",
                    "work_duration_s": 0
                }
            ],
            "forbidden_zones": [
                "string"
            ],
            "global_proximity_attraction_point": 0,
            "id": 0,
            "imei": 0,
            "immutable": false,
            "incompatible_load_types": [
                [
                    "string"
                ]
            ],
            "incompatible_zones": [
                [
                    "string"
                ]
            ],
            "last_edges_penalty_factor": 0,
            "max_middle_depots": 0,
            "max_runs": 1,
            "middle_depot_id": [
                0,
                "string"
            ],
            "min_stop_weight": 0,
            "onboard_incompatible_load_types": false,
            "optional_zones": [
                {
                    "value": 0,
                    "zone": "string"
                }
            ],
            "payout": "string",
            "phone": "string",
            "preset_id": "string",
            "ref": "string",
            "rest_schedule_id": "string",
            "return_to_depot": true,
            "routing_mode": "driving",
            "service_duration_multiplier": 1,
            "shared_service_duration_multiplier": 1,
            "shifts": [
                {
                    "balanced_group_id": "string",
                    "hard_max_duration_s": 2592000,
                    "hard_time_window": "string",
                    "hard_window": false,
                    "id": "string",
                    "immutable": false,
                    "max_duration_s": 172800,
                    "max_mileage_km": 0,
                    "max_runs": 1,
                    "maximal_stops": 0,
                    "minimal_stops": 0,
                    "minimal_unique_stops": 0,
                    "preset_id": "string",
                    "service_duration_s": 0,
                    "time_window": "string",
                    "penalty": {
                        "unique_stop_lack": {
                            "fixed": 0,
                            "per_stop": 0
                        },
                        "stop_lack": {
                            "fixed": 0,
                            "per_stop": 0
                        },
                        "stop_excess": {
                            "fixed": 0,
                            "per_stop": 0
                        },
                        "out_of_time": {
                            "fixed": 1000,
                            "minute": 17
                        },
                        "max_mileage": {
                            "fixed": 1000,
                            "km": 100
                        },
                        "late": {
                            "fixed": 1000,
                            "minute": 17
                        },
                        "early": {
                            "fixed": 1000,
                            "minute": 17
                        }
                    }
                }
            ],
            "start_at": 0,
            "starting_depot_id": [
                0,
                "string"
            ],
            "tags": [
                "string"
            ],
            "travel_time_multiplier": 1,
            "visit_depot_at_start": true,
            "visited_locations": [
                {
                    "delivered_orders": [
                        0,
                        "string"
                    ],
                    "id": 0,
                    "order_ratio": 0,
                    "shift_id": "string",
                    "time": "string",
                    "wait_if_early": true
                }
            ],
            "walking_courier": {
                "restrictions": {
                    "max_parking_duration_s": {
                        "penalty": 0,
                        "value": 1000000000
                    },
                    "max_parking_walking_distance_m": {
                        "penalty": 0,
                        "value": 1000000000
                    },
                    "max_walking_edge_distance_m": {
                        "penalty": 0,
                        "value": 1000000000
                    }
                },
                "cost": {
                    "hour": 0,
                    "km": 0
                },
                "capacity": {
                    "units": 1000000000
                }
            },
            "trailer": {
                "coupling_time_s": 0,
                "decoupling_time_s": 0,
                "rolling_cost": 0,
                "rolling_time": {
                    "fixed_time_s": 0,
                    "s_per_kg": 0,
                    "s_per_m3": 0,
                    "s_per_unit": 0
                },
                "max_capacity_difference": {
                    "units": 0,
                    "volume_cbm": 0,
                    "weight_kg": 0,
                    "custom": 0
                },
                "cost": {
                    "fixed": 3000,
                    "hour": 100,
                    "km": 8,
                    "location": 0,
                    "run": 0,
                    "tonne_km": 0,
                    "waiting_hour": 0
                },
                "capacity": {
                    "units": 1000000000,
                    "volume_cbm": 0,
                    "weight_kg": 1000000000,
                    "volume": {
                        "depth_m": 1000,
                        "height_m": 1000,
                        "width_m": 1000
                    },
                    "limits": {
                        "units_perc": 100,
                        "volume_perc": 100,
                        "weight_perc": 100
                    },
                    "custom": 0
                }
            },
            "specs": {
                "height": 0,
                "length": 0,
                "max_weight": 0,
                "max_weight_kg": 0,
                "width": 0
            },
            "rest_schedule": {
                "breaks": [
                    {
                        "after_last_location": false,
                        "at_rest_place": false,
                        "before_first_location": false,
                        "continuous_travel_time_range": "string",
                        "driving_time_range": "string",
                        "exact_time_range": "string",
                        "merge_with_types": [
                            "string"
                        ],
                        "necessary_route_duration_s": 0,
                        "repeatable": false,
                        "rest_duration_s": 0,
                        "route_duration_s": 0,
                        "travel_time_range": "string",
                        "type": "string",
                        "work_time_range_from_start": "string",
                        "work_time_range_till_rest": "string",
                        "penalty": {
                            "late": {
                                "fixed": 1000,
                                "minute": 17
                            },
                            "early": {
                                "fixed": 1000,
                                "minute": 17
                            }
                        }
                    }
                ]
            },
            "planned_route": {
                "locations": [
                    {
                        "anchor_mode": "Decoupling",
                        "delivered_orders": [
                            0,
                            "string"
                        ],
                        "delivery_in_current_run": false,
                        "id": 0,
                        "is_middle_depot": false,
                        "loaded_orders": [
                            0,
                            "string"
                        ],
                        "order_ratio": 0,
                        "parking_mode": "ParkingBegin",
                        "picked_orders": [
                            0,
                            "string"
                        ],
                        "shift_id": "string",
                        "wait_if_early": true
                    }
                ],
                "planned_runs_first": false,
                "start_time": "string",
                "work_breaks": [
                    {
                        "shift_id": "string",
                        "work_duration_s": 0
                    }
                ]
            },
            "penalty": {
                "min_stop_weight": {
                    "fixed": 1000,
                    "kg": 50
                },
                "empty_runs": {
                    "fixed": 0,
                    "per_run": 0
                },
                "arrival_after_start": {
                    "as_soon_as_possible": false,
                    "average_h": 0
                }
            },
            "capacity": {
                "units": 1000000000,
                "volume_cbm": 0,
                "weight_kg": 1000000000,
                "volume": {
                    "depth_m": 1000,
                    "height_m": 1000,
                    "width_m": 1000
                },
                "limits": {
                    "units_perc": 100,
                    "volume_perc": 100,
                    "weight_perc": 100
                },
                "custom": 0
            }
        }
    ],
    "zones": [
        {
            "id": "string",
            "geometry": {
                "coordinates": [
                    [
                        [
                            0
                        ]
                    ]
                ],
                "type": "string"
            }
        }
    ]
}

Name

Description

locations*

Type: mvrp_request_1_locations_item[]

Список пунктов назначения.
Пункт назначения заказа, отправляемого со склада.

Min items: 1

options*

Type: solver_options_mvrp_2

Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке.

vehicles*

Type: vehicle[]

Список транспортных средств, доступных для планирования маршрута.
Спецификация транспортного средства.

Min items: 1

depot

Type: depot_location_1

По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

depots

Type: mvrp_request_1_depots_item[]

Список складов. Поля depot и depots — взаимоисключающие. Подробнее
По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

initial_routes

Type: mvrp_request_1_initial_routes_item[]

Описание маршрутов в старом решении, которое требуется загрузить в солвер

zones

Type: mvrp_request_1_zones_item[]

mvrp_request_1_locations_item

Пункт назначения заказа, отправляемого со склада.

Name

Description

id*

Type: integer or string

Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

point*

Type: coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

address

Type: string

Адрес локации.

allow_trailers

Type: boolean

При значении true автомобили с прицепами смогут посещать этот пункт назначения. Иначе они будут должны оставить прицеп на якорной локации перед тем, как обслуживать эту. [Подробнее](https://yandex.ru/routing/doc/vrp/concepts/properties-of-vehicles.html?lang=ru#coupling

can_be_merged

Type: boolean

Заказ может являться частью мультизаказа

Default:

can_be_split

Type: boolean

Заказ может быть разделен на части между разными машинами.

client_id

Type: integer or string

Определяет идентификатор (id) клиента, к которому относится локация.

client_service_duration_s

Type: client_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место.

comments

Type: string

Комментарии.

crossdock_mode

Type: string

Определяет, разрешено ли доставлять этот заказ через кросс-док склад.

  • deny — запрещено, можно доставлять только из обычного склада;
  • allow — разрешено, можно доставлять как напрямую из обычного склада, так и через кросс-док склад;
  • mandatory — обязательно, можно доставлять только через кросс-док склад.

Default: allow

Enum: deny, allow, mandatory

crossdock_service_duration_s

Type: crossdock_service_duration_0 or number

Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее

custom_value

Type: number

Дополнительный числовой атрибут локации (Например, вознаграждение курьера за посещение этой локации). Может быть использовано как компонент в расчёте стоимости маршрута.

delivery_deadline

Type: string

Время, до которого заказ из места погрузки (pickup) без указанного поля delivery_to должен быть доставлен до любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

delivery_to

Type: integer or string

Определяет идентификатор (id) пункта назначения. Подробнее

delivery_to_any

Type: (integer or string)[]

Список идентификаторов пунктов выдачи (drop_off). Из заданного места погрузки (pickup) отправление должно быть доставлено в любой из этих пунктов выдачи. Подробнее
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

depot_duration_s

Type: depot_duration_0 or number

Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее

depot_expiring_time

Type: string

Время, не позднее которого заказ необходимо забрать со склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

depot_id

Type: integer or string or array

depot_ready_time

Type: string

Время, начиная с которого заказ можно будет забрать с любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

description

Type: string

Описание пункта назначения.

dropped_ratio

Type: number

Доля заказа, которая не должна быть развезена

Max value: 1

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. Если пункт не может быть посещен в указанное временное окно, он будет исключен из маршрута и добавлен в поле ответа dropped_orders. Это поле полезно для моделирования заказов, которые не могут быть выполнены без нарушения временного окна, например, из-за конфликта с другими заказами. Подробнее

ignore_zones_compatibility

Type: boolean

Игнорировать эффекты вызываемые свойствами incompatible_zones, allowed_zones, forbidden_zones, optional_zones для данной локации.

in_lifo_order

Type: boolean

Заказы, у которых это поле имеет значение true, не могут быть переставлены внутри машины и должны быть доставлены в порядке, обратном порядку загрузки. Пункты назначения, у которых это поле имеет значение false, могут быть в любом месте маршрута. Это поле влияет только на маршруты, в которых присутствуют заказы типов pickup и delivery одновременно. Подробнее

load_types

Type: string[]

Определяет типы грузов в данном пункте назначения. Недопустимы для локаций с типом garage.
Тип груза.

max_split_parts

Type: integer

Максимальное количество частей, на которые может быть разбит заказ

Default: 10

Min value: 1

max_total_vehicles

Type: integer

Максимальное число автомобилей, которые может обслужить якорная локация. По умолчанию не ограничено. Подробнее

may_drop_in_crossdock

Type: boolean

Можно ли оставить пикап в кросс-док складе

Default:

optional_tags

Type: items_optional_tags_item[]

Список тегов, которые не обязаны быть у автомобиля, обслуживающего данный пункт назначения. Эти теги могут уменьшить или увеличить стоимость маршрута, если их удовлетворить. Подробнее
Необязательный тег с бонусом или штрафом.

parking_service_duration_s

Type: number

Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения walking или transit данное время не будет затрачиваться. Если локация была выбрана в качестве парковки для пешеходной части, то данное время будет единожды затрачено перед началом части.

Max value: 3153600000

penalty

Type: items_penalty

Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее

phone

Type: string

Номер телефона получателя при доставке.

pickup_from_any

Type: boolean

Delivery-заказы, у которых это поле имеет значение true, должны иметь несколько связанных с ним pickup-заказов. Для доставки может быть выбран любой один из этих pickup-заказов, а остальные будут проигнорированы. Выбор среди вариантов осуществляется с учетом оптимизации стоимости маршрута. Подробнее

pickup_must_reach_depot

Type: boolean

Данное поле определяет считать ли pickup-локацию обслуженной, если она не доставлена на склад. Запрещено указывать для локаций типов отличных от pickup. Запрещено использовать совместно с полями delivery_to и delivery_to_any. Если у локации определен список допустимых складов, то считается, что заказ нужно довести до склада, в это случае запрещено указывать в поле значение False.

preset_id

Type: string

Номер пресета для свойств пункта назначения.

quant

Type: number or quant_0

ref

Type: string

Сноска с информацией о месте.

required_tags

Type: string[]

Список тегов, которые должны быть у автомобиля, обслуживающего данный пункт назначения. Подробнее
Произвольный тег.

rolling_throughput

Type: items_rolling_throughput

Пропускная способность перекатки (поддерживается для якорных точек).

sequence_order

Type: integer

Все локации в маршруте транспортного средства, у которых указана данная опция, должны быть посещены в порядке неубывания ее значений. Подробнее

service_duration_s

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

service_durations

Type: service_durations

Структура, в которой задаются времена обслуживания для локации.

shared_service_duration_s

Type: shared_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее

shared_with_company_ids

Type: integer[]

ID компаний, которые могут получить доступ к информации о заказе.

shipment_size

Type: items_shipment_size

Размер отправления (метрические размеры и/или вес). Подробнее

soft_depot_expiring_time

Type: string

Время, не позднее которого заказ необходимо забрать со склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

soft_depot_ready_time

Type: string

Время, начиная с которого заказ можно будет забрать с любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

split_parts_must_fill_whole_vehicle

Type: boolean

Части, отделяемые от разделяемого заказа, должны заполнять машину целиком.

throughput

Type: items_throughput

Пропускная способность заказа (поддерживается для разделяемых заказов).

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: items_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

title

Type: string

Название места.

transit_time

Type: items_transit_time

Ограничение на время нахождения заказа на борту

type

Type: string

Определяет тип обслуживания в пункте назначения: delivery, pickup или drop_off.

  • delivery — осуществляется доставка в пункт назначения.
  • pickup — осуществляется погрузка для доставки в другой пункт назначения (если указано delivery_to) или в depot.
  • drop_off — груз из pickup может быть доставлен в любую из точек drop_off (см. delivery_to_any).
  • garage — место, которое может быть указано как начальная или конечная точка маршрута с помощью свойств start_at и finish_at у vehicle.
  • anchor — якорная локация, на которой можно оставить прицеп и перенести груз в голову.
  • parking — место, где можно оставить прицеп, чтобы посетить одну другую локацию. На этих локациях нельзя разгружать прицепы.
  • rest_place — место, где машина может останавливаться на перерыв в случае если у перерыва указан атрибут "at_rest_place". Подробнее

Default: delivery

Enum: depot, crossdock, delivery, pickup, drop_off, garage, anchor, parking, rest_place

use_in_proximity

Type: boolean

При значении false этот пункт назначения не будет учитываться при подсчете proximity и global proximity. Подробнее

Default:

solver_options_mvrp_2

Параметры Сервиса планирования маршрутов. Запрещается указывать параметры, отсутствующие в списке.

Name

Description

time_zone*

Type: number or string

absolute_time

Type: boolean

Использование формата ISO 8601 (YYYY-MM-DDTHH: MM:SS+HH: MM) для отображения параметра time_window в результате.

avoid_tolls

Type: boolean

Не использовать платные дороги, если это возможно (только для режимов driving и truck). Подробнее

avoid_zones

Type: string[]

Список зон, через которые не может проходить маршрут. Данные зоны будут объезжаться, даже если кратчайший путь лежит через них. Суммарное число углов в полигонах зон должно быть не более 300.
Номер зоны.

Max items: 100

balanced_groups

Type: solver_options_mvrp_2_balanced_groups_item[]

Каждый элемент в этом массиве определяет группу балансировки маршрутов. Каждый маршрут в группе соответствует одной смене транспортного средства. Смены связаны с группами полем balanced_group_id. Маршруты сбалансированы по метрикам total_duration_s и/или total_stops в зависимости от установленных штрафов. Подробнее
Группа сбалансированных маршрутов. В случае, если поле penalty не задано, то для обратной совместимости используется штраф {stop: 100, hour: 200}.

close_location_groups_radius_m

Type: number

Расстояние между заказами, при котором они объединяются в одну группу близких локаций

Max value: 1000000000

close_locations_during_post_optimization_only

Type: boolean

Применять штрафы, определенные в поле close_locations только в процессе дооптимизации. При значении true дооптимизация должна быть включена.

critical_lateness_risk_probability

Type: number

Если вероятность опоздания в пункт назначения больше или равна указанному значению, то пункт назначения учитывается в параметре lateness_risk_locations_count. Вероятность задается в процентах.

Default: 20

Min value: 1

Max value: 50

date

Type: string

Начальная дата для всех маршрутов (в формате ГГГГ-ММ-ДД), по умолчанию равна текущей дате. Подробнее

enable_vehicle_classes

Type: boolean

При значении true солвер будет классифицировать транспортные средства на основе их характеристик, чтобы использовать более точные расстояния между локациями. Можно выставить поле в false для уменьшения размера задачи при ошибке "The task is too big".

Default:

fix_planned_shifts

Type: boolean

Фиксировать смены локаций из запланированных маршрутов.

force_merge_multiorders

Type: boolean

Меняет поведение при включенной опции merge_multiorders - может объединить заказы, имеющие одинаковые координаты, даже если в результате ни одна машина не сможет доставить полученный заказ из-за ограничений вместимости, тегов или типов груза. Подробнее

global_proximity_factor

Type: number

Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от 0.0 до 1.0. При использовании этой опции локации будут ближе к последней локации в маршруте. При использовании proximity_factor и global_proximity_factor маршруты будут более устойчивы к переносам заказов в конец маршрута. Обратите внимание, что использование фактора близости снизит оптимальность вычисляемых маршрутов с точки зрения затрат и штрафов. Подробнее

Max value: 10

ignore_min_stops_for_unused

Type: boolean

Не учитывать опцию minimal_stops для неиспользуемых машин. Подробнее

ignore_zones

Type: boolean

Не учитывать опции, связанные с зонами, в машинах и заказах. Подробнее

immutable

Type: boolean

Все заезды, заданные в initial_routes, используются без изменений, новые машины и заезды не добавляются.

incompatible_load_types

Type: string[][]

Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства. Подробнее
Список типов грузов.
Тип груза.

incompatible_zones

Type: string[][]

Каждый элемент в этом массиве определяет список зон, которые не должны посещаться в одном рейсе транспортного средства. Подробнее
Список зон.
Номер зоны.

load_when_ready

Type: boolean

Начинать погрузку заказов на склад по мере готовности (в порядке depot_ready_time). Подробнее

location_groups

Type: solver_options_mvrp_2_location_groups_item[]

Каждый элемент этого массива определяет группу точек доставки, которая должна быть назначена в одну смену. Некоторые локации из группы могут быть отброшены. Пункт назначения может входить только в одну группу. Подробнее
Группа точек доставки, которая должна быть назначена в одну смену.

matrix_router

Type: string

Матричный роутер, использующийся для планирования маршрута

  • main — рекомендуется использовать для России, СНГ и Турции.
  • global — для остальных стран.
  • geodesic — расстояния считаются напрямую без учета пробок.
  • auto — автоматический выбор роутера на основе локации склада.

Default: main

Enum: main, geodesic, global, auto

max_distance_to_projection_m

Type: number

Ограничение на максимальное расстояние до точки проекции. Будет проигнорировано, если у заказа нет подходящих проекций

Default: 1000000000

Max value: 1000000000

max_drop_penalty_percentage

Type: number

Максимальная доля штрафов за недоставку заказов от суммы шрафов по всем заказам. Подробнее

Default: 100

Max value: 100

max_split_orders_percentage

Type: number

Максимальная доля заказов, которые могут быть разбиты на части

Default: 100

Max value: 100

merge_multiorders

Type: boolean

По возможности объединять заказы, имеющие одинаковые координаты и обслуживать их одним транспортным средством. Подробнее

merge_multiorders_of_different_clients

Type: boolean

Если эта опция сброшена, то заказы с разным client_id но общей координатой будут образоывать отдельные остановки. Подробнее

Default:

minimize_lateness_risk

Type: boolean

Минимизировать вероятности опозданий, т.е. избегать таких маршрутов, где предполагаемое время прибытия близко к концу временного окна. Подробнее

multiorder_radius_m

Type: number

Расстояние между заказами, при котором они склеиваются в один мультизаказ

Default: 1

Max value: 1000000000

penalize_late_service

Type: boolean

Эта опция определяет, нужно ли штрафовать за позднее прибытие на объект или позднее окончание обслуживания. При значении false штрафы начисляются при позднем прибытии на объект или позднем старте со склада (т.е. после окончания выбранного временного окна). При обслуживании мультизаказов для каждого подзаказа учитывается начало обслуживания всего мультизаказа, а не этого подзаказа. При значении true штрафы начисляются при позднем завершении обслуживания объекта, склада или смены (т.е. после окончания выбранного временного окна). В большинстве случаев включение этой опции эквивалентно сокращению всех временных окон складов, объектов и смен на соответствующее время обслуживания. Тем не менее, механика меняется в случае,если время обслуживания в точке не определено наперёд: например, в случае мультизаказов или разгрузке нескольких заказов на складе. Рекомендуется включать эту опцию в случае, если для мультизаказов важнее вовремя обслужить каждый подзаказ, чем вовремя прибыть на точку мультизаказа. Подробнее

penalty

Type: solver_options_mvrp_2_penalty

Штрафы за несоблюдение ограничений на все решение.

points_throughputs

Type: solver_options_mvrp_2_points_throughputs_item[]

Каждый элемент этого массива определяет пропускную способность точки.
Пропускная способность точки

post_optimization

Type: boolean

Использовать дооптимизацию: перезапустить алгоритм на последних 10% итераций без учета global proximity и балансировок. Подробнее

preset_id

Type: string

Номер пресета для опций задачи.

proximity_factor

Type: number

Степень влияния близости пунктов назначения на маршруты транспортных средств. Рекомендуемый диапазон значений: от 0.0 до 1.0. При использовании этой опции маршруты будут более устойчивы к пропускам заказов. Обратите внимание, что использование фактора близости снизит оптимальность вычисляемых маршрутов с точки зрения затрат и штрафов. Подробнее

Max value: 10

quality

Type: string

Качество решения:

  • low — отладочный режим для разработки и проверки ограничений, небольшое время выполнения;
  • normal — базовое качество решения, среднее время выполнения;
  • high — максимально возможное качество, большое время выполнения. Обязательное поле.

Default: normal

Enum: low, normal, high

restart_on_drop

Type: boolean

Перезапуск задачи для выполнения оптимизации только среди не отброшенных заказов в случае, если решения без отбрасывания заказов найти не удалось. Данный параметр следует активировать в том случае, если отказ от заказов допустим и приемлем для вашего бизнес-сценария.

routing_mode

Type: string

Способ передвижения. Подробнее

  • driving — режим по умолчанию, маршрутизация с профилем автомобиля;
  • truck — маршрутизация с профилем грузовика;
  • walking — маршрут с пешеходным профилем, только на дорогах, разрешенных для пешеходного движения;
  • transit — маршрут с пешеходным профилем в сочетании с общественным транспортом;
  • bicycle — маршрут с профилем велосипеда.

Default: driving

Enum: driving, truck, walking, transit, bicycle

template_rest_schedules

Type: solver_options_mvrp_2_template_rest_schedules_item[]

Список шаблонов расписания перерывов. Подробнее
Шаблон расписания перерывов на отдых.

wait_in_multiorders

Type: boolean

Разрешает ожидание в мультизаказах. Подробнее

Default:

weighted_drop_penalty

Type: boolean

Вычисление штрафа за отказ от доставки заказа в зависимости от веса и объема груза. Это бывает полезно для оптимизации при высокой загрузке транспортных средств. Прописанные штрафы за отказ от точек доставки в таком случае игнорируются. Подробнее

vehicle

Спецификация транспортного средства.

Name

Description

id*

Type: integer or string

Идентификатор транспортного средства. Все идентификаторы транспортных средств в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

allow_different_depots_in_route

Type: boolean

Транспортное средство может посещать несколько складов с различными идентификаторами в пределах одного маршрута

allowed_zones

Type: string[]

Список зон, которые может посещать траспортное средство. Подробнее
Номер зоны.

can_change_depot_between_runs

Type: boolean

Транспортное средство может начинать заезд не на том складе, на котором завершился предыдущий заезд

capacity

Type: vehicle_capacity

Вместимость транспортного средства. Подробнее

close_locations

Type: vehicle_close_locations_item[]

cost

Type: cost_0 or string or cost_1

crossdock_mode

Type: string

Определяет, разрешено ли этой машине доставлять заказы до кросс-док склада. Подробнее

  • deny — запрещено, может доставлять только до локаций;
  • allow — разрешено, может доставлять как напрямую до локаций, так и до кросс-док склада;
  • mandatory — обязательно, может доставлять только до кросс-док склада.

Default: allow

Enum: deny, allow, mandatory

depot_extra_service_duration_s

Type: number

Дополнительное время, необходимое для загрузки данного а/м на складе.

Max value: 3153600000

depot_id

Type: integer or string or array

depots_only_at_run_beginning

Type: boolean

Промежуточные склады допустимы только до обслуживания первого заказа.

ending_depot_id

Type: integer or string or array

excluded_tags

Type: string[]

Список тегов транспортного средства, несовместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее
Произвольный тег или регулярное выражение расширенного POSIX стандарта.

finish_at

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

finish_route_in_starting_depot

Type: boolean

Обязательно завершать маршрут на том же складе, на котором его начали.

finish_run_in_starting_depot

Type: boolean

Обязательно завершать заезды на том же складе, на котором его начали.

first_edges_penalty_factor

Type: number

Коэффициент, дающий штраф/бонус за первое ребро каждого заезда.При положительных значениях солвер старается начать обслуживание заказов с ближайших к складу, при отрицательных значениях - с наиболее отдалённых от склада

fixed_planned_route

Type: boolean

Если установлено в true, то маршрут, указанный в поле planned_route будет использован без изменений. Подробнее

fixed_work_breaks

Type: vehicle_fixed_work_breaks_item[]

Данный список устанавливает продолжительность работы перед каждым перерывом на отдых для нескольких первых перерывов в каждой смене (или во всём маршруте, если смены отсутствуют). Если для транспортного средства предусмотрен список смен (см. параметр shifts), то необходимо указать допустимое значение shift_id для каждого указанного перерыва на отдых. В первую очередь эта опция предусмотрена для комбинирования с visited_locations, поскольку с её помощью можно описывать длительности перерывов между пунктами назначения, зафиксированными в начале пути или смены; однако эти две опции могут использоваться независимо друг от друга.

forbidden_zones

Type: string[]

Список зон, которые не может посещать траспортное средство. Подробнее
Номер зоны.

global_proximity_attraction_point

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

imei

Type: integer

Номер GPS-трекера.

immutable

Type: boolean

Заезды данной машины, заданные в initial_routes, используются без изменений, новые заезды не добавляются.

incompatible_load_types

Type: string[][]

Каждый элемент в этом массиве определяет список типов грузов, которые не должны попадать в один рейс транспортного средства (перезаписывает значение incompatible_load_types, указанное в options). Подробнее
Список типов грузов.
Тип груза.

incompatible_zones

Type: string[][]

Каждый элемент в этом массиве определяет список зон, которые не должны посещаться в одном рейсе транспортного средства. (перезаписывает значение incompatible_zones, указанное в options). Подробнее
Список зон.
Номер зоны.

last_edges_penalty_factor

Type: number

Коэффициент, дающий штраф/бонус за последнее ребро каждого заезда.При положительных значениях солвер старается закончить обслуживание заказов ближе к складу, при отрицательных значениях дальше от склада

max_middle_depots

Type: integer

Максимальное количество промежуточных (не заканчивающих заезд) складов в маршруте

max_runs

Type: integer

Максимальное количество рейсов транспортного средства во всех сменах за день. Подробнее

Default: 1

middle_depot_id

Type: integer or string or array

min_stop_weight

Type: number

Минимальный суммарный вес всех заказов в одной точке. Подробнее

onboard_incompatible_load_types

Type: boolean

Рассчитывать несовместимость по типам грузов только относительно находящихся на борту заказов.

optional_zones

Type: vehicle_optional_zones_item[]

Список необязательных зон с бонусом
Необязательные зоны с бонусом.

payout

Type: string or payout_0

penalty

Type: vehicle_penalty

Штрафы за несоблюдение ограничений на транспортное средство.

phone

Type: string

Номер телефона курьера.

planned_route

Type: vehicle_planned_route

Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера fix_planned_shifts. Подробнее

preset_id

Type: string

Номер пресета для свойств транспортного средства.

ref

Type: string

Референсный номер автомобиля.

rest_schedule

Type: vehicle_rest_schedule

Расписание перерывов на отдых. Подробнее

rest_schedule_id

Type: string

Идентификатор шаблона расписания перерывов, использующегося этим автомобилем.

return_to_depot

Type: boolean

Если установлено в true, то транспортное средство вернется на склад после последнего пункта назначения. Когда этот параметр установлен в false и не указан параметр finish_at, последний рейс и смена заканчиваются в последнем пункте назначения маршрута. Когда установлен в true и использовван параметр finish_at, последний рейс проходит через склад в конце маршрута и завершается вместе со сменой в гараже, указанном в параметре finish_at.

Default:

routing_mode

Type: string

Способ передвижения. Если присутствует, переопределяет routing_mode, указанный в параметрах запроса. Подробнее

  • driving — режим по умолчанию, маршрутизация с профилем автомобиля;
  • truck — маршрутизация с профилем грузовика;
  • walking — маршрут с пешеходным профилем, только на дорогах, разрешенных для пешеходного движения;
  • transit — маршрут с пешеходным профилем в сочетании с общественным транспортом;
  • bicycle — маршрут с профилем велосипеда.

Enum: driving, truck, walking, transit, bicycle

service_duration_multiplier

Type: number

Коэффициент корректировки времени обслуживания для медленных или быстрых рабочих. Подробнее

Default: 1

Min value: 0.001

shared_service_duration_multiplier

Type: number

Коэффициент корректировки общего времени обслуживания для медленных или быстрых рабочих. Подробнее

Default: 1

Min value: 0.001

shifts

Type: vehicle_shifts_item[]

Список транспортных смен. Подробнее
Транспортная смена.

specs

Type: vehicle_specs

Характеристики транспортного средства. Подробнее

start_at

Type: integer or string

Определяет id местоположения с типом garage, в котором транспортное средство начнет свой первый рейс и смену. Подробнее

starting_depot_id

Type: integer or string or array

tags

Type: string[]

Список тегов транспортного средства, совместимых с тегами пункта назначения (используются регулярные выражения расширенного POSIX стандарта). Подробнее
Произвольный тег или регулярное выражение расширенного POSIX стандарта.

trailer

Type: vehicle_trailer

Спецификация прицепа. Использование прицепа с пешим курьером (walking_courier) невозможно.Подробнее

travel_time_multiplier

Type: number

Коэффициент корректировки времени поездки, используется для быстрых или медленных транспортных средств. Подробнее

Default: 1

Min value: 0.001

visit_depot_at_start

Type: boolean

Если установлено в true, то первый маршрут транспортного средства обязательно проходит через склад в начале рейса. Может быть установлено в false только в случае, если у этой же машины использован параметр start_at, который определяет начальную точку маршрута, отличную от склада. Подробнее Возможны четыре варианта указать начало первого маршрута машины используя опции start_at и visit_depot_at_start:

  • start_at указана, visit_depot_at_start=true: garage -> depot -> location;
  • start_at указана, visit_depot_at_start=false: garage -> locations;
  • start_at не задана, visit_depot_at_start=true: depot -> locations;
  • start_at не задана, visit_depot_at_start=false: locations.

Default:

visited_locations

Type: vehicle_visited_locations_item[]

Список пунктов назначения, которые должны быть посещены транспортным средством в строго определенном порядке. Это фиксированная часть маршрута без учета оптимизации, при этом дополнительно может указываться время отправления из некоторых пунктов назначения. Если необходимо также указать точное расписание перерывов на отдых во время посещения этих пунктов назначения, используйте параметр транспортного средства fixed_work_breaks.Подробнее

walking_courier

Type: vehicle_walking_courier

Описание курьера-пешехода. Использование пешего курьера в а/м с прицепом невозможно.

depot_location_1

По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

Name

Description

point*

Type: coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

address

Type: string

Адрес локации.

crossdock_safety_waiting_duration_s

Type: number

Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы.

Default: 3600

Max value: 3153600000

description

Type: string

Описание пункта назначения.

finish_service_duration_s

Type: number

Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее

Max value: 3153600000

flexible_start_time

Type: boolean

По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в true, транспортное средство может начать работу раньше или позже времени по умолчанию. В этом случае будет выбрано такое время начала работы транспортного средства, которое будет оптимальным с точки зрения минимизации затрат. Подробнее Кроме того, при использовании параметра flexible_start_time могут сформироваться маршруты, в которых время прибытия практически совпадет с окончанием временного окна. Такого рода маршруты, как правило, нежелательны из-за риска опоздания в пункт назначения. Во избежание таких маршрутов рекомендуется использовать параметр minimize_lateness_risk и/или penalize_late_service совместно с flexible_start_time.

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее

id

Type: integer or string

Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

load_service_duration_s

Type: number

Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ.

package_throughput

Type: depot_location_1_package_throughput

Ограничение на скорость упаковки заказов на складе.

penalty

Type: depot_location_1_penalty

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

preliminary_service_duration_s

Type: number

Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления depot_ready_time грузов, погруженных на этот автомобиль. Подробнее

Max value: 3153600000

preset_id

Type: string

Номер пресета для свойств склада.

ref

Type: string

Сноска с информацией о месте.

service_duration_s

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

throughput

Type: depot_location_1_throughput

Пропускная способность склада. Подробнее

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: depot_location_1_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

time_windows_loading

Type: depot_location_1_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

time_windows_refilling

Type: depot_location_1_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

time_windows_unloading

Type: depot_location_1_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

title

Type: string

Название места.

type

Type: string

Определяет тип склада: depot или crossdock.

  • depot — основной склад, на котором хранятся заказы.
  • crossdock — дополнительный склад, на котором изначально заказов нет. Чтобы доставлять заказы с этого склада, другая машина должна сначала привезти их из основного склада, на котором они хранятся.

Default: depot

Enum: depot, crossdock

unload_service_duration_s

Type: number

Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ.

use_in_proximity

Type: boolean

При значении false этот склад не будет учитываться при подсчете proximity и global proximity. При значении true этот склад будет учитываться при подсчете proximity и global proximity.Если же значение параметра не определено,то склад будет учитываться только при построении proximity в режиме совместимости.

mvrp_request_1_depots_item

По умолчанию склад — начальная и конечная точка движения транспортного средства на маршруте.

Name

Description

point*

Type: coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

address

Type: string

Адрес локации.

crossdock_safety_waiting_duration_s

Type: number

Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы.

Default: 3600

Max value: 3153600000

description

Type: string

Описание пункта назначения.

finish_service_duration_s

Type: number

Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее

Max value: 3153600000

flexible_start_time

Type: boolean

По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в true, транспортное средство может начать работу раньше или позже времени по умолчанию. В этом случае будет выбрано такое время начала работы транспортного средства, которое будет оптимальным с точки зрения минимизации затрат. Подробнее Кроме того, при использовании параметра flexible_start_time могут сформироваться маршруты, в которых время прибытия практически совпадет с окончанием временного окна. Такого рода маршруты, как правило, нежелательны из-за риска опоздания в пункт назначения. Во избежание таких маршрутов рекомендуется использовать параметр minimize_lateness_risk и/или penalize_late_service совместно с flexible_start_time.

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее

id

Type: integer or string

Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

load_service_duration_s

Type: number

Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ.

package_throughput

Type: items_package_throughput

Ограничение на скорость упаковки заказов на складе.

penalty

Type: items_penalty_1

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

preliminary_service_duration_s

Type: number

Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления depot_ready_time грузов, погруженных на этот автомобиль. Подробнее

Max value: 3153600000

preset_id

Type: string

Номер пресета для свойств склада.

ref

Type: string

Сноска с информацией о месте.

service_duration_s

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

throughput

Type: items_throughput_1

Пропускная способность склада. Подробнее

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: items_time_windows_item_1[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

time_windows_loading

Type: items_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

time_windows_refilling

Type: items_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

time_windows_unloading

Type: items_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

title

Type: string

Название места.

type

Type: string

Определяет тип склада: depot или crossdock.

  • depot — основной склад, на котором хранятся заказы.
  • crossdock — дополнительный склад, на котором изначально заказов нет. Чтобы доставлять заказы с этого склада, другая машина должна сначала привезти их из основного склада, на котором они хранятся.

Default: depot

Enum: depot, crossdock

unload_service_duration_s

Type: number

Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ.

use_in_proximity

Type: boolean

При значении false этот склад не будет учитываться при подсчете proximity и global proximity. При значении true этот склад будет учитываться при подсчете proximity и global proximity.Если же значение параметра не определено,то склад будет учитываться только при построении proximity в режиме совместимости.

mvrp_request_1_initial_routes_item

Name

Description

route*

Type: initial_routes_route_element_1[]

Последовательность узлов, составляющих маршрут.
Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

vehicle_id*

Type: integer or string

Идентификатор транспортного средства. Все идентификаторы транспортных средств в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

fixed_order

Type: boolean

Локации, заданные в initial_routes, не могут быть переупорядочены

immutable

Type: boolean

Заезд, заданный в initial_routes, используется без изменений.

shift

Type: items_shift

mvrp_request_1_zones_item

Name

Description

geometry*

Type: items_geometry

id*

Type: string

Номер зоны

coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

client_service_duration_0

Name

Description

fixed

Type: number

Фиксированное время обслуживания для любой части заказа.

Max value: 3153600000

scaled

Type: number

Время обслуживания части заказа, умножаемое на ее долю от основного заказа.

Max value: 3153600000

crossdock_service_duration_0

Name

Description

fixed

Type: number

Фиксированное время обслуживания для любой части заказа.

Max value: 3153600000

scaled

Type: number

Время обслуживания части заказа, умножаемое на ее долю от основного заказа.

Max value: 3153600000

depot_duration_0

Name

Description

fixed

Type: number

Фиксированное время обслуживания для любой части заказа.

Max value: 3153600000

scaled

Type: number

Время обслуживания части заказа, умножаемое на ее долю от основного заказа.

Max value: 3153600000

items_optional_tags_item

Необязательный тег с бонусом или штрафом.

Name

Description

tag*

Type: string

Произвольный тег.

value*

Type: number

Значение тега. Если заказ доставлен автомобилем с соответствующим тегом в поле tags, то это значение будет вычтено из стоимости маршрута. Если соответствующий тег находится в поле excluded_tags, то это значение будет прибавлено к стоимости.

items_penalty

Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее

Name

Description

delivery_deadline

Type: penalty_delivery_deadline

Составляющие штрафа за позднюю доставку заказа типа pickup на склад. Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее

depot_expiring_time

Type: penalty_depot_expiring_time

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

depot_ready_time

Type: penalty_depot_ready_time

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

drop

Type: drop_0 or number

Штраф за невыполнение заказа. Подробнее

early

Type: penalty_early_4

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

late

Type: penalty_late_4

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

out_of_time

Type: penalty_out_of_time_4

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

rolling_throughput

Type: penalty_rolling_throughput

Составляющие штрафа за превышение пропускной способности.

throughput

Type: penalty_throughput_1

Составляющие штрафа за превышение пропускной способности.

time_between_visits

Type: penalty_time_between_visits

Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.

transit_time

Type: any

Составляющие штрафа за превышение времени нахождения заказа на борту

quant_0

Размер минимальной части, которая может быть отделена от заказа, в одной из единиц измерения

Name

Description

units

Type: number

Размер минимальной части в пользовательских единицах измерения.

volume_cbm

Type: number

Объем минимальной части, кубические метры.

weight_kg

Type: number

Вес минимальной части, кг.

items_rolling_throughput

Пропускная способность перекатки (поддерживается для якорных точек).

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

service_duration_2_0

Name

Description

fixed

Type: number

Фиксированное время обслуживания для любой части заказа.

Max value: 3153600000

scaled

Type: number

Время обслуживания части заказа, умножаемое на ее долю от основного заказа.

Max value: 3153600000

service_durations

Структура, в которой задаются времена обслуживания для локации.

Name

Description

client

Type: client_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место.

crossdock

Type: crossdock_service_duration_0 or number

Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее

depot

Type: depot_duration_0 or number

Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее

location

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

parking

Type: number

Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения walking или transit данное время не будет затрачиваться. Если локация была выбрана в качестве парковки для пешеходной части, то данное время будет единожды затрачено перед началом части.

Max value: 3153600000

stop

Type: shared_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее

shared_service_duration_0

Name

Description

fixed

Type: number

Фиксированное время обслуживания для любой части заказа.

Max value: 3153600000

scaled

Type: number

Время обслуживания части заказа, умножаемое на ее долю от основного заказа.

Max value: 3153600000

items_shipment_size

Размер отправления (метрические размеры и/или вес). Подробнее

Name

Description

custom

Type: number

Размер отправления в пользовательских единицах измерения. Размеры в пользовательских единицах задаются в формате "name": size, где name — строка, обозначающая название единицы, а size — неотрицательное вещественное число, обозначающее количество соответствующих единиц в отправлении. Если название единицы присутствует в других объектах (локациях/транспортных средствах/прицепах), но не в этом, то количество этих единиц в отправлении полагается равным нулю. Подробнее

units

Type: number

Размер отправления в пользовательских единицах измерения.

Max value: 1000000000

volume

Type: shipment_size_volume

Метрические размеры отправления.

volume_cbm

Type: number

Явно заданный объем, кубические метры. По умолчанию берется значение из "volume", если тут ничего не указать.

weight_kg

Type: number

Вес отправления, кг.

Max value: 1000000000

items_throughput

Пропускная способность заказа (поддерживается для разделяемых заказов).

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

items_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

items_transit_time

Ограничение на время нахождения заказа на борту

Name

Description

hard_limit_s

Type: number

Жёсткое ограничение, не может быть превышено

Max value: 1000000000

limit_s

Type: number

Мягкое ограничение, превышение допустимо, но ведёт к штрафам

Max value: 1000000000

solver_options_mvrp_2_balanced_groups_item

Группа сбалансированных маршрутов. В случае, если поле penalty не задано, то для обратной совместимости используется штраф {stop: 100, hour: 200}.

Name

Description

id*

Type: string

Уникальный идентификатор группы балансировки маршрутов.

penalty

Type: items_penalty_9

Штрафы за несбалансированность маршрутов.

solver_options_mvrp_2_location_groups_item

Группа точек доставки, которая должна быть назначена в одну смену.

Name

Description

location_ids*

Type: (integer or string)[]

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

dependent

Type: boolean

При значении true будут обслужены либо все локации из группы, либо ни одна из них.

solid

Type: boolean

При значении true все назначенные локации в группе будут обслужены подряд, но их порядок не зафиксирован.

title

Type: string

solver_options_mvrp_2_penalty

Штрафы за несоблюдение ограничений на все решение.

Name

Description

close_location_groups

Type: penalty_close_location_groups_1

Составляющие штрафа за лишние посешения точек внутри одной группы близких локаций.

drop_penalty_percentage

Type: penalty_drop_penalty_percentage_1

Составляющие штрафа за нарушение max_drop_penalty_percentage.

multiorders

Type: penalty_multiorders_1

Составляющие штрафа за лишние посешения точек мультизаказов.

split_orders_percentage

Type: penalty_split_orders_percentage_1

Составляющие штрафа за нарушение max_split_orders_percentage.

solver_options_mvrp_2_points_throughputs_item

Пропускная способность точки

Name

Description

penalty

Type: items_penalty_8

point

Type: items_point_1

Координаты пункта назначения в формате WGS84. Подробнее

throughput

Type: items_throughput_3

Пропускная способность точки.

solver_options_mvrp_2_template_rest_schedules_item

Шаблон расписания перерывов на отдых.

Name

Description

breaks*

Type: array

id*

Type: string

Уникальный идентификатор шаблона.

vehicle_capacity

Вместимость транспортного средства. Подробнее

Name

Description

custom

Type: number

Количество пользовательских единиц измерения, которое может перевозить транспортное средство. Вместимости в пользовательских единицах задаются в формате "name": size, где name - строка, обозначающая название единицы, а size - неотрицательное вещественное число, обозначающее вместимость автомобиля в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то вместимость полагается неограниченной.

limits

Type: capacity_limits_1

Пределы загрузки транспортного средства.

units

Type: number

Количество пользовательских единиц измерения, которое может перевозить транспортное средство.

Default: 1000000000

volume

Type: capacity_volume_1

Метрические размеры автомобиля.

volume_cbm

Type: number

Вместимость транспортного средства в кубических метрах.

weight_kg

Type: number

Грузоподъемность транспортного средства в килограммах.

Default: 1000000000

vehicle_close_locations_item

Name

Description

distance_till_service_m

Type: any

duration_till_service_s

Type: any

routing_mode

Type: string

Способ передвижения для определения близости локаций. Данный параметр допустимо использовать только если в а/м определено свойство walking_courer. В этом случае допустимы значения walking и значение основного способа передвижения а/м.

Enum: driving, truck, walking, transit, bicycle

search_radius_m

Type: number

Максимальное расстояние между двумя локациями на которые накладывается данное ограничение.

Max value: 1000000000

soft_search_radius_m

Type: number

При использовании значении данного параметра больше соответствующего значения параметра search_radius_m для локаций на расстояниях от search_radius_m до soft_search_radius_m значение штрафа линейно снижается вплоть до 0.

Max value: 1000000000

cost_0

Стоимость использования транспортного средства. Подробнее

Name

Description

fixed

Type: number

Стоимость за факт использования транспортного средства (стоимость считается затраченной, если транспортное средство поставлено на маршрут).

Default: 3000

hour

Type: number

Стоимость за час использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по времени.

Default: 100

km

Type: number

Стоимость за километр использования транспортного средства. Данная стоимость не должна быть нулевой или слишком низкой — в противном случае могут быть проложены маршруты, не оптимальные по расстоянию.

Default: 8

location

Type: number

Стоимость использования транспортного средства в расчете на один пункт назначения (по умолчанию — 0).

run

Type: number

Стоимость за один рейс со склада до пункта назначения.

tonne_km

Type: number

Стоимость перевозки одной тонны на один километр (по умолчанию — 0).

waiting_hour

Type: number

Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле hour.

cost_1

Описание стоимости использования а/м с возможностью задания арифметических выражений для отдельных частей маршрута. В случае, если заданы выражения для нескольких частей, то итоговая стоимость будет получена как сумма по всем заданным выражениям для всех входящих в маршрут частей.

Name

Description

route

Type: string

Арифметическое выражение, задающее стоимость маршрута.

run

Type: string

Арифметическое выражение, задающее стоимость заезда.

shift

Type: string

Арифметическое выажение, задающее стоимость смены.

vehicle_fixed_work_breaks_item

Name

Description

work_duration_s*

Type: number

Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах.

Max value: 3153600000

shift_id

Type: string

Уникальный идентификатор смены.

vehicle_optional_zones_item

Необязательные зоны с бонусом.

Name

Description

value*

Type: number

Значение зоны. За доставку заказа с соответствующей зоной это значение будет вычтено из стоимости маршрута. При наличии у заказа нескольких подходящих зон будет использован максимальный бонус.

zone*

Type: string

Номер зоны.

payout_0

Описание выплаты курьера за выполнение маршрута с возможностью задания арифметических выражений для отдельных частей маршрута. В случае, если заданы выражения для нескольких частей, то итоговая выплата будет получена как сумма по всем заданым выражениям для всех входящих в маршрут частей.

Name

Description

route

Type: string

Арифметическое выражение, задающее стоимость маршрута.

run

Type: string

Арифметическое выражение, задающее стоимость заезда.

shift

Type: string

Арифметическое выажение, задающее стоимость смены.

vehicle_penalty

Штрафы за несоблюдение ограничений на транспортное средство.

Name

Description

arrival_after_start

Type: penalty_arrival_after_start

Составляющие штрафа за прибытие позже начала окна

empty_runs

Type: penalty_empty_runs

Составляющие штрафа за пустые заезды, которые не могут быть пропущены из-за указания реальных времен помещения.

min_stop_weight

Type: penalty_min_stop_weight

Составляющие штрафа за недостаточный суммарный вес заказов в точке.

vehicle_planned_route

Заранее запланированные пункты назначения для данного транспортного средства. Эти пункты назначения не будут отброшены даже при нарушении строгих ограничений и будут обслужены в любом случае. Указанный в этом параметре порядок пунктов назначения, может быть изменен для оптимизации окончательного маршрута. По умолчанию смены, назначенные запланированным локациям тоже могут измениться. Они могут быть зафиксированны с помощью опции солвера fix_planned_shifts. Подробнее

Name

Description

locations*

Type: planned_route_locations_item[]

Плановый порядок точек доставки в маршруте транспортного средства, включая все смены и доставку в несколько рейсов. Если для транспортного средства предусмотрен список смен (см. параметр shifts), то необходимо указать допустимое значение shift_id для каждого пункта назначения на маршруте.

planned_runs_first

Type: boolean

Необходимо посетить все указанные в planned_route склады перед тем, как совершать незапланированные рейсы.

start_time

Type: string or array

work_breaks

Type: planned_route_work_breaks_item[]

Спланированные перерывы на отдых в маршруте транспортного средства, включающем все смены и рейсы. Если для транспортного средства предусмотрен список смен (см. параметр shifts), то необходимо указать допустимое значение shift_id для каждого запланированного перерыва на отдых. Если присутствует список фиксированных перерывов (параметр fixed_work_break) и данный список, то при ограничении на любую смену один из них должен быть префиксом другого. Таким образом, переписать фиксированные перерывы спланированными невозможно.

vehicle_rest_schedule

Расписание перерывов на отдых. Подробнее

Name

Description

breaks*

Type: array

vehicle_shifts_item

Транспортная смена.

Name

Description

id*

Type: string

Уникальный идентификатор смены.

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

balanced_group_id

Type: string

Идентификатор соответствующей группы балансировки маршрутов (см. опцию balanced_groups).

hard_max_duration_s

Type: number

Жесткое ограничение на максимальную продолжительность смены в секундах. Если заданы оба поля max_duration_s и hard_max_duration_s, то запрещено использовать значение меньше, чем в соответствующем max_duration_s.

Default: 2592000

Max value: 3153600000

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается завершить смену только в пределах указанного временного окна. Подробнее

immutable

Type: boolean

Заезды в данной смене, заданные в initial_routes, используются без изменений, новые заезды не добавляются.

max_duration_s

Type: number

Максимальная продолжительность смены в секундах. Если спланированная продолжительность смены больше, чем указано, применяются штрафы за превышение графика смены.

Default: 172800

Max value: 3153600000

max_mileage_km

Type: number

Максимальный пробег машины за смену в километрах. Если спланированный пробег больше, чем данное значение, то применяются штрафы из параметра смены penalty.max_mileage. Подробнее

max_runs

Type: integer

Максимальное количество рейсов транспортного средства в смене.

Default: 1

maximal_stops

Type: integer

Максимальное количество остановок в смене. Если итоговое количество остановок больше этого значения, применяется штраф stop_excess.Подробнее

minimal_stops

Type: integer

Минимальное количество остановок в смене. Если итоговое количество остановок меньше этого значения, применяется штраф stop_lack. Подробнее

minimal_unique_stops

Type: integer

Минимальное количество остановок с различными координатами в смене. Если итоговое количество остановок меньше этого значения, применяется штраф unique_stop_lack.

penalty

Type: items_penalty_10

Штрафы за нарушение регламента смены.

preset_id

Type: string

Номер пресета для транспортной смены.

service_duration_s

Type: number

Длительность обслуживания при передаче смен (в секундах). Может включать в себя любые операции, необходимые для завершения смены, например, пересменка водителей, обмен бумагами и т. д. (по умолчанию: 0).

Max value: 3153600000

vehicle_specs

Характеристики транспортного средства. Подробнее

Name

Description

height

Type: number

Высота транспортного средства в метрах.

length

Type: number

Длина транспортного средства в метрах.

max_weight

Type: number

Максимальный вес транспортного средства в тоннах.

max_weight_kg

Type: number

Максимальный вес транспортного средства в килограммах. При решении задачи характеристика будет округляться вверх до тонн. Если заданы обе характеристики max_weight и max_weight_kg, будет использована max_weight.

width

Type: number

Ширина транспортного средства в метрах.

vehicle_trailer

Спецификация прицепа. Использование прицепа с пешим курьером (walking_courier) невозможно.Подробнее

Name

Description

capacity

Type: trailer_capacity

Вместимость прицепа.

cost

Type: trailer_cost

Стоимость использования прицепа.

coupling_time_s

Type: number

Дополнительное время на присоединение прицепа, в секундах.

Max value: 3153600000

decoupling_time_s

Type: number

Дополнительное время на отсоединение прицепа, в секундах.

Max value: 3153600000

max_capacity_difference

Type: trailer_max_capacity_difference

Максимальная разница загрузки прицепа и тягоча.

rolling_cost

Type: number

Штраф за каждую перекатку грузов из прицепа в тягач.

rolling_time

Type: trailer_rolling_time

Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки.

vehicle_visited_locations_item

Name

Description

id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

order_ratio

Type: number

Доля заказа, входящая в данную часть.

shift_id

Type: string

Уникальный идентификатор смены.

time

Type: string

Время отправления из пункта назначения, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z.

wait_if_early

Type: boolean

Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении true автомобиль будет ждать начала временного окна пункта назначения, прежде чем обслужить его. При значении false он приступит к обслуживанию точки назначения сразу по прибытии. В случае строгого временного окна значение параметра должно быть true.

Default:

vehicle_walking_courier

Описание курьера-пешехода. Использование пешего курьера в а/м с прицепом невозможно.

Name

Description

capacity

Type: walking_courier_capacity

Грузоподъемность курьера.

cost

Type: walking_courier_cost

Стоимость работы курьера-пешехода.

restrictions

Type: any

depot_location_1_package_throughput

Ограничение на скорость упаковки заказов на складе.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

depot_location_1_penalty

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

Name

Description

early

Type: penalty_early_3

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

late

Type: penalty_late_3

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

out_of_time

Type: penalty_out_of_time_3

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

package_throughput

Type: penalty_package_throughput

Составляющие штрафа за превышение пропускной способности упаковки заказов.

throughput

Type: penalty_throughput

Составляющие штрафа за превышение пропускной способности.

depot_location_1_throughput

Пропускная способность склада. Подробнее

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

depot_location_1_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

depot_location_1_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_loading_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

depot_location_1_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_refilling_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

depot_location_1_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_unloading_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

items_package_throughput

Ограничение на скорость упаковки заказов на складе.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

items_penalty_1

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

Name

Description

early

Type: penalty_early_8

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

late

Type: penalty_late_8

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

out_of_time

Type: penalty_out_of_time_8

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

package_throughput

Type: penalty_package_throughput_1

Составляющие штрафа за превышение пропускной способности упаковки заказов.

throughput

Type: penalty_throughput_2

Составляющие штрафа за превышение пропускной способности.

items_throughput_1

Пропускная способность склада. Подробнее

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

items_time_windows_item_1

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

items_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_loading_time_windows_item_1[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

items_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_refilling_time_windows_item_1[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

items_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_unloading_time_windows_item_1[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

initial_routes_route_element_1

Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

Name

Description

node*

Type: initial_route_node_depot or initial_route_node_location_1 or initial_route_node_work_break or initial_route_node_courier_position

Элемент маршрута.

actual_arrival_time_s

Type: number or string

Реальное время прибытия в пункт назначения.

actual_departure_time_s

Type: number or string

Реальное время отправления из пункта назначения.

actual_service_start_time_s

Type: number or string

Реальное время начала обслуживания заказа.

arrival_time_s

Type: number or string

Время прибытия в пункт назначения. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания.

departure_time_s

Type: number or string

Время отправления из пункта назначения.

load_to_head

Type: (integer or string)[]

Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

load_to_trailer

Type: (integer or string)[]

Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

multi_order

Type: boolean

Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр shared_service_duration_s — длительность совместного обслуживания для нескольких заказов. Общая длительность обслуживания всех заказов в мультизаказе рассчитывается по формуле: max(shared_service_duration_s) + sum(service_duration_s).

waiting_duration_s

Type: number

Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды.

items_shift

Name

Description

id*

Type: string

Уникальный идентификатор смены.

balanced_group_id

Type: string

Идентификатор соответствующей группы балансировки маршрутов (см. опцию balanced_groups).

end

Type: shift_end

Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

start

Type: shift_start

Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

items_geometry

Name

Description

coordinates

Type: number[][][]

Всегда содержит два элемента: долгота и широта

type

Type: string

Всегда равен Polygon

penalty_delivery_deadline

Составляющие штрафа за позднюю доставку заказа типа pickup на склад. Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения склада после дедлайна.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания, когда склад посещается после дедлайна.

Default: 17

penalty_depot_expiring_time

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

penalty_depot_ready_time

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

drop_0

Name

Description

fixed

Type: number

Фиксированный штраф за невыполнение любой части заказа.

scaled

Type: number

Штраф за недоставленную долю заказа.

Default: 1000000

penalty_early_4

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф за обслуживание объекта, начатое раньше выбранного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего прибытия, если обслуживание объекта было начато раньше выбранного временного окна.

Default: 17

penalty_late_4

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения после окончания заданного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания, когда место посещается после окончания временного окна.

Default: 17

penalty_out_of_time_4

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения вне заданного временного окна. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания или раннего прибытия при посещении объекта за пределами временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_rolling_throughput

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

penalty_throughput_1

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

penalty_time_between_visits

Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за каждый случай нарушения вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

kg_per_hour_0_item_3

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_3

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_2

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

shipment_size_volume

Метрические размеры отправления.

Name

Description

depth_m*

Type: number

Глубина, в метрах.

Max value: 1000000

height_m*

Type: number

Высота, в метрах.

Max value: 1000000

width_m*

Type: number

Ширина, в метрах.

Max value: 1000000

align

Type: string

Выравнивание отправления по осям (не имеет эффекта для типа bulk):

  • all_axes — полное выравнивание (по умолчаниию), груз должен быть размещен параллельно осям транспортного средства;
  • height — выравнивание по высоте, разрешены произвольные вращения в двух других размерностях (для типа rigid в качестве высоты можно выбрать любую из размерностей). Подробнее

Default: all_axes

Enum: all_axes, height

type

Type: string

Тип отправления:

  • bulk — сыпучий (по умолчанию), может произвольно изменять форму;
  • rigid — жесткий, можно крутить, но нельзя изменять форму;
  • fixed_bottom — жесткий с фиксированным дном, крутить можно только в двух измерениях (фиксированное измерение — height). Подробнее

Default: bulk

Enum: bulk, rigid, fixed_bottom

kg_per_hour_0_item_2

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_2

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_1

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

items_penalty_9

Штрафы за несбалансированность маршрутов.

Name

Description

custom_value

Type: number

Штраф за каждую единицу отклонения custom_value заказов, рассчитываемый по корню из суммы квадратов отклонений custom_value заказов маршрута от среднего числа custom_value заказов в группе балансировки маршрутов.

hour

Type: number

Штраф за каждый час корня из суммы квадратов отклонения длительности маршрута от средней длительности группы балансировки маршрутов.

ignore_unused_vehicles

Type: boolean

Игнорировать неиспользуемые а/м при расчетах штрафа.

km

Type: number

Штраф за каждый км корня из суммы квадратов отклонения расстояния маршрута от среднего расстояния группы балансировки маршрутов.

served_order

Type: number

Штраф за каждую пропущенный или дополнительный заказ, рассчитываемый по корню из суммы квадратов отклонений числа заказов маршрута от среднего числа заказов в группе балансировки маршрутов.

stop

Type: number

Штраф за каждую пропущенную или дополнительную остановку, рассчитываемую по корню из суммы квадратов отклонений числа остановок маршрута от среднего числа остановок в группе балансировки маршрутов.

unit

Type: number

Штраф за каждую единицу отклонения массы заказов в единицах груза, рассчитываемый по корню из суммы квадратов отклонений массы заказов в единицах груза маршрута от среднего числа массы заказов в единицах груза в группе балансировки маршрутов.

weight_kg

Type: number

Штраф за каждую единицу отклонения массы заказов в кг, рассчитываемый по корню из суммы квадратов отклонений массы заказов в кг маршрута от среднего числа массы заказов в кг в группе балансировки маршрутов.

penalty_close_location_groups_1

Составляющие штрафа за лишние посешения точек внутри одной группы близких локаций.

Name

Description

per_extra_point

Type: number

Штраф за каждую точку в которую машины/курьеры приезжают больше одного раза.

per_extra_vehicle

Type: number

Штраф за каждую лишнюю машину/курьера, которые приезжают в точки близких локаций.

per_extra_visit

Type: number

Штраф за каждое лишнее посещение точкек близких локаций.

penalty_drop_penalty_percentage_1

Составляющие штрафа за нарушение max_drop_penalty_percentage.

Name

Description

fixed

Type: number

Фиксированный штраф в случае, если суммарный штраф за недоставку слишком велик.

Default: 1000

per_percent

Type: number

Штраф за каждый лишний процент штрафа за недоставку заказов.

Default: 50

penalty_multiorders_1

Составляющие штрафа за лишние посешения точек мультизаказов.

Name

Description

per_extra_point

Type: number

Штраф за каждую точку в которую машины/курьеры приезжают больше одного раза.

per_extra_vehicle

Type: number

Штраф за каждую лишнюю машину/курьера, которые приезжают в точки мультизаказов.

per_extra_visit

Type: number

Штраф за каждое лишнее посещение точкек мультизаказов.

penalty_split_orders_percentage_1

Составляющие штрафа за нарушение max_split_orders_percentage.

Name

Description

fixed

Type: number

Фиксированный штраф в случае, если доля разделенных заказов слишком велика.

Default: 1000

per_percent

Type: number

Штраф за каждый лишний процент в доле разделенных заказов.

Default: 50

items_penalty_8

Name

Description

throughput

Type: penalty_throughput_5

Составляющие штрафа за превышение пропускной способности.

items_point_1

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

items_throughput_3

Пропускная способность точки.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

breaks_0_item_1

Перерыв в работе.

Name

Description

rest_duration_s*

Type: number

Продолжительность отдыха, в секундах.

Min value: 0.001

Max value: 3153600000

after_last_location

Type: boolean

При значении true перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно после обслуживания последнего пункта назначения.

at_rest_place

Type: boolean

При значении true машина будет заезжать на отдых в локацию с типом "rest_place"

before_first_location

Type: boolean

При значении true перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно перед обслуживанием первого пункта назначения.

continuous_travel_time_range

Type: string

Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Минимальная и максимальная продолжительность движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

Точный диапазон времени, когда должен начаться отдых, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

merge_with_types

Type: string[]

Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями before_first_location и after_last_location.

necessary_route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах.

Max value: 3153600000

penalty

Type: items_penalty_7

Штрафы, применяемые за нарушения условий перерывов в работе.

repeatable

Type: boolean

При значении true перерыв будет повторяться до конца маршрута. Можно указывать true только для последнего перерыва в цепочке.

route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах.

Max value: 3153600000

travel_time_range

Type: string

Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

type

Type: string

Тип перерыва. Используется в поле merge_with_types.

work_time_range_from_start

Type: string

Минимальное и максимальное время от начала маршрута до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Минимальная и максимальная продолжительность работы до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

capacity_limits_1

Пределы загрузки транспортного средства.

Name

Description

units_perc

Type: number

Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости транспортного средства.

Default: 100

volume_perc

Type: number

Максимальный объем отправлений в процентах от объема грузового отсека транспортного средства. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из (0.01 * volume_perc).

Default: 100

weight_perc

Type: number

Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого транспортным средством.

Default: 100

capacity_volume_1

Метрические размеры автомобиля.

Name

Description

depth_m*

Type: number

Глубина, в метрах.

Default: 1000

Max value: 1000000

height_m*

Type: number

Высота, в метрах.

Default: 1000

Max value: 1000000

width_m*

Type: number

Ширина, в метрах.

Default: 1000

Max value: 1000000

penalty_arrival_after_start

Составляющие штрафа за прибытие позже начала окна

Name

Description

as_soon_as_possible

Type: boolean

Опция для прибытия максимально рано, даже если это влечет дополнительное ожидание. При использовании параметра рекомендуется также указывать ненулевое значение параметра average_h.

average_h

Type: number

Штраф за среднее время приезда после начала окна

penalty_empty_runs

Составляющие штрафа за пустые заезды, которые не могут быть пропущены из-за указания реальных времен помещения.

Name

Description

fixed

Type: number

Фиксированный штраф в случае, если в маршруте остаются пустые заезды.

per_run

Type: number

Штраф за каждый пустой заезд в маршруте.

penalty_min_stop_weight

Составляющие штрафа за недостаточный суммарный вес заказов в точке.

Name

Description

fixed

Type: number

Фиксированный штраф в случае, если суммарный вес заказов в точке недостаточно велик.

Default: 1000

kg

Type: number

Штраф за каждый недостающий килограмм в суммарном весе заказов.

Default: 50

planned_route_locations_item

Name

Description

id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

anchor_mode

Type: string

Default: Undefined

Enum: Decoupling, Rolling, Coupling, Undefined

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

delivery_in_current_run

Type: boolean

Все заказы, загруженные в данной локации, должны быть доставлены в этом же рейсе.

is_middle_depot

Type: boolean

Локация является промежуточным складом.

loaded_orders

Type: (integer or string)[]

Идентификаторы заказов типа delivery, загружаемых в машину на складе или гараже.

order_ratio

Type: number

Доля заказа, входящая в данную часть.

parking_mode

Type: string

Default: Undefined

Enum: ParkingBegin, ParkingRefill, ParkingEnd, Undefined

picked_orders

Type: (integer or string)[]

Список идентификаторов заказов, забираемых в кросс-доке или складе.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

shift_id

Type: string

Уникальный идентификатор смены.

wait_if_early

Type: boolean

Этот параметр определяет, что происходит, если автомобиль приезжает в пункт назначения слишком рано. При значении true автомобиль будет ждать начала временного окна пункта назначения, прежде чем обслужить его. При значении false он приступит к обслуживанию точки назначения сразу по прибытии. В случае строгого временного окна значение параметра должно быть true.

Default:

start_time_0_item

Name

Description

shift_id*

Type: string

Уникальный идентификатор смены.

start_time*

Type: string

Время начала смены в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z.

planned_route_work_breaks_item

Name

Description

work_duration_s*

Type: number

Продолжительность непрерывной работы до следующего перерыва на отдых, в секундах.

Max value: 3153600000

shift_id

Type: string

Уникальный идентификатор смены.

breaks_0_item_2

Перерыв в работе.

Name

Description

rest_duration_s*

Type: number

Продолжительность отдыха, в секундах.

Min value: 0.001

Max value: 3153600000

after_last_location

Type: boolean

При значении true перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно после обслуживания последнего пункта назначения.

at_rest_place

Type: boolean

При значении true машина будет заезжать на отдых в локацию с типом "rest_place"

before_first_location

Type: boolean

При значении true перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно перед обслуживанием первого пункта назначения.

continuous_travel_time_range

Type: string

Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Минимальная и максимальная продолжительность движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

Точный диапазон времени, когда должен начаться отдых, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

merge_with_types

Type: string[]

Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями before_first_location и after_last_location.

necessary_route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах.

Max value: 3153600000

penalty

Type: items_penalty_12

Штрафы, применяемые за нарушения условий перерывов в работе.

repeatable

Type: boolean

При значении true перерыв будет повторяться до конца маршрута. Можно указывать true только для последнего перерыва в цепочке.

route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах.

Max value: 3153600000

travel_time_range

Type: string

Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

type

Type: string

Тип перерыва. Используется в поле merge_with_types.

work_time_range_from_start

Type: string

Минимальное и максимальное время от начала маршрута до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Минимальная и максимальная продолжительность работы до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

items_penalty_10

Штрафы за нарушение регламента смены.

Name

Description

early

Type: penalty_early_14

Составляющие штрафа за смены, начатые слишком рано. (используются вместо штрафа out_of_time). Если смены была завершена слишком рано, то штраф также начисляется за завершение.

late

Type: penalty_late_14

Составляющие штрафа за смены, завершённые слишком поздно (используются вместо штрафа out_of_time). Этот штраф применяется как за опоздание к концу временного окна, так и за превышение максимальной продолжительности смены (max_duration_s). Если и то, и другое нарушено одновременно, штраф применяется к обоим нарушениям и суммируется. Также, если смена была начата после окончания временного окна, штраф дополнительно начисляется за точку начала смены. Подробнее

max_mileage

Type: penalty_max_mileage

Штрафы, применяемые за нарушение ограничения на пробег транспортного средства за смену (параметр смены max_mileage_km).

out_of_time

Type: penalty_out_of_time_10

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

stop_excess

Type: penalty_stop_excess

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство maximal_stops параметра shifts).

stop_lack

Type: penalty_stop_lack

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops параметра shifts).

unique_stop_lack

Type: penalty_unique_stop_lack

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops параметра shifts).

trailer_capacity

Вместимость прицепа.

Name

Description

custom

Type: number

Количество пользовательских единиц измерения, которое можно перевозить в прицепе. Вместимости в пользовательских единицах задаются в формате "name": size, где name - строка, обозначающая название единицы, а size - неотрицательное вещественное число, обозначающее вместимость автомобиля в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то вместимость полагается неограниченной.

limits

Type: capacity_limits

Пределы загрузки прицепа.

units

Type: number

Количество пользовательских единиц измерения, которое можно перевозить в прицепе.

Default: 1000000000

volume

Type: capacity_volume

Метрические размеры прицепа.

volume_cbm

Type: number

Вместимость прицепа в кубических метрах.

weight_kg

Type: number

Грузоподъемность прицепа в килограммах.

Default: 1000000000

trailer_cost

Стоимость использования прицепа.

Name

Description

fixed

Type: number

Стоимость за факт использования прицепа (стоимость считается затраченной, если прицеп использовался в маршруте).

Default: 3000

hour

Type: number

Стоимость за час использования прицепа.

Default: 100

km

Type: number

Стоимость за километр использования прицепа.

Default: 8

location

Type: number

Стоимость использования прицепа в расчете на один пункт назначения (по умолчанию — 0).

run

Type: number

Стоимость за один рейс со склада до пункта назначения.

tonne_km

Type: number

Стоимость перевозки одной тонны на один километр (по умолчанию — 0).

waiting_hour

Type: number

Стоимость часа ожидания с использованием транспортного средства. Если не указана, то используется значение, заданное в поле hour.

trailer_max_capacity_difference

Максимальная разница загрузки прицепа и тягоча.

Name

Description

custom

Type: number

Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача. Допустимая разница в пользовательских единицах задаются в формате "name": size, где name - строка, обозначающая название единицы, а size - вещественное число, обозначающее максимально допустимую разницу в загрузке между прицепом и тягачом в соответствующих единицах. Если название единицы присутствует в объектах (локациях/транспортных средствах/прицепах), но не в этом, то ограничение отсутствует.

units

Type: number

Максимально допустимая разница в загруженном количестве пользовательских единиц измерения у прицепа и тягача.

volume_cbm

Type: number

Максимально допустимая разница в загруженном объеме у прицепа и тягача в кубических метрах.

weight_kg

Type: number

Максимально допустимая разница в загруженной массе у прицепа и тягача в килограммах.

trailer_rolling_time

Время на перекладку грузов из прицепа в голову. Если указано несколько типов времени, используется тот, который затрачивает больше всего времени. Если ни один тип не указан, используется только фиксированое время перекладки.

Name

Description

fixed_time_s

Type: number

Фиксированное время, затраченное каждый раз, когда прицеп загружается или разгружается, в секундах.

Max value: 3153600000

s_per_kg

Type: number

Время разгрузки на килограм груза, в секундах.

Max value: 3153600000

s_per_m3

Type: number

Время разгрузки на кубометр груза, в секундах.

Max value: 3153600000

s_per_unit

Type: number

Время разгрузки на единицу груза, в секундах.

Max value: 3153600000

walking_courier_capacity

Грузоподъемность курьера.

Name

Description

units

Type: number

Количество пользовательских единиц измерения, которое может переносить курьер.

Default: 1000000000

walking_courier_cost

Стоимость работы курьера-пешехода.

Name

Description

hour

Type: number

Стоимость за час пеших маршрутов курьера.

km

Type: number

Стоимость за километр пройденный курьером.

kg_per_hour_0_item_1

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, кг/ч.

units_per_hour_0_item_1

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час.

penalty_early_3

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле fixed.

Default: 17

penalty_late_3

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна.

Default: 17

penalty_out_of_time_3

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_package_throughput

Составляющие штрафа за превышение пропускной способности упаковки заказов.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

penalty_throughput

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

kg_per_hour_0_item

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

time_windows_loading_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_refilling_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_unloading_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

kg_per_hour_0_item_5

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, кг/ч.

units_per_hour_0_item_5

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час.

penalty_early_8

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле fixed.

Default: 17

penalty_late_8

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна.

Default: 17

penalty_out_of_time_8

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_package_throughput_1

Составляющие штрафа за превышение пропускной способности упаковки заказов.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

penalty_throughput_2

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

kg_per_hour_0_item_4

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_4

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_3

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

time_windows_loading_time_windows_item_1

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_refilling_time_windows_item_1

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_unloading_time_windows_item_1

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

initial_route_node_depot

Представление склада в initial_routes

Name

Description

value*

Type: initial_route_node_depot_value

Представление локации в initial_routes

type

Type: string

Тип элемента маршрута.

Enum: depot

initial_route_node_location_1

Представление локации в initial_routes

Name

Description

value*

Type: initial_route_node_location_1_value

Представление локации в initial_routes

type

Type: string

Тип элемента маршрута.

Enum: location

initial_route_node_work_break

Представление перерыва в initial_routes

Name

Description

value*

Type: initial_route_node_work_break_value

Представление перерыва в initial_routes

type

Type: string

Тип элемента маршрута.

Enum: break

initial_route_node_courier_position

Представление позиции курьера в initial_routes

Name

Description

value*

Type: initial_route_node_courier_position_value

type

Type: string

Тип элемента маршрута.

Enum: courier

shift_end

Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

Name

Description

arrival_time_s*

Type: number

Плановое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания.

node*

Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position

Элемент маршрута.

transit_distance_m*

Type: number

Расстояние до пункта назначения, в метрах.Если параметр routing_mode имеет значение "transit", то учитывается только пешеходная часть маршрута.

transit_duration_s*

Type: number

Время поездки до пункта назначения, в секундах.

actual_arrival_time_s

Type: number

Фактическое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования.

actual_departure_time_s

Type: number

Фактическое время отправления из пункта назначения, в секундах. Считается от начала суток планирования.

actual_service_start_time_s

Type: number

Реальное время начала обслуживания заказа.

actual_waiting_duration_s

Type: number

Реальная продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала обслуживания согласно actual_arrival_time_s и actual_service_start_time_s, секунды.

departure_time_s

Type: number

Плановое время отправления из пункта назначения, в секундах. Считается от начала суток планирования.

failed_time_window

Type: end_failed_time_window

load_to_head

Type: (integer or string)[]

Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

load_to_trailer

Type: (integer or string)[]

Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

multi_order

Type: boolean

Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр shared_service_duration_s — длительность совместного обслуживания для нескольких заказов. Общая длительность обслуживания всех заказов в мультизаказе рассчитывается по формуле: max(shared_service_duration_s) + sum(service_duration_s).

overtime

Type: end_overtime

probably_failed_time_window

Type: end_probably_failed_time_window

stop_sequence_number

Type: integer

Порядковый номер остановки (среди delivery, pickup и drop_off локаций)

violations

Type: (items_0_2 or items_1_2)[]

Список нарушений.

waiting_duration_s

Type: number

Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды.

shift_start

Узел маршрута; содержит данные о пункте назначения на маршруте или перерыве в работе, длительности поездки между узлами, а также о времени прибытия.

Name

Description

arrival_time_s*

Type: number

Плановое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования. Прибытие произошло до начала временного окна, поэтому будет прибавлено ко времени ожидания.

node*

Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position

Элемент маршрута.

transit_distance_m*

Type: number

Расстояние до пункта назначения, в метрах.Если параметр routing_mode имеет значение "transit", то учитывается только пешеходная часть маршрута.

transit_duration_s*

Type: number

Время поездки до пункта назначения, в секундах.

actual_arrival_time_s

Type: number

Фактическое время прибытия в пункт назначения, в секундах. Считается от начала суток планирования.

actual_departure_time_s

Type: number

Фактическое время отправления из пункта назначения, в секундах. Считается от начала суток планирования.

actual_service_start_time_s

Type: number

Реальное время начала обслуживания заказа.

actual_waiting_duration_s

Type: number

Реальная продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала обслуживания согласно actual_arrival_time_s и actual_service_start_time_s, секунды.

departure_time_s

Type: number

Плановое время отправления из пункта назначения, в секундах. Считается от начала суток планирования.

failed_time_window

Type: start_failed_time_window

load_to_head

Type: (integer or string)[]

Список заказов, которые должны быть загружены в голову автомобиля на складе или якорной локации, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

load_to_trailer

Type: (integer or string)[]

Список заказов, которые должны быть загружены в прицеп автомобиля на складе, в случае, если используются прицепы. Заказы перечислены в порядке обслуживания.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

multi_order

Type: boolean

Несколько заказов доставляются в один и тот же пункт назначения вместе. Время прибытия для всех заказов в группе совпадает. Кроме того, на уровне каждого заказа может быть указан параметр shared_service_duration_s — длительность совместного обслуживания для нескольких заказов. Общая длительность обслуживания всех заказов в мультизаказе рассчитывается по формуле: max(shared_service_duration_s) + sum(service_duration_s).

overtime

Type: start_overtime

probably_failed_time_window

Type: start_probably_failed_time_window

stop_sequence_number

Type: integer

Порядковый номер остановки (среди delivery, pickup и drop_off локаций)

violations

Type: (items_0_1 or items_1_1)[]

Список нарушений.

waiting_duration_s

Type: number

Продолжительность ожидания, время нахождения на пункте назначения после прибытия и до начала временного окна, секунды.

penalty_throughput_5

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

kg_per_hour_0_item_9

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_9

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_7

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

items_penalty_7

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_13

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_13

Составляющие штрафа за поздний перерыв в работе.

items_penalty_12

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_16

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_16

Составляющие штрафа за поздний перерыв в работе.

penalty_early_14

Составляющие штрафа за смены, начатые слишком рано. (используются вместо штрафа out_of_time). Если смены была завершена слишком рано, то штраф также начисляется за завершение.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортная смена была начата или завершена до начала выбранного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего начала или окончания смены, когда транспортное средство начинает или заканчивает смену до начала временного окна.

Default: 17

penalty_late_14

Составляющие штрафа за смены, завершённые слишком поздно (используются вместо штрафа out_of_time). Этот штраф применяется как за опоздание к концу временного окна, так и за превышение максимальной продолжительности смены (max_duration_s). Если и то, и другое нарушено одновременно, штраф применяется к обоим нарушениям и суммируется. Также, если смена была начата после окончания временного окна, штраф дополнительно начисляется за точку начала смены. Подробнее

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если смена начата или завершена после конца выбранного временного окна, а также за превышение максимальной продолжительности смены (параметра max_duration_s).

Default: 1000

minute

Type: number

Штраф за каждую минуту позднего начала или окончания смены в случае непопадания в рамки временного окна или нарушения максимальной продолжительности смены (параметра max_duration_s).

Default: 17

penalty_max_mileage

Штрафы, применяемые за нарушение ограничения на пробег транспортного средства за смену (параметр смены max_mileage_km).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если пробег за смену больше, чем указано в параметре смены max_mileage_km.

Default: 1000

km

Type: number

Штраф за каждый дополнительный километр в случае, если пробег за смену больше, чем указанный в параметре смены max_mileage_km.

Default: 100

penalty_out_of_time_10

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если смена начата или закончена вне заданного временного окна. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту нахождения вне временного окна смены. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_stop_excess

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство maximal_stops параметра shifts).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортная смена имеет больше остановок, чем указано в свойстве maximal_stops.

per_stop

Type: number

Штраф за каждую дополнительную остановку в случае, если транспортная смена имеет больше остановок, чем указано в свойстве maximal_stops.

penalty_stop_lack

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops параметра shifts).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве minimal_stops.

per_stop

Type: number

Штраф за каждую недостающую остановку в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве minimal_stops.

penalty_unique_stop_lack

Штрафы, применяемые за нарушение ограничения на количество остановок в смене (свойство minimal_stops параметра shifts).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве minimal_stops.

per_stop

Type: number

Штраф за каждую недостающую остановку в случае, если транспортная смена имеет меньше остановок, чем указано в свойстве minimal_stops.

capacity_limits

Пределы загрузки прицепа.

Name

Description

units_perc

Type: number

Максимальный объем отправлений в пользовательских единицах измерения, выраженный в процентах от вместимости прицепа.

Default: 100

volume_perc

Type: number

Максимальный объем отправлений в процентах от объема прицепа. Для размещения жёстких контейнеров предполагается, что стороны грузового отсека умножены на кубический корень из (0.01 * volume_perc).

Default: 100

weight_perc

Type: number

Максимальный объем отправлений в процентах от максимально допустимого общего веса груза, перевозимого в прицепе.

Default: 100

capacity_volume

Метрические размеры прицепа.

Name

Description

depth_m*

Type: number

Глубина, в метрах.

Default: 1000

Max value: 1000000

height_m*

Type: number

Высота, в метрах.

Default: 1000

Max value: 1000000

width_m*

Type: number

Ширина, в метрах.

Default: 1000

Max value: 1000000

initial_route_node_depot_value

Представление локации в initial_routes

Name

Description

id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

actual_total_service_duration_s

Type: number

Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s).

added_shared_service_duration_s

Type: number

Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих

Max value: 3153600000

anchor_mode

Type: string

Default: Undefined

Enum: Decoupling, Rolling, Coupling, Undefined

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

delivery_deadline

Type: string

Время, до которого заказ из места погрузки (pickup) без указанного поля delivery_to должен быть доставлен до любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

fixed_run

Type: boolean

Заказ может быть доставлен только в том заезде, в котором он был запланирован

fixed_shift

Type: boolean

Заказ может быть доставлен только в той смене, в которой он был запланирован

fixed_vehicle

Type: boolean

Заказ может быть доставлен только той машиной, в которой он был запланирован

keep_in_vehicle

Type: boolean

При удалении заказа из маршрута, он продолжает занимать место в машине

loaded_orders

Type: (integer or string)[]

Идентификаторы заказов типа delivery, загружаемых в машину на складе или гараже.

parking_mode

Type: string

Default: Undefined

Enum: ParkingBegin, ParkingRefill, ParkingEnd, Undefined

parking_type

Type: string

Enum: trailer, vehicle

picked_orders

Type: (integer or string)[]

Список идентификаторов заказов, забираемых в кросс-доке или складе.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

pickup_id

Type: integer or string

Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

pickup_ids

Type: (integer or string)[]

Список идентификаторов пунктов назначения типа pickup, из которых производится доставка в этот пункт назначения.
Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

service_waiting_duration_s

Type: number

Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа.

Max value: 3153600000

split_info

Type: value_split_info_1

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

total_service_duration_s

Type: number

Общая длительность обслуживания в пункте назначения, включающая service_duration_s, added_shared_service_duration_s parking_service_duration_s и service_waiting_duration_s.

Max value: 3153600000

trailer_decoupled

Type: boolean

trailer_used

Type: boolean

undroppable

Type: boolean

Локацию нельзя удалять из маршрута

unfeasible_reasons

Type: (items_0_12 or items_1_12 or items_2_3 or items_3_2 or items_4_2 or items_5_2 or items_6_2 or items_7_2 or items_8_2 or items_9_2)[]

Список причин невозможности выполнения заказа в пункт назначения.
Причина невозможности выполнения заказа в пункт назначения.

zones

Type: string[]

Список зон
Номер зоны.

initial_route_node_location_1_value

Представление локации в initial_routes

Name

Description

id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

actual_total_service_duration_s

Type: number

Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s).

added_shared_service_duration_s

Type: number

Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих

Max value: 3153600000

anchor_mode

Type: string

Default: Undefined

Enum: Decoupling, Rolling, Coupling, Undefined

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

delivery_deadline

Type: string

Время, до которого заказ из места погрузки (pickup) без указанного поля delivery_to должен быть доставлен до любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

fixed_run

Type: boolean

Заказ может быть доставлен только в том заезде, в котором он был запланирован

fixed_shift

Type: boolean

Заказ может быть доставлен только в той смене, в которой он был запланирован

fixed_vehicle

Type: boolean

Заказ может быть доставлен только той машиной, в которой он был запланирован

keep_in_vehicle

Type: boolean

При удалении заказа из маршрута, он продолжает занимать место в машине

loaded_orders

Type: (integer or string)[]

Идентификаторы заказов типа delivery, загружаемых в машину на складе или гараже.

parking_mode

Type: string

Default: Undefined

Enum: ParkingBegin, ParkingRefill, ParkingEnd, Undefined

parking_type

Type: string

Enum: trailer, vehicle

picked_orders

Type: (integer or string)[]

Список идентификаторов заказов, забираемых в кросс-доке или складе.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

pickup_id

Type: integer or string

Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

pickup_ids

Type: (integer or string)[]

Список идентификаторов пунктов назначения типа pickup, из которых производится доставка в этот пункт назначения.
Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

service_waiting_duration_s

Type: number

Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа.

Max value: 3153600000

split_info

Type: value_split_info

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

total_service_duration_s

Type: number

Общая длительность обслуживания в пункте назначения, включающая service_duration_s, added_shared_service_duration_s parking_service_duration_s и service_waiting_duration_s.

Max value: 3153600000

trailer_decoupled

Type: boolean

trailer_used

Type: boolean

undroppable

Type: boolean

Локацию нельзя удалять из маршрута

unfeasible_reasons

Type: (items_0 or items_1 or items_2 or items_3 or items_4 or items_5 or items_6 or items_7 or items_8 or items_9)[]

Список причин невозможности выполнения заказа в пункт назначения.
Причина невозможности выполнения заказа в пункт назначения.

zones

Type: string[]

Список зон
Номер зоны.

initial_route_node_work_break_value

Представление перерыва в initial_routes

Name

Description

after_last_location

Type: boolean

При значении true перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно после обслуживания последнего пункта назначения.

at_rest_place

Type: boolean

При значении true машина будет заезжать на отдых в локацию с типом "rest_place"

before_first_location

Type: boolean

При значении true перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно перед обслуживанием первого пункта назначения.

chain_number

Type: integer

Порядковый номер цепочки, к которой относится перерыв.

continuous_travel_time_range

Type: string

Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Минимальная и максимальная продолжительность движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

Точный диапазон времени, когда должен начаться отдых, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

fixed_run

Type: boolean

Заказ может быть доставлен только в том заезде, в котором он был запланирован

fixed_shift

Type: boolean

Заказ может быть доставлен только в той смене, в которой он был запланирован

fixed_vehicle

Type: boolean

Заказ может быть доставлен только той машиной, в которой он был запланирован

keep_in_vehicle

Type: boolean

При удалении заказа из маршрута, он продолжает занимать место в машине

merge_with_types

Type: string[]

Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями before_first_location и after_last_location.

necessary_route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах.

Max value: 3153600000

repeatable

Type: boolean

При значении true перерыв будет повторяться до конца маршрута. Можно указывать true только для последнего перерыва в цепочке.

rest_duration_s

Type: number

Продолжительность отдыха, в секундах.

Min value: 0.001

Max value: 3153600000

route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах.

Max value: 3153600000

travel_time_range

Type: string

Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

undroppable

Type: boolean

Локацию нельзя удалять из маршрута

work_duration_s

Type: number

Продолжительность непрерывной работы до перерыва на отдых, в секундах.

Max value: 3153600000

work_time_range_from_start

Type: string

Минимальное и максимальное время от начала маршрута до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Минимальная и максимальная продолжительность работы до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

initial_route_node_courier_position_value

Name

Description

location_id*

Type: string

Идентефикатор текущей локации

passed_time_s

Type: number

Время прошедшее после посещения курьером текущей локации. Считается что в следующую локацию за это время курьер еще не приехал.

route_node_depot

Элемент маршрута.

Name

Description

type*

Type: string

Тип элемента маршрута.

Enum: depot

value*

Type: route_depot_location

Описание пункта назначения.

used_hard_time_window

Type: string

Жесткое окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

used_projection

Type: route_node_depot_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

used_time_window

Type: string

Окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z.

route_node_location_1

Элемент маршрута.

Name

Description

type*

Type: string

Тип элемента маршрута.

Enum: location

value*

Type: route_location_1

Описание пункта назначения.

used_hard_time_window

Type: string

Жесткое окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

used_projection

Type: route_node_location_1_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

used_time_window

Type: string

Окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z.

route_node_work_break

Элемент маршрута.

Name

Description

type*

Type: string

Тип элемента маршрута.

Enum: break

value*

Type: route_work_break

Описание перерыва.

used_hard_time_window

Type: string

Жесткое окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

used_projection

Type: route_node_work_break_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

used_time_window

Type: string

Окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z.

route_node_courier_position

Элемент маршрута.

Name

Description

type*

Type: string

Тип элемента маршрута.

Enum: courier

value*

Type: route_courier_position

used_hard_time_window

Type: string

Жесткое окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

used_projection

Type: route_node_courier_position_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

used_time_window

Type: string

Окно, выбранное для посещения пункта назначения или склада, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z.

end_failed_time_window

Name

Description

duration_s*

Type: number

Когда пункт назначения посещён вне временного окна, показывает расстояние во времени (в секундах) между временем начала или конца обслуживания (в зависимости от значения penalize_late_service) и ближайшим концом временного окна.

how*

Type: string

Когда пункт назначения посещён вне временного окна, показывает тип нарушения:

  • EARLY - прибытие и начало обслуживания происходят до начала временного окна;
  • LATE - прибытие или конец обслуживания (в зависимости от значения penalize_late_service)происходит после окончания временного окна.

Enum: EARLY, LATE

end_overtime

Name

Description

duration_s*

Type: number

Сверхурочное время транспортной смены, в секундах.

end_probably_failed_time_window

Name

Description

duration_s*

Type: number

Ожидаемая разница между временем прибытия и нарушенным временным окном, в секундах.

how*

Type: string

Когда пункт назначения посещён вне временного окна, показывает тип нарушения:

  • EARLY - прибытие и начало обслуживания происходят до начала временного окна;
  • LATE - прибытие или конец обслуживания (в зависимости от значения penalize_late_service)происходит после окончания временного окна.

Enum: EARLY, LATE

probability*

Type: number

Вероятность оказаться за пределами временного окна, в процентах.

high_risk

Type: boolean

Если true, то вероятность опоздания в пункте назначения больше или равна critical_lateness_risk_probability.

items_0_2

Name

Description

duration_s*

Type: any

Ожидаемая разница между временем прибытия и дедлайном, в секундах.

pickup_id*

Type: integer or string

Определяет идентификатор (id) пункта назначения типа pickup, соответствующего этому дедлайну.

type*

Type: string

Возможные причины:

  • FAILED_DELIVERY_DEADLINE - склад посещён после дедлайна какого-либо заказа типа pickup.

Enum: FAILED_DELIVERY_DEADLINE

items_1_2

Name

Description

duration_s*

Type: any

Ожидаемая разница между временем прибытия и дедлайном, в секундах.

high_risk*

Type: boolean

Если true, то вероятность опоздания в пункте назначения больше или равна critical_lateness_risk_probability.

pickup_id*

Type: integer or string

Определяет идентификатор (id) пункта назначения типа pickup, соответствующего этому дедлайну.

probability*

Type: number

Вероятность опоздать, в процентах.

type*

Type: string

Возможные причины:

  • PROBABLY_FAILED_DELIVERY_DEADLINE - склад может быть посещён после дедлайна какого-либо заказа типа pickup с ненулевой вероятностью.

Enum: FAILED_DELIVERY_DEADLINE, PROBABLY_FAILED_DELIVERY_DEADLINE

start_failed_time_window

Name

Description

duration_s*

Type: number

Когда пункт назначения посещён вне временного окна, показывает расстояние во времени (в секундах) между временем начала или конца обслуживания (в зависимости от значения penalize_late_service) и ближайшим концом временного окна.

how*

Type: string

Когда пункт назначения посещён вне временного окна, показывает тип нарушения:

  • EARLY - прибытие и начало обслуживания происходят до начала временного окна;
  • LATE - прибытие или конец обслуживания (в зависимости от значения penalize_late_service)происходит после окончания временного окна.

Enum: EARLY, LATE

start_overtime

Name

Description

duration_s*

Type: number

Сверхурочное время транспортной смены, в секундах.

start_probably_failed_time_window

Name

Description

duration_s*

Type: number

Ожидаемая разница между временем прибытия и нарушенным временным окном, в секундах.

how*

Type: string

Когда пункт назначения посещён вне временного окна, показывает тип нарушения:

  • EARLY - прибытие и начало обслуживания происходят до начала временного окна;
  • LATE - прибытие или конец обслуживания (в зависимости от значения penalize_late_service)происходит после окончания временного окна.

Enum: EARLY, LATE

probability*

Type: number

Вероятность оказаться за пределами временного окна, в процентах.

high_risk

Type: boolean

Если true, то вероятность опоздания в пункте назначения больше или равна critical_lateness_risk_probability.

items_0_1

Name

Description

duration_s*

Type: any

Ожидаемая разница между временем прибытия и дедлайном, в секундах.

pickup_id*

Type: integer or string

Определяет идентификатор (id) пункта назначения типа pickup, соответствующего этому дедлайну.

type*

Type: string

Возможные причины:

  • FAILED_DELIVERY_DEADLINE - склад посещён после дедлайна какого-либо заказа типа pickup.

Enum: FAILED_DELIVERY_DEADLINE

items_1_1

Name

Description

duration_s*

Type: any

Ожидаемая разница между временем прибытия и дедлайном, в секундах.

high_risk*

Type: boolean

Если true, то вероятность опоздания в пункте назначения больше или равна critical_lateness_risk_probability.

pickup_id*

Type: integer or string

Определяет идентификатор (id) пункта назначения типа pickup, соответствующего этому дедлайну.

probability*

Type: number

Вероятность опоздать, в процентах.

type*

Type: string

Возможные причины:

  • PROBABLY_FAILED_DELIVERY_DEADLINE - склад может быть посещён после дедлайна какого-либо заказа типа pickup с ненулевой вероятностью.

Enum: FAILED_DELIVERY_DEADLINE, PROBABLY_FAILED_DELIVERY_DEADLINE

penalty_early_13

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 17

penalty_late_13

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 17

penalty_early_16

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 17

penalty_late_16

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 17

value_split_info_1

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

Name

Description

order_ratio

Type: number

Доля заказа, входящая в данную часть.

part_id

Type: integer

Номер данной части заказа.

parts_count

Type: integer

Количество частей, на которые был разбит заказ.

units

Type: number

Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант).

volume_cbm

Type: number

Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант).

weight_kg

Type: number

Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант).

items_0_12

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overload*

Type: number

Значение перегруза. Единица измерения зависит от типа перегруза:

  • OVERLOAD_WEIGHT - перегруз в кг.
  • OVERLOAD_SIZE - избыточный размер в пользовательских единицах измерения (поле units).
  • OVERLOAD_VOLUME - избыточный объем в м^3.
  • OVERLOAD_CUSTOM - избыточный размер в пользовательских единицах измерения (поле custom).

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OVERLOAD_WEIGHT - автомобиль перегружен,
  • OVERLOAD_SIZE - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле units),
  • OVERLOAD_VOLUME - объем груза больше чем объем грузового отсека в автомобиле,
  • OVERLOAD_CUSTOM - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле custom),

Enum: OVERLOAD_WEIGHT, OVERLOAD_SIZE, OVERLOAD_VOLUME, OVERLOAD_CUSTOM

custom_type

Type: string

Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM.

items_1_12

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

late_duration_s*

Type: number

Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • FAILED_HARD_TIME_WINDOW - автомобиль не смог достичь места в указанное жесткое временное окно,

Enum: FAILED_HARD_TIME_WINDOW

items_2_3

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список отсутствующих необходимых тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • REQUIRED_TAGS_VIOLATION - у автомобиля нет необходимых тегов.

Enum: REQUIRED_TAGS_VIOLATION

items_3_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • EXCLUDED_TAGS_VIOLATION - в заказе есть теги, запрещенные для автомобиля.

Enum: EXCLUDED_TAGS_VIOLATION

items_4_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overrun_s*

Type: number

Величина превышения лимита на время нахождения на борту, в секундах

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • TRANSIT_TIME_VIOLATION - невозможно выполнить заказ не нарушая жёсткий лимит по времени нахождения заказа на борту,

Enum: TRANSIT_TIME_VIOLATION

items_5_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item_5[]

Список всех несовместимых пар типов грузов
Список всех пар типов грузов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_LOAD_TYPES_VIOLATION - заказ несовместим с другими заказами по виду нагрузки.

Enum: INCOMPATIBLE_LOAD_TYPES_VIOLATION

items_6_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item_4[]

Список всех несовместимых пар зон заказов
Список всех пар зон заказов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_ZONES_VIOLATION - заказ несовместим с другими заказами по зонам.

Enum: INCOMPATIBLE_ZONES_VIOLATION

items_7_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список зон, которые разрешается посещать автомобилю.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • ALLOWED_ZONES_VIOLATION - локация не входит ни в одну из зон, которые разрешается посещать автомобилю.

Enum: ALLOWED_ZONES_VIOLATION

items_8_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных зон.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • FORBIDDEN_ZONES_VIOLATION - локация расположена в одной из зон, запрещенных для посещения автомобилем.

Enum: FORBIDDEN_ZONES_VIOLATION

items_9_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OTHER - доставка в место невозможна по другим причинам.

Enum: OTHER

value_split_info

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

Name

Description

order_ratio

Type: number

Доля заказа, входящая в данную часть.

part_id

Type: integer

Номер данной части заказа.

parts_count

Type: integer

Количество частей, на которые был разбит заказ.

units

Type: number

Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант).

volume_cbm

Type: number

Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант).

weight_kg

Type: number

Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант).

items_0

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overload*

Type: number

Значение перегруза. Единица измерения зависит от типа перегруза:

  • OVERLOAD_WEIGHT - перегруз в кг.
  • OVERLOAD_SIZE - избыточный размер в пользовательских единицах измерения (поле units).
  • OVERLOAD_VOLUME - избыточный объем в м^3.
  • OVERLOAD_CUSTOM - избыточный размер в пользовательских единицах измерения (поле custom).

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OVERLOAD_WEIGHT - автомобиль перегружен,
  • OVERLOAD_SIZE - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле units),
  • OVERLOAD_VOLUME - объем груза больше чем объем грузового отсека в автомобиле,
  • OVERLOAD_CUSTOM - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле custom),

Enum: OVERLOAD_WEIGHT, OVERLOAD_SIZE, OVERLOAD_VOLUME, OVERLOAD_CUSTOM

custom_type

Type: string

Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM.

items_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

late_duration_s*

Type: number

Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • FAILED_HARD_TIME_WINDOW - автомобиль не смог достичь места в указанное жесткое временное окно,

Enum: FAILED_HARD_TIME_WINDOW

items_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список отсутствующих необходимых тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • REQUIRED_TAGS_VIOLATION - у автомобиля нет необходимых тегов.

Enum: REQUIRED_TAGS_VIOLATION

items_3

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • EXCLUDED_TAGS_VIOLATION - в заказе есть теги, запрещенные для автомобиля.

Enum: EXCLUDED_TAGS_VIOLATION

items_4

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overrun_s*

Type: number

Величина превышения лимита на время нахождения на борту, в секундах

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • TRANSIT_TIME_VIOLATION - невозможно выполнить заказ не нарушая жёсткий лимит по времени нахождения заказа на борту,

Enum: TRANSIT_TIME_VIOLATION

items_5

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item_1[]

Список всех несовместимых пар типов грузов
Список всех пар типов грузов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_LOAD_TYPES_VIOLATION - заказ несовместим с другими заказами по виду нагрузки.

Enum: INCOMPATIBLE_LOAD_TYPES_VIOLATION

items_6

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item[]

Список всех несовместимых пар зон заказов
Список всех пар зон заказов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_ZONES_VIOLATION - заказ несовместим с другими заказами по зонам.

Enum: INCOMPATIBLE_ZONES_VIOLATION

items_7

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список зон, которые разрешается посещать автомобилю.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • ALLOWED_ZONES_VIOLATION - локация не входит ни в одну из зон, которые разрешается посещать автомобилю.

Enum: ALLOWED_ZONES_VIOLATION

items_8

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных зон.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • FORBIDDEN_ZONES_VIOLATION - локация расположена в одной из зон, запрещенных для посещения автомобилем.

Enum: FORBIDDEN_ZONES_VIOLATION

items_9

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OTHER - доставка в место невозможна по другим причинам.

Enum: OTHER

route_depot_location

Описание пункта назначения.

Name

Description

id*

Type: integer or string

Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

actual_total_service_duration_s

Type: number

Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s).

address

Type: string

Адрес локации.

crossdock_safety_waiting_duration_s

Type: number

Длительность минимального промежутка времени между моментом прибытия заказа на кросс-док склад и моментом, когда его оттуда может забрать машина для доставки. Этот промежуток нужен для того, чтобы был запас времени на случай опоздания машины, которая привозит заказы.

Default: 3600

Max value: 3153600000

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

description

Type: string

Описание пункта назначения.

finish_service_duration_s

Type: number

Продолжительность обслуживания на складе в конце маршрута. Время обслуживания включает в себя любые операции на складе, например разгрузку, сбор документов и т.д. Подробнее

Max value: 3153600000

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

flexible_start_time

Type: boolean

По умолчанию время начала работы транспортного средства совпадает либо с открытием склада, либо с открытием гаража, либо с началом смены. Если этот параметр установлен в true, транспортное средство может начать работу раньше или позже времени по умолчанию. В этом случае будет выбрано такое время начала работы транспортного средства, которое будет оптимальным с точки зрения минимизации затрат. Подробнее Кроме того, при использовании параметра flexible_start_time могут сформироваться маршруты, в которых время прибытия практически совпадет с окончанием временного окна. Такого рода маршруты, как правило, нежелательны из-за риска опоздания в пункт назначения. Во избежание таких маршрутов рекомендуется использовать параметр minimize_lateness_risk и/или penalize_late_service совместно с flexible_start_time.

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. При значении true автомобилям разрешается вернуться на склад только в пределах указанного временного окна. Подробнее

load_service_duration_s

Type: number

Дополнительное время на загрузку в машину delivery заказов, добавляемое только если на данном складе загружается хотя бы один delivery заказ.

loaded_orders

Type: (integer or string)[]

Идентификаторы заказов типа delivery, загружаемых в машину на складе или гараже.

package_throughput

Type: route_depot_location_package_throughput

Ограничение на скорость упаковки заказов на складе.

penalty

Type: route_depot_location_penalty

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

picked_orders

Type: (integer or string)[]

Список идентификаторов заказов, забираемых в кросс-доке или складе.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

point

Type: coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

preliminary_service_duration_s

Type: number

Длительность предварительного обслуживания на складе. Эта длительность может включать любые операции, которые можно выполнить до погрузки груза в автомобиль. Эти операции будут выполнены до наступления depot_ready_time грузов, погруженных на этот автомобиль. Подробнее

Max value: 3153600000

preset_id

Type: string

Номер пресета для свойств склада.

ref

Type: string

Сноска с информацией о месте.

routing_mode

Type: string

Способ передвижения, использованный для достижения данной локации.

Enum: driving, truck, walking, transit, bicycle

service_duration_s

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

throughput

Type: route_depot_location_throughput

Пропускная способность склада. Подробнее

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: route_depot_location_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

time_windows_loading

Type: route_depot_location_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

time_windows_refilling

Type: route_depot_location_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

time_windows_unloading

Type: route_depot_location_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

title

Type: string

Название места.

total_service_duration_s

Type: number

Общая длительность обслуживания на складе (равна по величине параметру service_duration_s).

Max value: 3153600000

trailer_decoupled

Type: boolean

trailer_used

Type: boolean

type

Type: string

Определяет тип склада: depot или crossdock.

  • depot — основной склад, на котором хранятся заказы.
  • crossdock — дополнительный склад, на котором изначально заказов нет. Чтобы доставлять заказы с этого склада, другая машина должна сначала привезти их из основного склада, на котором они хранятся.

Default: depot

Enum: depot, crossdock

unfeasible_reasons

Type: (items_0_9 or items_1_9 or items_2_2)[]

Список причин невозможности выполнения заказа в пункт назначения.
Причина невозможности выполнения заказа в пункт назначения.

unload_service_duration_s

Type: number

Дополнительное время на выгрузку из машины pickup заказов, добавляемое только если на данный склад доставляется хотя бы один pickup заказ.

use_in_proximity

Type: boolean

При значении false этот склад не будет учитываться при подсчете proximity и global proximity. При значении true этот склад будет учитываться при подсчете proximity и global proximity.Если же значение параметра не определено,то склад будет учитываться только при построении proximity в режиме совместимости.

route_node_depot_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

route_location_1

Описание пункта назначения.

Name

Description

id*

Type: integer or string

Идентификатор пункта назначения. Все идентификаторы в рамках задачи должны быть уникальными и иметь одинаковый тип: целое число или строка. Подробнее

actual_total_service_duration_s

Type: number

Реальная общая длительность обслуживания в пункте назначения (в соответствии с actual_arrival_time_s и actual_departure_time_s).

added_shared_service_duration_s

Type: number

Дополнительное время обслуживание адреса, для первого заказа в мультизаказе равняется shared_service_duration_sДля остальных заказов в мультизаказе может быть не 0, если shared_service_duration_s текущего заказа больше, чем у предыдущих

Max value: 3153600000

address

Type: string

Адрес локации.

allow_trailers

Type: boolean

При значении true автомобили с прицепами смогут посещать этот пункт назначения. Иначе они будут должны оставить прицеп на якорной локации перед тем, как обслуживать эту. [Подробнее](https://yandex.ru/routing/doc/vrp/concepts/properties-of-vehicles.html?lang=ru#coupling

anchor_mode

Type: string

Default: Undefined

Enum: Decoupling, Rolling, Coupling, Undefined

can_be_merged

Type: boolean

Заказ может являться частью мультизаказа

Default:

can_be_split

Type: boolean

Заказ может быть разделен на части между разными машинами.

client_id

Type: integer or string

Определяет идентификатор (id) клиента, к которому относится локация.

client_service_duration_s

Type: client_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами того же клиента (по client_id), доставляемыми в то же место.

comments

Type: string

Комментарии.

crossdock_mode

Type: string

Определяет, разрешено ли доставлять этот заказ через кросс-док склад.

  • deny — запрещено, можно доставлять только из обычного склада;
  • allow — разрешено, можно доставлять как напрямую из обычного склада, так и через кросс-док склад;
  • mandatory — обязательно, можно доставлять только через кросс-док склад.

Default: allow

Enum: deny, allow, mandatory

crossdock_service_duration_s

Type: crossdock_service_duration_0 or number

Время, проведенное на кросс-док локации во время выгрузки данного заказа. Подробнее

custom_value

Type: number

Дополнительный числовой атрибут локации (Например, вознаграждение курьера за посещение этой локации). Может быть использовано как компонент в расчёте стоимости маршрута.

delivered_orders

Type: (integer or string)[]

Список идентификаторов заказов, доставленных в drop_off, склад или кросс-док для доставки в пункт назначения.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

delivery_deadline

Type: string

Время, до которого заказ из места погрузки (pickup) без указанного поля delivery_to должен быть доставлен до любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

delivery_to

Type: integer or string

Определяет идентификатор (id) пункта назначения. Подробнее

delivery_to_any

Type: (integer or string)[]

Список идентификаторов пунктов выдачи (drop_off). Из заданного места погрузки (pickup) отправление должно быть доставлено в любой из этих пунктов выдачи. Подробнее
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

depot_duration_s

Type: depot_duration_0 or number

Время, проведенное на складе во время обработки заказа для данного пункта назначения (погрузка товаров, сбор документов и т. д.). Подробнее

depot_expiring_time

Type: string

Время, не позднее которого заказ необходимо забрать со склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

depot_id

Type: integer or string or array

depot_ready_time

Type: string

Время, начиная с которого заказ можно будет забрать с любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

description

Type: string

Описание пункта назначения.

drop_reason

Type: string

Объяснение причины удаления пункта назначения из маршрута.

dropped_ratio

Type: number

Доля заказа, которая не должна быть развезена

Max value: 1

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

fixed_run

Type: boolean

Заказ может быть доставлен только в том заезде, в котором он был запланирован

fixed_shift

Type: boolean

Заказ может быть доставлен только в той смене, в которой он был запланирован

fixed_vehicle

Type: boolean

Заказ может быть доставлен только той машиной, в которой он был запланирован

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Ограничивает возможность нарушения временных окон при планировании маршрутов. Если пункт не может быть посещен в указанное временное окно, он будет исключен из маршрута и добавлен в поле ответа dropped_orders. Это поле полезно для моделирования заказов, которые не могут быть выполнены без нарушения временного окна, например, из-за конфликта с другими заказами. Подробнее

ignore_zones_compatibility

Type: boolean

Игнорировать эффекты вызываемые свойствами incompatible_zones, allowed_zones, forbidden_zones, optional_zones для данной локации.

in_lifo_order

Type: boolean

Заказы, у которых это поле имеет значение true, не могут быть переставлены внутри машины и должны быть доставлены в порядке, обратном порядку загрузки. Пункты назначения, у которых это поле имеет значение false, могут быть в любом месте маршрута. Это поле влияет только на маршруты, в которых присутствуют заказы типов pickup и delivery одновременно. Подробнее

keep_in_vehicle

Type: boolean

При удалении заказа из маршрута, он продолжает занимать место в машине

load_types

Type: string[]

Определяет типы грузов в данном пункте назначения. Недопустимы для локаций с типом garage.
Тип груза.

loaded_orders

Type: (integer or string)[]

Идентификаторы заказов типа delivery, загружаемых в машину на складе или гараже.

max_split_parts

Type: integer

Максимальное количество частей, на которые может быть разбит заказ

Default: 10

Min value: 1

max_total_vehicles

Type: integer

Максимальное число автомобилей, которые может обслужить якорная локация. По умолчанию не ограничено. Подробнее

may_drop_in_crossdock

Type: boolean

Можно ли оставить пикап в кросс-док складе

Default:

optional_tags

Type: route_location_1_optional_tags_item[]

Список тегов, которые не обязаны быть у автомобиля, обслуживающего данный пункт назначения. Эти теги могут уменьшить или увеличить стоимость маршрута, если их удовлетворить. Подробнее
Необязательный тег с бонусом или штрафом.

parking_mode

Type: string

Тип парковки

Enum: ParkingBegin, ParkingRefill, ParkingEnd

parking_service_duration_s

Type: number

Время, необходимое для парковки автомобиля. При обслуживании заказа с использованием способов передвижения walking или transit данное время не будет затрачиваться. Если локация была выбрана в качестве парковки для пешеходной части, то данное время будет единожды затрачено перед началом части.

Max value: 3153600000

parking_type

Type: string

Enum: trailer, vehicle

penalty

Type: route_location_1_penalty

Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее

phone

Type: string

Номер телефона получателя при доставке.

picked_orders

Type: (integer or string)[]

Список идентификаторов заказов, забираемых в кросс-доке или складе.
Ссылка на пункт назначения, указанный в параметре locations. Подробнее

pickup_from_any

Type: boolean

Delivery-заказы, у которых это поле имеет значение true, должны иметь несколько связанных с ним pickup-заказов. Для доставки может быть выбран любой один из этих pickup-заказов, а остальные будут проигнорированы. Выбор среди вариантов осуществляется с учетом оптимизации стоимости маршрута. Подробнее

pickup_id

Type: integer or string

Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

pickup_ids

Type: (integer or string)[]

Список идентификаторов пунктов назначения типа pickup, из которых производится доставка в этот пункт назначения.
Идентификатор пункта назначения типа pickup, из которого производится доставка в этот пункт назначения.

pickup_must_reach_depot

Type: boolean

Данное поле определяет считать ли pickup-локацию обслуженной, если она не доставлена на склад. Запрещено указывать для локаций типов отличных от pickup. Запрещено использовать совместно с полями delivery_to и delivery_to_any. Если у локации определен список допустимых складов, то считается, что заказ нужно довести до склада, в это случае запрещено указывать в поле значение False.

point

Type: coordinate_2

Координаты пункта назначения в формате WGS84. Подробнее

preset_id

Type: string

Номер пресета для свойств пункта назначения.

quant

Type: number or quant_0_1

ref

Type: string

Сноска с информацией о месте.

required_tags

Type: string[]

Список тегов, которые должны быть у автомобиля, обслуживающего данный пункт назначения. Подробнее
Произвольный тег.

rolling_throughput

Type: route_location_1_rolling_throughput

Пропускная способность перекатки (поддерживается для якорных точек).

routing_mode

Type: string

Способ передвижения, использованный для достижения данной локации.

Enum: driving, truck, walking, transit, bicycle

sequence_order

Type: integer

Все локации в маршруте транспортного средства, у которых указана данная опция, должны быть посещены в порядке неубывания ее значений. Подробнее

service_duration_s

Type: service_duration_2_0 or number

Длительность обслуживания в пункте назначения. Длительность обслуживания может включать любые операции в пункте назначения, например, погрузка или выгрузка транспортного средства, а также любое другое время, связанное с пунктом назначения (кроме времени ожидания, которое рассчитывается как разность между временем прибытия и началом обслуживания). Подробнее

service_durations

Type: service_durations

Структура, в которой задаются времена обслуживания для локации.

service_waiting_duration_s

Type: number

Продолжительность ожидания обслуживания в пункте назначения. Она может быть ненулевой, когда, например, заказ входит в состав мультизаказа. В этом случае длительность ожидания включает в себя длительность обслуживания других заказов из мультизаказа.

Max value: 3153600000

shared_service_duration_s

Type: shared_service_duration_0 or number

Длительность обслуживания в пункте назначения, совместная с другими заказами, доставляемыми в то же место. Длительность совместного обслуживания может включать такие операции, как парковка, доставка документов и другие. Подробнее

shared_with_company_ids

Type: integer[]

ID компаний, которые могут получить доступ к информации о заказе.

shipment_size

Type: route_location_1_shipment_size

Размер отправления (метрические размеры и/или вес). Подробнее

soft_depot_expiring_time

Type: string

Время, не позднее которого заказ необходимо забрать со склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z

soft_depot_ready_time

Type: string

Время, начиная с которого заказ можно будет забрать с любого склада, в формате [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00, 2018-09-06T10:15:00Z. Подробнее

split_info

Type: route_location_1_split_info

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

split_parts_must_fill_whole_vehicle

Type: boolean

Части, отделяемые от разделяемого заказа, должны заполнять машину целиком.

throughput

Type: route_location_1_throughput

Пропускная способность заказа (поддерживается для разделяемых заказов).

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: route_location_1_time_windows_item[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

title

Type: string

Название места.

total_service_duration_s

Type: number

Общая длительность обслуживания в пункте назначения, включающая service_duration_s, added_shared_service_duration_s parking_service_duration_s и service_waiting_duration_s.

Max value: 3153600000

trailer_decoupled

Type: boolean

trailer_used

Type: boolean

transit_time

Type: route_location_1_transit_time

Ограничение на время нахождения заказа на борту

type

Type: string

Определяет тип обслуживания в пункте назначения: delivery, pickup или drop_off.

  • delivery — осуществляется доставка в пункт назначения.
  • pickup — осуществляется погрузка для доставки в другой пункт назначения (если указано delivery_to) или в depot.
  • drop_off — груз из pickup может быть доставлен в любую из точек drop_off (см. delivery_to_any).
  • garage — место, которое может быть указано как начальная или конечная точка маршрута с помощью свойств start_at и finish_at у vehicle.
  • anchor — якорная локация, на которой можно оставить прицеп и перенести груз в голову.
  • parking — место, где можно оставить прицеп, чтобы посетить одну другую локацию. На этих локациях нельзя разгружать прицепы.
  • rest_place — место, где машина может останавливаться на перерыв в случае если у перерыва указан атрибут "at_rest_place". Подробнее

Default: delivery

Enum: depot, crossdock, delivery, pickup, drop_off, garage, anchor, parking, rest_place

undroppable

Type: boolean

Локацию нельзя удалять из маршрута

unfeasible_reasons

Type: (items_0_4 or items_1_4 or items_2_1 or items_3_1 or items_4_1 or items_5_1 or items_6_1 or items_7_1 or items_8_1 or items_9_1)[]

Список причин невозможности выполнения заказа в пункт назначения.
Причина невозможности выполнения заказа в пункт назначения.

use_in_proximity

Type: boolean

При значении false этот пункт назначения не будет учитываться при подсчете proximity и global proximity. Подробнее

Default:

route_node_location_1_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

route_work_break

Описание перерыва.

Name

Description

rest_duration_s*

Type: number

Продолжительность отдыха, в секундах.

Min value: 0.001

Max value: 3153600000

after_last_location

Type: boolean

При значении true перерыв будет находиться после последнего пункта назначения. Если возможно, он будет объединен с первым перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно после обслуживания последнего пункта назначения.

at_rest_place

Type: boolean

При значении true машина будет заезжать на отдых в локацию с типом "rest_place"

before_first_location

Type: boolean

При значении true перерыв будет находиться перед первым пунктом назначения. Если возможно, он будет объединен с последним перерывом одного из типов, указанных в поле merge_with_types, иначе он будет непосредственно перед обслуживанием первого пункта назначения.

chain_number

Type: integer

Порядковый номер цепочки, к которой относится перерыв.

continuous_travel_time_range

Type: string

Минимальная и максимальная продолжительность непрерывного движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

driving_time_range

Type: string

Минимальная и максимальная продолжительность движения до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

exact_time_range

Type: string

Точный диапазон времени, когда должен начаться отдых, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

fixed_position

Type: boolean

Локацию нельзя перемещать и вставлять перед ней другие локации

merge_with_types

Type: string[]

Типы перерывов, с которыми этот перерыв может быть объединен. Это поле может быть использовано только вместе с полями before_first_location и after_last_location.

necessary_route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы сделать перерыв обязательным, в секундах.

Max value: 3153600000

penalty

Type: route_work_break_penalty

Штрафы, применяемые за нарушения условий перерывов в работе.

repeatable

Type: boolean

При значении true перерыв будет повторяться до конца маршрута. Можно указывать true только для последнего перерыва в цепочке.

route_duration_s

Type: number

Минимальная продолжительность маршрута, необходимая, чтобы использовать перерыв, в секундах.

Max value: 3153600000

travel_time_range

Type: string

Минимальная и максимальная продолжительность движения и ожидания до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

type

Type: string

Тип перерыва. Используется в поле merge_with_types.

work_duration_s

Type: number

Продолжительность непрерывной работы до перерыва на отдых, в секундах.

Max value: 3153600000

work_time_range_from_start

Type: string

Минимальное и максимальное время от начала маршрута до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

work_time_range_till_rest

Type: string

Минимальная и максимальная продолжительность работы до отдыха, формат: [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] ("04:00 - 05:30").

route_node_work_break_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

route_courier_position

Name

Description

location_id*

Type: string

Идентефикатор текущей локации

passed_time_s

Type: number

Время прошедшее после посещения курьером текущей локации. Считается что в следующую локацию за это время курьер еще не приехал.

route_node_courier_position_used_projection

Координаты пункта назначения в формате WGS84. Подробнее

Name

Description

lat*

Type: number

Min value: -90

Max value: 90

lon*

Type: number

Min value: -180

Max value: 180

_incompatibilities_item_5

Список всех пар типов грузов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

types*

Type: items_types_item_2[]

_incompatibilities_item_4

Список всех пар зон заказов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

zones*

Type: items_zones_item_2[]

_incompatibilities_item_1

Список всех пар типов грузов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

types*

Type: items_types_item[]

_incompatibilities_item

Список всех пар зон заказов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

zones*

Type: items_zones_item[]

route_depot_location_package_throughput

Ограничение на скорость упаковки заказов на складе.

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

route_depot_location_penalty

Штрафы за несоблюдение временного окна или пропускной способности склада. Подробнее

Name

Description

early

Type: penalty_early_30

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

late

Type: penalty_late_30

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

out_of_time

Type: penalty_out_of_time_21

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

package_throughput

Type: penalty_package_throughput_3

Составляющие штрафа за превышение пропускной способности упаковки заказов.

throughput

Type: penalty_throughput_11

Составляющие штрафа за превышение пропускной способности.

route_depot_location_throughput

Пропускная способность склада. Подробнее

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

route_depot_location_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

route_depot_location_time_windows_loading

Временные окна, в которые машина может выехать со склада на первый заезд

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_loading_time_windows_item_3[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

route_depot_location_time_windows_refilling

Временные окна, в которые машина может заехать на склад (или промежуточноый склад) для дозагрузки

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_refilling_time_windows_item_3[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

route_depot_location_time_windows_unloading

Временные окна, в которые машина может вернуться на склад после последнего заезда

Name

Description

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

hard_window

Type: boolean

Временное окно, указаное в поле "time_window", должно быть жестким, несовместимо с полем "hard_time_window".

penalty

Type: any

time_window

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

time_windows

Type: time_windows_unloading_time_windows_item_3[]

Список разрешенных временных окон. Временные окна не могут пересекаться. Поля time_window и time_windows — взаимоисключающие. Соответствующее дочернее поле hard_time_window должно быть определено для всех time_window, либо ни для одного из них. Подробнее

items_0_9

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

late_duration_s*

Type: number

Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • FAILED_HARD_TIME_WINDOW - автомобиль не смог достичь места в указанное жесткое временное окно,

Enum: FAILED_HARD_TIME_WINDOW

items_1_9

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overrun_s*

Type: number

Величина превышения лимита на время нахождения на борту, в секундах

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • TRANSIT_TIME_VIOLATION - невозможно выполнить заказ не нарушая жёсткий лимит по времени нахождения заказа на борту,

Enum: TRANSIT_TIME_VIOLATION

items_2_2

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OTHER - доставка в место невозможна по другим причинам.

Enum: OTHER

route_location_1_optional_tags_item

Необязательный тег с бонусом или штрафом.

Name

Description

tag*

Type: string

Произвольный тег.

value*

Type: number

Значение тега. Если заказ доставлен автомобилем с соответствующим тегом в поле tags, то это значение будет вычтено из стоимости маршрута. Если соответствующий тег находится в поле excluded_tags, то это значение будет прибавлено к стоимости.

route_location_1_penalty

Штрафные санкции за невыполнение заказа и нарушение временного окна. Подробнее

Name

Description

delivery_deadline

Type: penalty_delivery_deadline_1

Составляющие штрафа за позднюю доставку заказа типа pickup на склад. Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее

depot_expiring_time

Type: penalty_depot_expiring_time_1

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

depot_ready_time

Type: penalty_depot_ready_time_1

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

drop

Type: drop_0_1 or number

Штраф за невыполнение заказа. Подробнее

early

Type: penalty_early_9

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

late

Type: penalty_late_9

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

out_of_time

Type: penalty_out_of_time_9

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

rolling_throughput

Type: penalty_rolling_throughput_1

Составляющие штрафа за превышение пропускной способности.

throughput

Type: penalty_throughput_3

Составляющие штрафа за превышение пропускной способности.

time_between_visits

Type: penalty_time_between_visits_1

Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.

transit_time

Type: any

Составляющие штрафа за превышение времени нахождения заказа на борту

quant_0_1

Размер минимальной части, которая может быть отделена от заказа, в одной из единиц измерения

Name

Description

units

Type: number

Размер минимальной части в пользовательских единицах измерения.

volume_cbm

Type: number

Объем минимальной части, кубические метры.

weight_kg

Type: number

Вес минимальной части, кг.

route_location_1_rolling_throughput

Пропускная способность перекатки (поддерживается для якорных точек).

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

route_location_1_shipment_size

Размер отправления (метрические размеры и/или вес). Подробнее

Name

Description

custom

Type: number

Размер отправления в пользовательских единицах измерения. Размеры в пользовательских единицах задаются в формате "name": size, где name — строка, обозначающая название единицы, а size — неотрицательное вещественное число, обозначающее количество соответствующих единиц в отправлении. Если название единицы присутствует в других объектах (локациях/транспортных средствах/прицепах), но не в этом, то количество этих единиц в отправлении полагается равным нулю. Подробнее

units

Type: number

Размер отправления в пользовательских единицах измерения.

Max value: 1000000000

volume

Type: shipment_size_volume_1

Метрические размеры отправления.

volume_cbm

Type: number

Явно заданный объем, кубические метры. По умолчанию берется значение из "volume", если тут ничего не указать.

weight_kg

Type: number

Вес отправления, кг.

Max value: 1000000000

route_location_1_split_info

Информация об отдельной части заказа (в случае, если заказ был разделен на части)

Name

Description

order_ratio

Type: number

Доля заказа, входящая в данную часть.

part_id

Type: integer

Номер данной части заказа.

parts_count

Type: integer

Количество частей, на которые был разбит заказ.

units

Type: number

Вес данной части в пользовательских единицах измерения (при условии, что для заказа был задан соотвествующий квант).

volume_cbm

Type: number

Объем данной части, кубические метры (при условии, что для заказа был задан соотвествующий квант).

weight_kg

Type: number

Вес данной части части, кг (при условии, что для заказа был указан соотвествующий квант).

route_location_1_throughput

Пропускная способность заказа (поддерживается для разделяемых заказов).

Name

Description

kg_per_hour

Type: array or number

units_per_hour

Type: array or number

vehicle_count

Type: array or number

route_location_1_time_windows_item

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

route_location_1_transit_time

Ограничение на время нахождения заказа на борту

Name

Description

hard_limit_s

Type: number

Жёсткое ограничение, не может быть превышено

Max value: 1000000000

limit_s

Type: number

Мягкое ограничение, превышение допустимо, но ведёт к штрафам

Max value: 1000000000

items_0_4

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overload*

Type: number

Значение перегруза. Единица измерения зависит от типа перегруза:

  • OVERLOAD_WEIGHT - перегруз в кг.
  • OVERLOAD_SIZE - избыточный размер в пользовательских единицах измерения (поле units).
  • OVERLOAD_VOLUME - избыточный объем в м^3.
  • OVERLOAD_CUSTOM - избыточный размер в пользовательских единицах измерения (поле custom).

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OVERLOAD_WEIGHT - автомобиль перегружен,
  • OVERLOAD_SIZE - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле units),
  • OVERLOAD_VOLUME - объем груза больше чем объем грузового отсека в автомобиле,
  • OVERLOAD_CUSTOM - груз не поместился в автомобиль на основании его размера в пользовательских единицах (поле custom),

Enum: OVERLOAD_WEIGHT, OVERLOAD_SIZE, OVERLOAD_VOLUME, OVERLOAD_CUSTOM

custom_type

Type: string

Тип пользовательских единиц, вызвавших перегруз, в случае OVERLOAD_CUSTOM.

items_1_4

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

late_duration_s*

Type: number

Длительность опоздания, вычисляется по формуле: (время прибытия) – (время завершения временного окна), в секундах.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • FAILED_HARD_TIME_WINDOW - автомобиль не смог достичь места в указанное жесткое временное окно,

Enum: FAILED_HARD_TIME_WINDOW

items_2_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список отсутствующих необходимых тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • REQUIRED_TAGS_VIOLATION - у автомобиля нет необходимых тегов.

Enum: REQUIRED_TAGS_VIOLATION

items_3_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных тегов.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • EXCLUDED_TAGS_VIOLATION - в заказе есть теги, запрещенные для автомобиля.

Enum: EXCLUDED_TAGS_VIOLATION

items_4_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

overrun_s*

Type: number

Величина превышения лимита на время нахождения на борту, в секундах

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • TRANSIT_TIME_VIOLATION - невозможно выполнить заказ не нарушая жёсткий лимит по времени нахождения заказа на борту,

Enum: TRANSIT_TIME_VIOLATION

items_5_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item_3[]

Список всех несовместимых пар типов грузов
Список всех пар типов грузов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_LOAD_TYPES_VIOLATION - заказ несовместим с другими заказами по виду нагрузки.

Enum: INCOMPATIBLE_LOAD_TYPES_VIOLATION

items_6_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

incompatibilities*

Type: _incompatibilities_item_2[]

Список всех несовместимых пар зон заказов
Список всех пар зон заказов, несовместимых с заказом.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • INCOMPATIBLE_ZONES_VIOLATION - заказ несовместим с другими заказами по зонам.

Enum: INCOMPATIBLE_ZONES_VIOLATION

items_7_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список зон, которые разрешается посещать автомобилю.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • ALLOWED_ZONES_VIOLATION - локация не входит ни в одну из зон, которые разрешается посещать автомобилю.

Enum: ALLOWED_ZONES_VIOLATION

items_8_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

tags*

Type: string[]

Список указанных запрещенных зон.

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Possible reasons:

  • FORBIDDEN_ZONES_VIOLATION - локация расположена в одной из зон, запрещенных для посещения автомобилем.

Enum: FORBIDDEN_ZONES_VIOLATION

items_9_1

Причина невозможности выполнения заказа в пункт назначения.

Name

Description

text*

Type: string

Объяснение причины невозможности выполнения заказа.

type*

Type: string

Возможные причины:

  • OTHER - доставка в место невозможна по другим причинам.

Enum: OTHER

route_work_break_penalty

Штрафы, применяемые за нарушения условий перерывов в работе.

Name

Description

early

Type: penalty_early_26

Составляющие штрафа за ранний перерыв в работе.

late

Type: penalty_late_26

Составляющие штрафа за поздний перерыв в работе.

items_types_item_2

Name

Description

other_type*

Type: string

Тип груза в несовместимом заказе.

self_type*

Type: string

Тип груза в текущем заказе.

items_zones_item_2

Name

Description

other_zone*

Type: string

Зона несовместимого заказа.

self_zone*

Type: string

Зона текущего заказа.

items_types_item

Name

Description

other_type*

Type: string

Тип груза в несовместимом заказе.

self_type*

Type: string

Тип груза в текущем заказе.

items_zones_item

Name

Description

other_zone*

Type: string

Зона несовместимого заказа.

self_zone*

Type: string

Зона текущего заказа.

kg_per_hour_0_item_20

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, кг/ч.

units_per_hour_0_item_20

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность упаковки на складе, измеряемая в пользовательских единицах измерения в час.

penalty_early_30

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство начинает обслуживать склад до начала выбранного временного окна. Штраф начисляется за раннее обслуживание, будь то открытие склада, разгрузка или загрузка посреди маршрута, или же закрытие склада. Если транспортное средство посетило склад несколько раз, штраф начисляется за каждое раннее посещение.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего обслуживания склада. Случаи применения совпадают с указанными в поле fixed.

Default: 17

penalty_late_30

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф за каждое посещение склада после окончания выбранного заданного временного окна. Старт со склада считается его посещением.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания в случае посещения склада после окончания временного окна.

Default: 17

penalty_out_of_time_21

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если транспортное средство посещает склад вне заданного временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту нахождения за пределами временного окна склада. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_package_throughput_3

Составляющие штрафа за превышение пропускной способности упаковки заказов.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

penalty_throughput_11

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

kg_per_hour_0_item_19

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_19

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_16

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

time_windows_loading_time_windows_item_3

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_refilling_time_windows_item_3

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

time_windows_unloading_time_windows_item_3

Name

Description

time_window*

Type: string

Разрешенное окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Подробнее

hard_time_window

Type: string

Разрешенное жесткое окно посещения пункта назначения, в формате [D.]HH[:MM[:SS]] - [D.]HH[:MM[:SS]] или ISO 8601 2018-09-06T10:15:00+03:00/2018-09-06T12:45:00+03:00, 2018-09-06T10:15:00Z/2018-09-06T12:45:00Z. Жесткое окно должно включать в себя соответствующий временной промежуток из поля time_window. Поля hard_time_window и hard_window — взаимоисключающие. Подробнее

penalty_delivery_deadline_1

Составляющие штрафа за позднюю доставку заказа типа pickup на склад. Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания. Подробнее

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения склада после дедлайна.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания, когда склад посещается после дедлайна.

Default: 17

penalty_depot_expiring_time_1

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

penalty_depot_ready_time_1

Составляющие штрафа за нарушение допустимого времени для загрузки заказа в депо.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за нарушение вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

drop_0_1

Name

Description

fixed

Type: number

Фиксированный штраф за невыполнение любой части заказа.

scaled

Type: number

Штраф за недоставленную долю заказа.

Default: 1000000

penalty_early_9

Составляющие штрафа за раннее обслуживание (используются вместо штрафа out_of_time).

Name

Description

fixed

Type: number

Фиксированный штраф за обслуживание объекта, начатое раньше выбранного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего прибытия, если обслуживание объекта было начато раньше выбранного временного окна.

Default: 17

penalty_late_9

Составляющие штрафа за позднее посещение (используются вместо штрафа out_of_time). Опция penalize_late_service определяет, используется ли для начисления этого штрафа время начала или окончания обслуживания.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения после окончания заданного временного окна.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания, когда место посещается после окончания временного окна.

Default: 17

penalty_out_of_time_9

Составляющие штрафных санкций за нарушение временного окна. Выставляют одинаковое значение для штрафов early и late, каждый из которых может быть переписан соответствующей опцией, если она тоже определена.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае посещения пункта назначения вне заданного временного окна. См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 1000

minute

Type: number

Штраф за каждую минуту опоздания или раннего прибытия при посещении объекта за пределами временного окна.См. спецификации штрафов early и late с точным описанием механики в обоих случаях.

Default: 17

penalty_rolling_throughput_1

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

penalty_throughput_3

Составляющие штрафа за превышение пропускной способности.

Name

Description

fixed

Type: number

Фиксированный штраф в случае превышения пропускной способности.

Default: 1000

kg

Type: number

Штраф за каждый лишний килограмм превышения пропускной способности.

Default: 50

unit

Type: number

Штраф за каждое дополнительное превышение пропускной способности, измеряемое в пользовательских единицах измерения (поле units).

Default: 100

vehicle

Type: number

Штраф за каждый час превышения на единицу пропускной способности, измеряемой в а/м.

Default: 100000

penalty_time_between_visits_1

Составляющие штрафа за превышение допустимого времени между посещениями частей заказа.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый за каждый случай нарушения вне зависимости от размера нарушения.

Default: 1000

minute

Type: number

Штраф за каждую минуту нарушения.

Default: 17

kg_per_hour_0_item_7

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_7

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_5

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

shipment_size_volume_1

Метрические размеры отправления.

Name

Description

depth_m*

Type: number

Глубина, в метрах.

Max value: 1000000

height_m*

Type: number

Высота, в метрах.

Max value: 1000000

width_m*

Type: number

Ширина, в метрах.

Max value: 1000000

align

Type: string

Выравнивание отправления по осям (не имеет эффекта для типа bulk):

  • all_axes — полное выравнивание (по умолчаниию), груз должен быть размещен параллельно осям транспортного средства;
  • height — выравнивание по высоте, разрешены произвольные вращения в двух других размерностях (для типа rigid в качестве высоты можно выбрать любую из размерностей). Подробнее

Default: all_axes

Enum: all_axes, height

type

Type: string

Тип отправления:

  • bulk — сыпучий (по умолчанию), может произвольно изменять форму;
  • rigid — жесткий, можно крутить, но нельзя изменять форму;
  • fixed_bottom — жесткий с фиксированным дном, крутить можно только в двух измерениях (фиксированное измерение — height). Подробнее

Default: bulk

Enum: bulk, rigid, fixed_bottom

kg_per_hour_0_item_6

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, кг/ч.

units_per_hour_0_item_6

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, измеряемая в пользовательских единицах измерения в час.

vehicle_count_0_item_4

Name

Description

time_window

Type: string

Временное окно, во время которого действует указанное ограничение. Окна не должны пересекаться между собой, а их объединение должно содержать в себе все время работы склада. Если на каком-либо временном интервале вне времени работы склада ограничение не определено, то оно считается равным нулю.

value

Type: number

Пропускная способность, одновременно находящиеся а/м.

Max value: 1000000000

_incompatibilities_item_3

Список всех пар типов грузов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

types*

Type: items_types_item_1[]

_incompatibilities_item_2

Список всех пар зон заказов, несовместимых с заказом.

Name

Description

incompatible_order_id*

Type: integer or string

Ссылка на пункт назначения, указанный в параметре locations. Подробнее

zones*

Type: items_zones_item_1[]

penalty_early_26

Составляющие штрафа за ранний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту раннего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых меньше, чем указанная минимальная продолжительность работы.

Default: 17

penalty_late_26

Составляющие штрафа за поздний перерыв в работе.

Name

Description

fixed

Type: number

Фиксированный штраф, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 1000

minute

Type: number

Штраф за каждую минуту позднего начала перерыва в работе, применяемый в случае, если работник начинает перерыв на отдых, проработав с начала работы или с конца предыдущего перерыва на отдых больше, чем указанная максимальная продолжительность работы.

Default: 17

items_types_item_1

Name

Description

other_type*

Type: string

Тип груза в несовместимом заказе.

self_type*

Type: string

Тип груза в текущем заказе.

items_zones_item_1

Name

Description

other_zone*

Type: string

Зона несовместимого заказа.

self_zone*

Type: string

Зона текущего заказа.

Responses

202 Accepted

Задача поставлена в очередь на выполнение.

Body

application/json
{
    "id": "string",
    "message": "string",
    "status": {
        "cancelled": 0,
        "completed": 0,
        "estimate": 0,
        "queued": 0,
        "started": 0
    }
}

Name

Description

id*

Type: string

Уникальный id задачи.

status*

Type: task_info_1_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

message

Type: string

Описание состояния задачи.

task_info_1_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

Name

Description

queued*

Type: number

Задача поставлена в очередь на выполнение.

cancelled

Type: number

Выполнение задачи отменено пользователем или системой в связи с ошибкой или истечением времени ожидания.

completed

Type: number

Выполнение задачи закончено успешно или с ошибкой.

estimate

Type: number

Оценочное время решения задачи. Оценка может меняться в процессе решения. Оценка верна примерно в 75% случаев (задачи решаются за 5-15 секунд до estimate). Для некоторых задач фактическое время решения может быть больше, чем указано в estimate (обычно, не более чем на 1 минуту).

started

Type: number

Началось выполнение задачи.

400 Bad Request

Недопустимый или пустой JSON в теле POST-запроса.

Body

application/json
{
    "error": {
        "incident_id": "string",
        "message": "string"
    }
}

Name

Description

error*

Type: error_2_error

Описание ошибки.

error_2_error

Описание ошибки.

Name

Description

message*

Type: string

Сообщение с описанием ошибки.

incident_id

Type: string

Уникальный идентификатор инцидента c ошибкой. При ошибке API этот идентификатор может использоваться при анализе проблем.

401 Unauthorized

Отсутствует API-ключ.

Body

application/json
{
    "error": {
        "incident_id": "string",
        "message": "string"
    }
}

Name

Description

error*

Type: error_2_error

Описание ошибки.

429 Too Many Requests

Слишком много запросов.

Body

application/json
{
    "error": {
        "incident_id": "string",
        "message": "string"
    }
}

Name

Description

error*

Type: error_2_error

Описание ошибки.

500 Internal Server Error

Ошибка сервера при обработке запроса.

Body

application/json
{
    "error": {
        "incident_id": "string",
        "message": "string"
    }
}

Name

Description

error*

Type: error_2_error

Описание ошибки.

503 Service Unavailable

Недостаточно ресурсов для выполнения задачи.

Body

application/json
{
    "error": {
        "incident_id": "string",
        "message": "string"
    }
}

Name

Description

error*

Type: error_2_error

Описание ошибки.