Swagger API Личный кабинет Центр поддержки

Dalli #

Подключение учётной записи Dalli к ApiShip #

В этой статье представлена инструкция по подключению Dalli в качестве СД в ApiShip. Курьерская компания Dalli — экспресс-доставка для интернет-магазинов и ритейла от профессиональной курьерской службы. Без выходных, без наценок, без задержек. Что-бы подключить СД Dalli, необходимо:

  1. Заключить договор с СД Dalli.
  2. Создать подключение в ЛК ApiShip.

Заключение договора с Dalli #

Если у Вас уже есть договор с СД Dalli, перейдите к пункту создания подключения в ЛК Apiship.

Для создания договора с СД Dalli необходимо:

  1. Перейти на официальный сайт: https://dalli-service.com/.
  2. Нажать на кнопку “Стать клиентом”. img
  3. Заполнить данные в форме обратной связи, после чего с Вами свяжется менеджер для заключения договора. img
  4. После заключения договора необходимо перейти в ЛК, для получения API key, который в дальнейшем пригодится для подключения СД в ЛК ApiShip.

Создание подключения в ЛК Apiship #

Для создания подключения в ЛК ApiShip необходимо:

  1. Войти в свою учетную запись ApiShip.
  2. Перейти в раздел «Службы доставки» в левой навигационной панели. img
  3. Выбрать СД Dalli в списке. img
  4. В открывшемся окне заполнить все поля, которые будут вам предложены для заполнения. img

Параметры подключения представлены в таблице ниже.

Параметр подключенияОбязательныйОписание
НазваниенетНазвание подключения
ИННдаИНН вашей компании
Передаваемый процент оценочной стоимостинетЭтот параметр регулирует процент от переданной оценочной стоимости, который мы отправим в службу доставки. Если нужно убрать оценочную стоимость, установите 0. Стандартное значение - 100
API keyдаУникальный ключ (API-key) для авторизации.
Город филиала отгрузокнетГород филиала отгрузок: Москва или Санкт-Петербург. По умолчанию будет выбран филиал в Москве.
Формат наклейкинетФорматы печатной формы этикетки для упаковки в формате pdf. Формат Зебра необходим для корректной печати на термопринтере Zebra.
Из корзины (use basket)нетИспользование корзины. При активном параметре необходимо будет вручную подтверждать заказы в ЛК Dalli.
Разрешена передача нулевой оценочной стоимостинетПо умолчанию в Dalli нельзя передавать нулевую оценочную стоимость товаров. Если менеджер в Dalli подключил по вашему договору такую возможность, то нужно активировать эту опцию
Передача своих ШКнетПередача своих ШК (клиент сможет сам печатать свои этикетки)
Передавать нулевую оценочную стоимость для “Стоимости доставки”нетНулевая оценочная стоимость для “Стоимости доставки”
При полном отказе не брать стоимость доставки с получателянетПри полном отказе не брать стоимость доставки с получателя
Автоподбор даты и интервала доставкинетЕсли Dalli не принимает заказ из-за даты или интервала доставки, ApiShip подберёт ближайшую доступную дату и интервал и отправит заказ повторно. Подробнее — в разделе Автоподбор даты и интервала доставки.

Автоподбор даты и интервала доставки #

Dalli проверяет дату доставки при создании заказа и не принимает заказ, если:

  • дата раньше, чем Dalli успевает доставить в город получателя (ошибка «Дата доставки должна быть не раньше, чем …»);
  • в выбранный день недели доставка не осуществляется;
  • на выбранную дату нет переданного интервала доставки.

Если дата доставки не передана, ApiShip отправляет в Dalli завтрашнюю дату — для дальних городов такой заказ тоже будет отклонён.

Когда опция Автоподбор даты и интервала доставки включена, ApiShip сам исправляет такой заказ и один раз отправляет его повторно:

  1. Начальная дата берётся из ошибки Dalli («не раньше, чем …»), а если её нет — следующий день после отправленной даты.
  2. Для курьерской доставки Dalli ApiShip запрашивает доступные интервалы и берёт ближайшую дату, на которую они есть (в пределах 14 дней). Интервал выбирается ближайший к переданному в заказе.
  3. Для доставки в пункты выдачи партнёров Dalli используется дата из ошибки.

Дата и интервал, с которыми Dalli приняла заказ, сохраняются в заказе — их видно в GET /orders/{id}. Если Dalli отклонила заказ по другой причине (например, из-за адреса) или отклонила и повторную отправку, заказ получает статус «Ошибка загрузки» с ответом Dalli, как и без опции.

Чтобы сразу передавать допустимые дату и интервал, используйте метод получения интервалов доставки — он учитывает географию и параметры заказа.