Библиотека для работы со CDEK (open-source)

25.01.25

Интеграция - WEB-интеграция

Новый API в составе Открытого пакета интеграций - CDEK API. Новый функционал позволяет легко управлять заказами и доставкой из программного кода, а также получать различную учетную информацию прямо с серверов CDEK. Бесплатно и с открытым исходным кодом.

Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Для тех, кто уже знаком с ОПИ, данный раздел можно пропустить.

 
 Что такое Открытый Пакет Интеграций

 

Открытый Пакет Интеграций (ОПИ) - это open-source набор методов для простой и быстрой интеграции с различными популярными API. Он состоит из аналогичных по функционалу 1С-расширения (CFE), OS-пакета и программы для Windows и Linux, которые предоставляют готовые функции для работы с целым набором различных онлайн-сервисов.


  • ОПИ бесплатен и имеет открытый исходный код на GitHub. Вы всегда можете получить последнюю версию библиотеки на странице репозитория, а подписавшись - узнавать о выходе обновлений. Все релизы сопровождаются статьями на Инфостарт и разделами единой документации. На Инфостарт вы можете подписаться уже хоть сейчас, а про документацию я расскажу далее.

 

 

 

  • Удобная единая документация. Она расположена на сайте opi.neocities.org и содержит в себе всю информацию, необходимую для работы: инструкции по предварительным действиям для начала интеграции, описания всех методов с параметрами и возвращаемыми значениями, примеры кода и т.д. Каждый API имеет там свой раздел.

 

 

 

 

  • Простая установка. ОПИ распространяется во множестве вариантах: как XML файлы расширения, как EDT проект расширения, как файл расширения формата .cfe (версия 1С 8.3.9), как файл пакета для OneScript и еще в целом наборе пакетов и файлов для Windows и Linux. Из этого набора вы всегда сможете выбрать тот способ установки, который лучше подойдет для вашей конкретной задачи

 

На момент последнего обновления данной статьи, доступны следующие API:

Наиболее актуальную информацию можно посмотреть в репозитории или на вводной странице документации.

 

 CDEK - один из самых известных операторов доставки в России и странах СНГ. Многие магазины и фирмы пользуются его услугами для доставки своих грузов, заказов и документов

 

И у него есть API для управления всем этим. В данном обновлении ОПИ была реализована работа со следующими его функциями:
 

  • Общий функционал
    • Получение токена
    • Получение чеков оплат на дату
    • Получение реестров платежей на дату
    • Получение переводов наложенных платежей на дату
    • Получение списка офисов
  • Работа  с заказами
    • Создание заказа
    • Изменение заказа
    • Удаление заказа
    • Получение информации о заказе
    • Оформление клиентских возвратов
    • Создание отказов
    • Формирование и получение квитанций в формате PDF
    • Формирование и получение штрихкодов в формате PDF
    • Создание и получение преалертов
    • Получение статуса внесения паспортных данных для международных заказов
    • Получение чека зказа
  • Управление доставкой
    • Получение доступных интервалов доставки
    • Создание заявки на вызов курьера
    • Получение информации о заявке на вызов курьера
    • Удаление заявки на вызов курьера
    • Фиксация договоренности о доставке
    • Получение информации о договоренности о доставке

 

Описание всех методов, как всегда, есть в документации. Сейчас же отмечу еще несколько моментов по работе с API CDEK и библиотекой ОПИ в целом

 


 

Тестовый контур 

У CDEK API есть тестовый контур и авторизационные данные для него:

 

 

Это позволяет начать разработку и отладить процесс интеграции без захламления рабочего аккаунта и даже до заключения договора вовсе. Подробнее можно узнать в начале документации самого CDEK

Что касается методов, реализованных в ОПИ, то использование тестового или рабочего контура определяется там в каждой функции при помощи параметра ТестовыйAPI

 

Обновление документации

К этому обновлению были сделаны некоторые улучшения для документации в целом 

Во-первых, более понятным стал блок примера вызова для CLI (если что, ОПИ выходит не только как расширение для 1С, но и как приложение для командной строки). Раньше этот блок генерировался кое-как на основе данных 1Сных тестов, но к этому релизу был закончен полный набор тестов отдельно для CLI приложения. Поэтому данные в примерах вызовов теперь реальные и проверенные, также, как и в примерах кода для 1С

 

 

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

 

 

