Инструкция по использованию Деловые Линии в 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» — оплата картой.