CreateIntake. Заявка на курьерский забор посылок.
Позволяет создать заявку на забор посылок.
URL запроса (POST): https://api.boxberry.ru/json
Входящие параметры:
Параметр | Обяз. | Тип | Описание | Пример |
|---|---|---|---|---|
| token | ● | string | токен для доступа к методу | d6f33e419c16131e5325cbd84d5d6000 |
| method | ● | string | название метода | CreateIntake |
| zip | ● | string | почтовый индекс | 620100 |
| city | ● | string | город | Екатеринбург |
| street | ● | string | улица | Сибирский тракт |
| house | ● | string | дом | 12 |
| building | string | корпус | 1 | |
| housing | string | строение | 1 | |
| flat | string | квартира/офис | 501 | |
| contact_person | ● | string | контактное лицо | Иванов Иван |
| contact_phone | ● | string | контактный телефон | 9874561236 |
| taking_date | ● | string | дата забора | 07.05.2019 |
| taking_time_from | ● | string | время забора "с" | 10:00 |
| taking_time_to | ● | string | время забора "до" | 18:00 |
| seats_count | ● | integer | кол-во мест | 3 |
| volume | ● | float | объем (м^3) | 5 |
| weight | ● | float | вес (кг) | 1.2 |
| comment | string | комментарий | комментарий |
Данные ответа:
| Параметр | Тип | Описание | Пример | |
|---|---|---|---|---|
| message | string | номер созданной заявки на забор | 91980 | |
При выборе города забора, параметр "city" Москва, есть 3 доступных интервала времени:
"taking_time_from": 10:00
"taking_time_to": 18:00
"taking_time_from": 10:00
"taking_time_to": 14:00
"taking_time_from": 14:00
"taking_time_to": 18:00
Для всех остальных городов есть только один доступный интервал забора:
"taking_time_from": 10:00
"taking_time_to": 18:00
При выборе даты забора параметр "taking_date" нужно проверять текущее время в городе забора, по часовому поясу города забора.
Для города Москва:
При выгрузке заявки на забор до 15:59 часов забор можно выполнить в день выгрузки заявки на забор, в зависимости от выбранного временного интервала("taking_time_from" -"taking_time_to") и текущего на момент выгрузки заявки времени.
Для всех остальных городов:
Если время в выбранном городе < 15:59, доступен выбор дат забора начиная с завтрашнего дня от дня выгрузки заявки на забор.
Если время в выбранном городе >15:59, доступен выбор дат забора, начиная с послезавтра от дня выгрузки заявки на забор.
Правила заполнения параметров метода CreateIntake:
Параметры должны быть заполнены также как это представлено в таблице выше. Без использования сторонних символов(""; ^^; **; и т.д.)
Запрос
POST /json.php HTTP/1.1
Host: api.boxberry.ru
Content-Type: application/json
{
"token": "d6f33e419c16131e5325cbd84d5d6000",
"method": "CreateIntake",
"zip": "620100",
"city": "Екатеринбург",
"street": "Сибирский тракт",
"house": "12",
"building": "1",
"housing": "",
"flat": "501",
"contact_person": "Иванов Иван",
"contact_phone": "9874561236",
"taking_date": "23.04.2021",
"taking_time_from": "10:00",
"taking_time_to": "18:00",
"seats_count": "3",
"volume": "5",
"weight": "1",
"comment": ""
}Ответ
{
"message": 170828
}