Содержит описание методов, которые могут быть использованы из программного кода конфигурации 1С для программного взаимодействия с модулем доставки

Версия модуля 2.10.14

Оглавление

API Модуля доставки «API-1C» 1

Функция РассчитатьИОтправитьВнешниеДанные 1

Функция СлужбыДоставки 7

Функция ДопУслуги 7

Функция ПВЗ 8

Функция РассчитатьИОтправитьВнешниеДанные

В зависимости от переданных параметров, может рассчитать тариф для переданных данных, отправить заявку в службу доставки и сохранить результат в доп.сведения заказа.

Параметры:

Имя параметра Тип параметра Описание
Данные Структура. Заказ — ДокументСсылка.ЗаказКлиента, Заказ, который нужно отправить в службу доставки

Тариф — Число, Необязательный, ID тарифа. Передаётся только если нужно сразу отправить данные в службу доставки без предварительного расчёта тарифа.

Номер – Строка, Необязательный, номер заказа. Если не передан – будет использован номер заказа из параметра «Заказ».

Штрихкод — Строка, Необязательный, Штрих-код заказа

Комментарий — Строка, Необязательный, Комментарий для службы доставки

Высота — Число, Необязательный, Высота заказа в сантиметрaх

Длина — Число, Необязательный, Длина заказа в сантиметрaх

Ширина — Число, Необязательный, Ширина заказа в сантиметрах

Вес — Число, Вес всего заказа в граммах

БезСтраховки — Булево, Необязательный, Если Истина – страхование отправления не требуется. По умолчанию – Ложь.

СлужбаДоставки — Строка, Код службы доставки

ТипОтправки — Число, Тип отправки груза (1 — от двери, 2 — от ПВЗ)

ТипДоставки — Число, Тип доставки (1 — до двери, 2 — до ПВЗ)

ИДПВЗОтправки — Число, Необязательный, ID пункта отправки, если предполагается доставка до ПВЗ. Если не передано, то будет произведена попытка распознать ПВЗ по адресу доставки, переданному в поле «Отправитель». Если заполнено – Адрес доставки отправителя не обрабатывается (необязателен к передаче).

ИДПВЗДоставки — Число, Необязательный, ID пункта доставки, если предполагается доставка до ПВЗ. Если не передано, то будет произведена попытка распознать ПВЗ по адресу доставки, переданному в поле «Получатель». Если заполнено – Адрес доставки получателя не обрабатывается (необязателен к передаче).

ДатаОтправки — Дата, Необязательный, Предполагаемая дата передачи груза в службу доставки

ДатаДоставки — Дата, Необязательный, Дата доставки

ВремяОтправкиНачало — Дата, Необязательный, Начальное время забора груза

ВремяОтправкиОкончание — Дата, Необязательный, Конечное время забора груза

ВремяДоставкиНачало — Дата, Необязательный, Начальное время доставки

ВремяДоставкиОкончание — Дата, Необязательный, Конечное время доставки

ОбъявленнаяСтоимость — Число, Объявленная оценочная стоимость / сумма страховки (в рублях)

СтоимостьОтправления — Число, Необязательный, Стоимость отправления с учетом НДС (в рублях)

НДС — Число, Необязательный, Процентная ставка НДС

СуммаНаложенногоПлатежа — Число, Сумма наложенного платежа с учетом НДС (в рублях). Состоит из СуммаДоставкиДляКлиента + сумма, которую должен оплатить клиент за сам заказ.

СуммаДоставкиДляКлиента — Число, Необязательный, Сумма, которую платит клиент именно за услугу доставки. Входит в сумму наложенного платежа и не может быть больше неё.

Отправитель — Структура, поля: Данные отправителя

Адрес — Строка, Полный адрес отправителя одной строкой

АдресЗначенияПолей — Строка, Значения полей адреса в формате ФИАС. Возможно пустое, если в Модуле подключена интеграция с Дадатой. Должно быть передано либо это поле, либо «АдресДанные». Для отправки от ПВЗ данные берутся из метода получения данных о ПВЗ из модуля.

АдресДанные — Структура, поля: Значения полей адреса с разбивкой. Должно быть передано либо это поле, либо «АдресОтправкиЗначенияПолей».

Индекс — Строка, Необязательный, Почтовый индекс

КодСтраны — Строка, Код страны в соответствии с ISO 3166-1 alpha-2

Страна — Строка, Название страны

Регион — Строка, Область или республика или край