Ну еще есть набор незначительных визуальных изменений: добавлена более четкая обводка блоков кода, блоку CLI включена нормальная подсветка и прочие мелочи. Посмотреть это все можно по данной ссылке

Ну а пока все! Скачать Открытый пакет интеграций можно по ссылкам ниже

Спасибо за внимание!

 

 Если вам нравится ОПИ, то не забывайте поддерживать его звездочкой на GitHub и плюсом на Инфостарт!
 


 

Репозиторий ОПИ: github.com/Bayselonarrend/OpenIntegrations

Последний релиз: github.com/Bayselonarrend/OpenIntegrations/releases/latest

 
 Где? Куда?

 

Другие статьи про Открытый пакет интеграций на Инфостарт:

 

 

 Мой GitHub:    https://gitub.com/Bayselonarrend 
 OpenYellow:    https://openyellow.org
 Лицензия MIT:  https://mit-license.org

Вступайте в нашу телеграмм-группу Инфостарт

cdek доставка api обмен интеграция заказы сдэк сдек web http

См. также

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

Онлайн-заказ - это решение для автоматизации процесса оформления заказов на сайте в торговых организациях. Продукт обеспечивает легкое взаимодействие между компанией и клиентами через веб-интерфейс, интегрированный с 1С:Предприятие. Система позволяет снизить операционные расходы, повысить лояльность клиентов и оптимизировать работу отдела продаж.

57600 руб.

26.11.2024    5454    4    3    

7

WEB-интеграция Программист Бизнес-аналитик 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

14400 руб.

20.12.2024    2949    16    2    

17

WEB-интеграция Анализ продаж Системный администратор Программист Пользователь 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Управленческий учет Платные (руб)

Модуль "Подсистема интеграции AmoCRM с 1С" позволяет обеспечить единое информационное пространство, в котором пользователи могут эффективно управлять клиентской базой, следить за статусами сделок и поддерживать актуальность данных как в AmoCRM, так и в 1С.

60000 руб.

07.05.2019    38044    73    45    

31

WEB-интеграция 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Оптовая торговля, дистрибуция, логистика Россия Платные (руб)

В расширении реализован механизм интеграции между системой поставщика и Личным кабинетом СДТ. Реализован обмен заказами и реализациями (накладными), предусмотрено отслеживание статусов документов. Расширение предназначено для 1С:УТ 11.4.

35856 руб.

27.11.2024    1506    1    0    

1

Обмен с ГосИС WEB-интеграция Бухгалтер Пользователь 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

3000 руб.

28.04.2016    96710    109    218    

359
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. user1206119 117 09.12.24 11:24 Сейчас в теме
Уважаемые коллеги, ваша библиотека бесподобна - но прошу вас устранить ошибку по подключению к SDEK:
Функция СформироватьURL(Знач Метод, Знач ТестовыйAPI)

    OPI_ПреобразованиеТипов.ПолучитьБулево(ТестовыйAPI);

    Если ТестовыйAPI Тогда
        URL = "https://api.edu.cdek.ru/v2";
    Иначе
        //URL = "https://api.cdek.ru";   
		URL = "https://api.cdek.ru/v2";
    КонецЕсли;

    URL = URL + Метод;

    Возврат URL;

КонецФункции
Показать

Прошу устранить недоработку - т.к. иначе боевая интеграция не работает (актуально для sdek 2.0).
2. bayselonarrend 2870 09.12.24 11:27 Сейчас в теме
(1) Спасибо большое, буквально пару дней назад сам заметил) С новым релизом будет все ок
user1206119; +1 Ответить
3. user1206119 117 09.12.24 12:02 Сейчас в теме
(2) Для информации - на удивление https не является обязательным - http тоже даёт возможность подключиться к cdek. Тест был произведен на бою.
4. bayselonarrend 2870 09.12.24 12:41 Сейчас в теме
(3)
http тоже даёт возможность подключиться к cdek


Да, но это не безопасно
Для отправки сообщения требуется регистрация/авторизация