Для интеграции курьерского модуля Aqua Delivery и внешней системы требуется организовать обмен маршрутными листами.

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

Пример

POST /route/import/

{
  "id": "2e67e5af-f9f0-492b-b971-b8c94734267e",
  "from": "2021-10-19T15:00:00",
  "to": "2021-10-19T18:00:00",
  "driver": {
    "car": {
      "model": "Aston Martin DBS V12",
      "number": "A001AA11",
      "color": "blue",
      "order_capacity": 100,
      "bottle_capacity": 100
    },
    "id": "2e67e5af-f9f0-492b-b971-b8c94734267f",
    "external_id": "1",
    "account_number": 1,
    "username": "Джеймс Бонд",
    "type": "fiz",
    "email": "[email protected]",
    "phones": [
      "+7(908)328-08-32"
    ]
  },
  "orders": [
    {
      "position": 1,
      "id": "657f9553-ff97-11e9-80d3-001e4f377cd7",
      "external_id": null,
      "payment_type": "cash",
      "comment": "comment",
      "shipping_date_from": "2021-10-19T16:00:00",
      "shipping_date_to": "2019-10-19T18:00:00",
      "status": "new",
      "total": 710,
      "delivery_cost": 30,
      "coins": 710,
      "order_item_list": [
        {
          "name": "Вода 19 л. Ваш бренд",
          "id": "78e66cef-ae2c-11e6-9bf1-f8a9634f667f",
          "external_id": "1",
          "product_id": "78e66cef-ae2c-11e6-9bf1-f8a9634f667f",
          "price": 355,
          "quantity": 2,
          "order_product_id": 1435
        }
      ],
      "shipping_address": {
        "city": "Сыктывкар",
        "street": "Кутузова",
        "house": "19",
        "entrance": null,
        "floor": null,
        "room": null,
        "latitude": null,
        "longitude": null,
        "str": "город Сыктывкар улица Кутузова дом 19"
      },
      "client": {
        "id": "jqLbQR3be8jlJZIh4dBrUCyyIhFzuAKK",
        "external_id": "68",
        "account_number": 68,
        "type": "fiz",
        "name": "Василий Тестовый",
        "username": "+79999999999",
        "phone": "+79999999999",
        "email": "[email protected]",
        "addresses": [
          {
            "id": "78e66cef-ae2c-11e6-9bf1-f8a9634f667f",
            "external_id": null,
            "city": "Сыктывкар",
            "street": "Кутузова",
            "house": "19",
            "entrance": null,
            "floor": null,
            "room": null,
            "latitude": null,
            "longitude": null,
            "str": "город Сыктывкар улица Кутузова дом 19"
          }
        ]
      }
    }
  ],
  "comment": "Давай сделаем это быстро"
}

• Интервал доставки заказов внутри маршр. листа должен соответствовать интервалу доставки всего маршр. листа (интервалы должны пересекаться);
• to должно быть больше, чем from;
• минимум один заказ в списке;
• order.position должно быть уникально по всем переданным заказам;
• время надо передавать в UTC, формат ATOM (YYYY-MM-DDThh:mm:ss).

Обязательные поля

• id
• from дата начала интервала доставки
• to
• driver
  • прользовательские поля смотри тут
• orders
  • position очередность доставки заказа
  • остальные поля смотри тут

Ответ

Если в ответе вернулся 201 код, то запрос считается успешно обработанным. В противном случае в теле ответа будет возвращен массив ошибок:

{
	"errors": [
		"Маршрутный лист не содержит заказы"
	]
}

TODO

• актуализировать схему БД - сделать поля для авто nullable