Район — Строка, Необязательный, Район

Город — Строка, Город или населенный пункт

ГородGuid — Строка, Необязательный, ID города в базе ФИАС

Улица — Строка, Улица, с наименованием адресного объекта. Например, «ул. Ленина», «Новорижское шоссе», «б-р Симферопольский»

КодКЛАДРУлицы — Строка, Необязательный, Только для Деловых линий. Код КЛАДР для выбранной улицы. Увеличивает точность определения адреса.

Дом — Строка, Дом

Корпус — Строка, Необязательный, Строение/Корпус

Квартира — Строка, Необязательный, Офис/Квартира

ИмяОрганизации — Строка, Необязательный, Название компании

ИННОрганизации — Строка, Необязательный, ИНН организации-отправителя

КонтактноеЛицо — Строка, ФИО контактного лица

Телефон — Строка, Контактный телефон

Email — Строка, Необязательный, Контактный email адрес

Получатель — Структура, поля:, Данные получателя

Адрес — Строка, Полный адрес отправителя одной строкой

АдресЗначенияПолей — Строка, Значения полей адреса в формате ФИАС. Возможно пустое, если в Модуле подключена интеграция с Дадатой. Должно быть передано либо это поле, либо «АдресДанные». Для доставки до ПВЗ данные берутся из метода получения данных о ПВЗ из модуля.

АдресДанные — Структура, поля: Значения полей адреса с разбивкой. Должно быть передано либо это поле, либо «АдресЗначенияПолей». Если передано это поле, правильность заполнения его элементов не проверяется.

Индекс — Строка, Необязательный, Почтовый индекс

КодСтраны — Строка, Код страны в соответствии с ISO 3166-1 alpha-2

Страна — Строка, Название страны

Регион — Строка, Область или республика или край

Район — Строка, Необязательный, Район

Город — Строка, Город или населенный пункт

ГородGuid — Строка, Необязательный, ID города в базе ФИАС

Улица — Строка, Улица, с наименованием адресного объекта. Например, «ул. Ленина», «Новорижское шоссе», «б-р Симферопольский»

КодКЛАДРУлицы — Строка, Необязательный, Только для Деловых линий. Код КЛАДР для выбранной улицы. Сильно увеличивает точность определения адреса.

Дом — Строка, Дом

Корпус — Строка, Необязательный, Строение/Корпус

Квартира — Строка, Необязательный, Офис/Квартира

ОПФ — Число, Организационно-правовая форма. 1 – ООО, 2 – ИП, 3 — ФизЛицо

ИмяОрганизации — Строка, Необязательный, Название компании

КонтактноеЛицо — Строка, ФИО контактного лица

Телефон — Строка, Контактный телефон

Email — Строка, Необязательный, Контактный email адрес

ИННОрганизации — Строка, Необязательный, ИНН компании-получателя

Места — Массив, строка = Структура, поля:

Место — Строка, Необязательный, Номер места в информационной системе клиента

Штрихкод — Строка, Необязательный, Штрихкод места

Высота — Число, Необязательный, Высота места в сантиметрaх

Длина — Число, Необязательный, Длина места в сантиметрaх

Ширина — Число, Необязательный, Ширина места в сантиметрах

Вес — Число, Вес места в граммах

Товары — Массив, строка = Структура, поля:

Артикул — Строка, Необязательный, Артикул товара

Маркировка — Строка, Необязательный, Код маркировки (UTF-8)

Наименование — Строка, Наименование товара

Количество — Число, Кол-во товара. Если указан Маркировка, то кол-во не может быть > 1

Высота — Число, Необязательный, Высота единицы товара в сантиметрах

Длина — Число, Необязательный, Длина единицы товара в сантиметрах

Ширина — Число, Необязательный, Ширина единицы товара в сантиметрах

Вес — Число, Необязательный, Вес единицы товара в граммах

ОбъявленнаяСтоимость — Число, Необязательный, Оценочная стоимость единицы товара в рублях

Цена — Число, Необязательный, Стоимость единицы товара с учетом НДС в рублях

НДС — Число, Необязательный, Процентная ставка НДС

Штрихкод — Строка, Необязательный, Штрихкод на товаре

ДополнительныеУслуги — Соответствие:

Ключ — Строка, Идентификатор дополнительной услуги. Перечень возможных значений получается из соответствующего метода Модуля.

