Инструкция по использованию Деловые Линии в Albato
Подключение Деловых линий к Albato
Возможности интеграции
Сервис Деловые линии, в связках с другими платформами, может выступать только в качестве принимающей стороны. Доступные действия:
Экшн: Новый заказ
Для создания нового заказа на стороне Деловых линий, потребуется заполнение следующих полей:
- Тип доставки — тип доставки для межтерминальной перевозки;
- Отправление – дата — дата передачи груза на терминал отправления или дата приезда машины к отправителю. Формат: ГГГГ-ММ-ДД;
- Отправление – способ — доступные значения:
“terminal” – доставка груза от/до терминала. Примечание. При заказе перевозки малогабаритного груза (значение параметра запроса — “small”) доставка от/до терминала невозможна;
“address” – доставка груза от/до адреса;
“airport” – доставка груза до аэропорта. - Доставка способ — доступные значения:
“terminal” – доставка груза от/до терминала. Примечание. При заказе перевозки малогабаритного груза (значение параметра запроса — “small”) доставка от/до терминала невозможна;
“address” – доставка груза от/до адреса;
“airport” – доставка груза до аэропорта. - Заказчик — Роль в перевозке. Доступные значения:
“sender” – отправитель;
“receiver” – получатель;
“payer” – плательщик;
“third” – третье лицо - ID заказчика — выбирается нужный заказчик из выпадающего списка. Список формируется на основе данных из аккаунта ДЛ;
- Email заказчика — Email заказчика перевозки;
- Отправитель – полное имя — имя контактного лица;
- Отправитель – номер телефона — номер телефона контактного лица;
- Отправитель – название организационно-правовой формы контрагента — Название ОПФ в текстовом формате. Максимальная длина поля: 35 символов;
- Отправитель – страна юридической формы контрагента — выбираете нужную страну из выпадающего списка;
- Отправитель – юридическая форма контрагента — Признак юридического лица: да/нет;
- Отправитель – Имя контрагента — Имя контрагента или название юр. лица;
- Получатель – полное имя — Имя контактного лица;
- Получатель – номер телефона — номер телефона контактного лица;
- Получатель – название организационно-правовой формы контрагента — Название ОПФ в текстовом формате. Максимальная длина поля: 35 символов;
- Получатель – страна юридической формы контрагента — выбираете нужную страну из выпадающего списка;
- Получатель – юридическая форма контрагента — Признак юридического лица: да/нет;
- Получатель – Имя контрагента — Имя контрагента или название юр. лица;
- Груз – длина самого длинного грузового груза — Длина самого длинного грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.3”;
- Груз – ширина самого широкого грузового места — Ширина самого широкого грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.21”;
- Груз – высота самого высокого грузового места — Высота самого высокого грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.01”;
- Груз – общий вес груза — Общий вес груза, кг. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.5”;
- Груз – общий объем груза — Общий объём груза, куб. м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.001”;
- Груз – характер — описание в текстовом формате;
- Тип оплаты — Заявленный вид оплаты. Доступные значения:
“cash” – оплата наличными;
“card” – оплата картой; - Основной плательщик — плательщик по умолчанию. Указанный плательщик оплачивает основную услугу (межтерминальную перевозку) и все прочие услуги, если по ним не указаны иные плательщики. Доступные значения: “sender” – отправитель;
“receiver” – получатель;
“third” – третье лицо.
Экшн: Рассчитать стоимость доставки
Позволяет, в ответ на запрос, получить стоимость доставки груза. Обязательные для заполнения поля:
- Тип доставки — тип межтерминальной перевозки груза, для которого будет рассчитана стоимость. Возможные значения: “auto”- автодоставка;
“express” – экспресс-доставка;
“letter” – письмо;
“avia” – авиадоставка;
“small” – доставка малогабаритного груза. - Отправление – дата — дата передачи груза на терминал отправления или дата приезда машины к отправителю. Формат: ГГГГ-ММ-ДД;
- Отправление – способ — доступные значения:
“terminal” – доставка груза от/до терминала. Примечание. При заказе перевозки малогабаритного груза (значение параметра запроса — “small”) доставка от/до терминала невозможна;
“address” – доставка груза от/до адреса;
“airport” – доставка груза до аэропорта. - Доставка способ — доступные значения:
“terminal” – доставка груза от/до терминала. Примечание. При заказе перевозки малогабаритного груза (значение параметра запроса — “small”) доставка от/до терминала невозможна;
“address” – доставка груза от/до адреса;
“airport” – доставка груза до аэропорта; - Заказчик — Роль в перевозке. Доступные значения:
“sender” – отправитель;
“receiver” – получатель;
“payer” – плательщик;
“third” – третье лицо; - Груз – длина самого длинного грузового груза — Длина самого длинного грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.3”;
- Груз – ширина самого широкого грузового места — Ширина самого широкого грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.21”;
- Груз – высота самого высокого грузового места — Высота самого высокого грузового места, м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.01”;
- Груз – общий вес груза — Общий вес груза, кг. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.5”;
- Груз – общий объем груза — Общий объём груза, куб. м. Если вид доставки – “письмо”, то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение “0.001”;
- Груз – класс опасности — Класс опасности груза. Значение по умолчанию – “0”;
- Груз – объявленная стоимость страховки — Объявленная стоимость груза, руб. Максимальная длина поля – 12 символов;
- Груз – страховка срока — Признак страхования срока доставки груза: да/нет;
- Тип оплаты — Заявленный вид оплаты. Доступные значения:
“cash” – оплата наличными;
“card” – оплата картой.