Получение заявок из YClients Получение трек-номера СДЭК

Интеграция

Получение заявок из YClients Получение трек-номера СДЭК

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Настройка приёма заявок из YClients: HTTP-источник с URL вебхука, непубличное приложение в кабинете разработчика и установка в филиал.
  2. Получение трек-номера СДЭК через HTTP: OAuth token api.cdek.ru/v2/oauth/token, затем запрос создания или отслеживания заказа по API v2 с параметрами отправления.

Отдельные инструкции: источник «Получение заявок из YClients» · действие «Получение трек-номера СДЭК»

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «YClients» и нажмите кнопку «Выбрать».

Источник «YClients»

Заявки и уведомления из YClients начнут приходить на URL HTTP-источника. Создайте HTTP-источник, скопируйте URL и укажите его в приложении маркетплейса YClients.

Выбор типа источника

  1. Отметьте «HTTP» и нажмите «Выбрать».
    Получение заявок из YClients: Отметьте «HTTP» и нажмите «Выбрать»

URL приёма

  1. Не меняя параметры, нажмите «Сохранить».
    Получение заявок из YClients: Не меняя параметры, нажмите «Сохранить»
  2. Откройте вкладку «Источник данных» и скопируйте «URL».
    Получение заявок из YClients: Откройте вкладку «Источник данных» и скопируйте «URL»

Приложение в YClients

  1. Откройте кабинет разработчика маркетплейса YClients и создайте личный кабинет.
  2. Заполните поля и нажмите «Зарегистрироваться».
    Получение заявок из YClients: Заполните поля и нажмите «Зарегистрироваться»
  3. Нажмите «Создать приложение».
    Получение заявок из YClients: Нажмите «Создать приложение»
  4. Выберите тип «Непубличное» и нажмите «Далее».
    Получение заявок из YClients: Выберите тип «Непубличное» и нажмите «Далее»
  1. В разделе «Мои приложения» нажмите «Управление» на карточке приложения.
    Получение заявок из YClients: В разделе «Мои приложения» нажмите «Управление» на карточке приложения
  2. В «Настройки подключения» в поле «Адрес, на который отправлять уведомления» вставьте скопированный «URL» и нажмите «Сохранить».
    Получение заявок из YClients: В «Настройки подключения» в поле «Адрес, на который отправлять уведомления» вставьте скопированный «URL» и нажмите «Сохранить»
  3. В «Общая информация» скопируйте «Ссылка на приложение».
    Получение заявок из YClients: В «Общая информация» скопируйте «Ссылка на приложение»
  4. Откройте ссылку в браузере и нажмите «Подключить».
    Получение заявок из YClients: Откройте ссылку в браузере и нажмите «Подключить»
  5. Нажмите «Продолжить» - в выбранном филиале будут установлены вебхуки.
    Получение заявок из YClients: Нажмите «Продолжить» - в выбранном филиале будут установлены вебхуки

Действие «СДЭК. Получение трек-номера посылки»

СДЭК API v2 выдаёт трек-номер после OAuth и запроса заказа. Сначала получите token, затем создайте или отследите отправление.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

OAuth СДЭК

  1. Создайте первое действие «HTTP-запрос» с POST на https://api.cdek.ru/v2/oauth/token?parameters.
  2. Передайте client_id, client_secret и сохраните access_token.

Параметры запроса

Действие настраивается через «HTTP-запрос».

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
    Выберите «HTTP-запрос» и нажмите «Выбрать»
  2. Создайте второе действие «HTTP-запрос» для создания или отслеживания заказа СДЭК.
  3. В «Заголовки» добавьте Authorization со значением Bearer ACCESS_TOKEN.
  4. Передайте параметры отправления по документации API v2 СДЭК.
  5. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»