Налаштування доставки та перевізники¶

Базова адреса для функцій роботи з налаштуваннями доставки та перевізників /delivery/.

Список складів або вулиць по перевізнику
Отримати список міст для перевізника
Підтвердження створення налаштування доставки
Встановити налаштування доставки за замовчуванням
Отримати назву вулиці міста
Отримати таблицю виїздів
Список отримувачів
Створити отримувача
Список перевізників
Список областей
Налаштування доставки
Створити налаштування доставки
Відслідкувати ТТН
Список міст області
Видалити контактну особу
Інформація про перевізника
Видалити налаштування доставки

Список складів або вулиць по перевізнику ¶

GET /delivery/carriers/warehouses¶

Параметр	Опис
city	ID Міста.
carrier	ID Перевізника.
q	Фільтр по назві складу перевізника або вулиці.
filter	Фільтр по акціям може приймати значення `warehouses`, `streets`, `all`. За замовчуванням, `warehouses`.
page	Сторінка видачі.
per_page	К-сть елементів у видачі

Примітка

Якщо параметр city або carrier вказано невірно - буде повернуто відповідь 422 Unprocessable Entity

Отримати список міст для перевізника ¶

GET /delivery/carrier/cities¶

Query Parameters:
	region – ID Області (Обов’язковий). carrier – ID перевізника (Обов’язковий). is_address – Адресна доставка. За замовчуванням - False.

Приклад отримання міст Волинської області для перевізника Автолюкс:

https://api.bm.parts/delivery/carrier/cities?region=92AF000C2947F7AE11E2D3FE8D64FA92&carrier=831E363AB41B7A4E4BFDE7409AF354DD

Відповідь:

{
  "cities": [
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A193",
      "name": "Дніпро"
    },
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A19B",
      "name": "Кам'янське"
    },
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A19E",
      "name": "Кривий Ріг"
    },
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A1AD",
      "name": "Нікополь"
    },
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A1B0",
      "name": "Новомосковськ"
    },
    {
      "uuid": "92AF000C2947F7AE11E2D3FFF549A1B4",
      "name": "Павлоград"
    }
  ]
}

Підтвердження створення налаштування доставки ¶

POST /delivery/config/confirm¶

Query Parameters:
	code – Код підтвердження з повідомлення

У випадку вдалого підтвердження вертається статус 201

{
    "success": true
}

Встановити налаштування доставки за замовчуванням ¶

POST /delivery/config/default¶

Query Parameters:
	config_uuid – ID налаштування доставки

Приклад відповіді:

{
    "success": true
}

Отримати назву вулиці міста ¶

GET /delivery/city/streets¶

Query Parameters:
	street – Часткова назва вулиці. city – ID Міста.

Приклад запиту:

https://api.bm.parts/delivery/city/streets?street=вул&city=92AF000C2947F7AE11E2D4000A5E5D45

Приклад відповіді для запиту з параметрами - street=вул, city=92AF000C2947F7AE11E2D4000A5E5D45

{
    "streets": [
        "вул. 1-го Травня",
        "вул. 17-го вересня"
    ]
}

Отримати таблицю виїздів ¶

GET /delivery/departures¶

Query Parameters:
	warehouse – ID складу. За замовчуванням основний склад city – ID міста доставки. За замовчуванням основне місто

Приклад відповіді:

[
    {
      "uuid": "831E363AB41B7A4E4BFDE7409AF354DD",
      "name": "Автолюкс",
      "discount_delivery": 0.00,
      "discount_money": 0.00,
      "departures": [
        {
          "receipt_date": "2018-07-28T12:00:00Z",
          "departure_date": "2018-07-28T12:30:00Z"
        }
      ]
    },
    {
      "uuid": "B7E343EA4512F2BC41960C93EF5A7C7D",
      "name": "Гюнсел",
      "discount_delivery": 10.00,
      "discount_money": 0.00,
      "departures": [
        {
          "receipt_date": "2018-07-27T17:00:00Z",
          "departure_date": "2018-07-27T18:00:00Z"
        }
      ]
    }
]

Список отримувачів ¶

GET /delivery/receivers¶

Приклад відповіді:

{
  "receivers": [
    {
      "full_name": "Фамилия Имя Отчество",
      "uuid": "81C9005056AC66D611E86E83DDAEDE97"
    }
  ]
}

Створити отримувача ¶

POST /delivery/receivers¶

Query Parameters:
	surname – Прізвище name – Ім’я middle_name – По батькові phone – Телефон в форматі `380966477711` або `+380956477711`

Метод вертає статус 201 Created при вдалому створенні контактного лиця.

Список перевізників ¶

GET /delivery/carriers¶

{
  "carriers": [
    {
      "address_delivery": false,
      "warehouses_url": "https://api.bm.parts/delivery/carriers/warehouses?carrier=831E363AB41B7A4E4BFDE7409AF354DD",
      "discount_delivery": 0.0,
      "discount_money": 0.0,
      "warehouses_count": 167,
      "name": "Автолюкс",
      "uuid": "831E363AB41B7A4E4BFDE7409AF354DD"
    },
    {
      "address_delivery": false,
      "warehouses_url": "https://api.bm.parts/delivery/carriers/warehouses?carrier=A1D5CECB05F23C9D430E95281E004524",
      "discount_delivery": 0.0,
      "discount_money": 0.0,
      "warehouses_count": 0,
      "name": "Автостанція",
      "uuid": "A1D5CECB05F23C9D430E95281E004524"
    },
    {
      "address_delivery": false,
      "warehouses_url": "https://api.bm.parts/delivery/carriers/warehouses?carrier=B7E343EA4512F2BC41960C93EF5A7C7D",
      "discount_delivery": 10.0,
      "discount_money": 0.0,
      "warehouses_count": 133,
      "name": "Гюнсел",
      "uuid": "B7E343EA4512F2BC41960C93EF5A7C7D"
    }
  ]
}

Список областей ¶

GET /delivery/regions¶

Приклад відповіді:

{
  "regions": [
    {
      "cities_url": "https://api.bm.parts/delivery/region/92AF000C2947F7AE11E2D3FE8D64FA90/cities",
      "name": "Вінницька область",
      "uuid": "92AF000C2947F7AE11E2D3FE8D64FA90"
    },
    {
      "cities_url": "https://api.bm.parts/delivery/region/92AF000C2947F7AE11E2D3FE8D64FA91/cities",
      "name": "Волинська область",
      "uuid": "92AF000C2947F7AE11E2D3FE8D64FA91"
    }
  ]
}