Подключение мобильного приложения Адвантшоп к внешним системам

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

• Загрузка каталога в приложение
  • Интеграция с учетной системой
  • Импорт YML
  • Импорт CSV
  • Импорт CommerceML
  • Интеграция по Client API
  • Если нет подходящего способа
• Отправка заказов из приложения
  • Интеграция с учетной системой
  • Экспорт в CommerceML
  • Экспорт в XML
  • Вэбхук по REST API
  • Интеграция по Server API
  • Интеграция по Client API
  • Если нет подходящего способа

 

Загрузка каталога в приложение

Интеграция с учетной системой

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

• 1С
• Мой Склад
• LiteBox
• iiko
• r-keeper
• Tillypad

 

Импорт YML

Загрузить каталог по расписанию можно в формате YML (формат Яндекс.Маркет). Для загрузки файл должен быть доступен по прямой ссылке. Ссылка указывается в настройках модуля "Импорт товаров из YML-файла". О том как это сделать в инструкции. Также в самом модуле можно прописать соответствие полей файла и частоту импорта. Допустимо указывать до 10 разных ссылок на файлы.

 

Импорт CSV

Каталог можно загрузить в формате AdvantShop CSV 1.0. Описание формата разобрано в статье Импорт данных каталога CSV 1.0. Файл должен быть отправлен POST запросом, URL-адрес для отправки можно получить в разделе админ панели "Настройки - API", вкладка "1C - Импорт товаров" (рис. 1).

Рисунок 1.

Для использования этого метода необходимо заранее сгенерировать API ключ для магазина на вкладке API в этом же разделе. Подробнее в начале статьи Описание API.

 

Импорт CommerceML

Если внешняя система поддерживает обмен по CommerceML, то настроить импорт товаров можно через модуль 1C. Подробнее об интеграции сервисов 1С можно узнать из Общей инструкции по 1С.

 

Интеграция по Client API

Если по каким-то причинам требуется не регулярный обмен, а запрос каталога непосредственно из внешней системы в реальном времени, то эта система должна реализовать json-протокол AdvantShop ApiDataContract. Описание контракта в инструкции в разделе Техническая архитектура ПО.

Структуру json форматов можно получить в разделе администрирования "Настройки - API" на вкладке "API с авторизаций покупателя" или на странице Описание API.

 

Нет подходящего способа

Если ни один из представленных способов не подходит, обратитесь в техническую поддержку. Технические специалисты подберут оптимальное решение для вашей задачи.

 

Отправка заказов и товаров из приложения

Интеграция с учетной системой

При прямой интеграции с учетными системами заказы и покупатели передаются в учетную систему автоматически. Сейчас поддерживаются следующие учетные системы:

• 1С
• Мой Склад
• LiteBox
• iiko
• r-keeper
• Tillypad

 

Экспорт в CommerceML

Если внешняя система поддерживает обмен по CommerceML, то настроить экспорт заказов можно через модуль 1C. Подробнее об интеграции сервисов 1С можно узнать из Общей инструкции по 1С.

 

Экспорт в XML

Возможно подключить выгрузку файла с заказами за нужный период в файл XML. Файл можно получить GET-запросом на определенный URL. URL для запроса можно получить в разделе админ панели "Настройки - API", на вкладке "1C - Экспорт заказов" (рис. 2).

Рисунок 2.

Для использования этого метода необходимо заранее сгенерировать API ключ для магазина на вкладке API в этом же разделе. Подробнее в начале статьи Описание API.

 

Вэбхук по REST API

На события регистрации пользователя или оформления заказа можно настроить системные триггеры и указать в качестве действия триггера — отправку http-запроса. Подробнее об отправке http-запросов по триггеру.

 

Интеграция по Server API

Доступна возможность запрашивать список созданных или измененных заказов по REST API. Список доступных операций и формат json ответов описан в разделе админ панели "Настройки - API", вкладка "API", или на странице Описание API.

 

Интеграция по Client API

Мобильное приложение возможно подключить непосредственно к внешней системе по клиентскому API с авторизацией пользователя. Эта система должна реализовать json-протокол AdvantShop ApiDataContract.

Описание контракта в инструкции в разделе Техническая архитектура ПО. Структура json-форматов можно получить в разделе админ панели "Настройки - API", вкладка "API с авторизацией покупателя", или на странице Описание API.

 

Нет подходящего способа

Если ни один из способов не подходит, обратитесь в техническую поддержку. Технические специалисты подберут оптимальное решение для вашей задачи.

Готово. Мы рассмотрели самые популярные методы интеграции для импорта каталога и экспорта заказов.