Значение — Строка, Булево, Дата, Число, Значение дополнительной услуги. Перечень возможных значений получается из соответствующего метода Модуля.

Рассчитать Булево, Необязательный нужно ли выполнять расчёт тарифа, по умолчанию — Истина
Отправить Булево, Необязательный нужно ли выполнять отправку заказа в службу доставки, по умолчанию — Истина
СохранитьРезультат Булево, Необязательный нужно ли сохранять результат отправки типовым механизмом модуля, по умолчанию — Истина

Возвращает – Истина, если все операции выполнены без ошибок. В случае ошибок – генерируются исключения. Подробности ошибок можно получить из очереди сообщений 1С. В процессе работы, если ошибок не было, в параметр Данные дописываются поля «Тариф» (в случае расчёта тарифа) и «ИдентификаторЗаказа» (в случае успешной отправки заказа). Т.к. заказы отправляются в асинхронном режиме, рекомендуется через какое-то время (от 30 сек) вызвать функцию «ОбновлениеСтатусов» для заказа, который был отправлен.

Функция СлужбыДоставки

Определяет и возвращает перечень подключённых служб доставки.

Параметры отсутствуют.

Возвращает – ТаблицаЗначений, колонки:

  • ИД – строка, идентификатор службы доставки. Например, «cdek», «ext_Dellin»
  • Служба доставки – строка, представление службы доставки. Например, «СДЭК», «Деловые линии»

Функция ДопУслуги

Определяет и возвращает перечень дополнительных услуг, возможных для определённой службы доставки. Понятие «дополнительные услуги» очень широко и разнообразно трактуется службами доставки, поэтому в перечне могут быть самые разные пункты – от примерки до плательщика за услугу страховки и т.п.

Параметры:

Имя Тип Описание
ИДСлужбыДоставки Строка Идентификатор службы доставки в модуле. Может быть получен из функции «СлужбыДоставки».

Возвращает – Массив, элементы – Структуры, поля:

  • Услуга – Строка, представление услуги
  • Описание – Строка, произвольное описание услуги от службы доставки. Может быть пустым.
  • ИДУслуги – Строка, уникальный идентификатор услуги
  • ТипСтрокой – Строка, строковое представление типа
  • ЗначенияВыбора – Строка, возможные значения для выбора. Может быть пустым

Функция ПВЗ

Возвращает перечень пунктов приёма-выдачи заказов (в т.ч. постаматы, терминалы и т.п.) для заданной службы доставки в заданном городе (населённом пункте).

Параметры:

Имя Тип Описание
ИДСлужбыДоставки Строка Идентификатор службы доставки в модуле. Может быть получен из функции «СлужбыДоставки».
GUIDГорода Строка, Необязательный GUID города согласно ФИАС. Если заполнен параметр «ИмяГорода», то может быть пустым. Рекомендуется передавать именно этот параметр для большей точности определения.
ИмяГорода Строка, Необязательный Наименование города. Если заполнен параметр «GUIDГорода», то может быть пустым. Рекомендуется передавать этот параметр только в том случае, если нет возможности определить GUID города согласно ФИАС, т.к. нет гарантии правильного определения населённого пункта по его имени.

Возвращает – ТаблицаЗначений, колонки:

  • ИД – Строка, идентификатор ПВЗ
  • СлужбаДоставкиИД – Строка, идентификатор службы доставки
  • СлужбаДоставки – Строка, представление службы доставки
  • ТипПВЗ – Строка, тип ПВЗ (постамат, терминал и т.п.)
  • ТипОперации – Строка, возможность отправки и/или выдачи отправлений
  • АдресПВЗ — Строка
  • ГрафикРаботы — Строка
  • Телефоны — Строка
  • ПараметрыПВЗ – Строка в формате JSON, данные о ПВЗ как они приходят в ответе от службы доставки. Содержат всю возможную информацию о ПВЗ
  • ТипПВЗИД – Число, идентификатор типа ПВЗ
  • МожетПриниматьОплату — Булево
  • МожетПриниматьОплатуКартой – Булево

Функция ОбновлениеСтатусов

Возвращает информацию о результате обновления статусов.

Параметры:

Имя Тип Описание
МассивЗаказов Массив, Необязательный, элемент – ДокументСсылка.

ЗаказПокупателя

Заказы, для которых нужно обновить статусы. Если не передан – статусы будут обновлены для всех заказов в базе, которые находятся в работе.

Возвращает – Строка, сообщения об ошибках или успешном выполнении.