- I. Подготовка и настройка сторонних сервисов
- II. Настройка интеграции E-Commerce
I. Подготовка и настройка сторонних сервисов #
1. Доменное имя и IP адрес #
У вас должен быть домен, который привязан к IP адресу, на котором будет находится сервер 1С. Для удобства работы можно использовать поддомен, например: 1с.domen.ru
1.1. Назначение IP адреса вашему домену/поддомену осуществляется в соответствии с инструкциями вашего регистратора доменных имен. Например, инструкция от reg.ru https://help.reg.ru/hc/ru/articles/4408046894353-%D0%9F%D0%BE%D0%B4%D0%B4%D0%BE%D0%BC%D0%B5%D0%BD%D1%8B
2. Подготовка WEB Сервиса. Настройка на ISS #
2.1. Запустите «1С:Предприятие» от имени администратора и откройте «Конфигуратор»:
2.2. В верхней панели выберите «Администрирование» → «Публикация на веб‑сервере»
2.3. В поле Каталог введите путь к папке, в которой будут находится файлы, созданные в результате публикации сервиса
2.4. Перейдите на вкладку HTTP сервисы и включите опции «Публиковать HTTP сервисы расширений по умолчанию» и «Публиковать HTTP сервисы по умолчанию»
2.5. Нажмите кнопку «Опубликовать»
2.6. Если у Вас уже есть публикация, то нужно сделать еще одну для работы под новым пользователем в отдельную папку:
3. Создание пользователя #
В тонком клиенте «1С:Предприятия»
3.1. Создайте пользователя в разделе НСИ и Администрирование — Администрирование — Настройки пользователей и прав:
3.2. Введите данные пользователя, который будет использоваться для доступа к сервису, установите пароль
3.3. Перейдите на вкладку «Права доступа», добавьте пользователя в группу «Администраторы» или «Пользователи E-Commerce» и запишите настройки пользователя
3.4. На компьютере перейдите в каталог публикации, который вы указали на предыдущем шаге (см. п. 1.2.3.), и откройте файл «default.vrd»
3.5. В строке подключения укажите логин и пароль созданного пользователя
В случае добавления новой публикации, в файле «default.vrd» нужно найти строку: <httpServices publishExtensionsByDefault="true"> и заменить параметр «true» на «false». Это необходимо сделать для того чтобы не публиковался веб-клиент всей базы.
Ниже добавить блок:
<service name="мп_Yandex"
rootUrl="ExchangeWithYandex"
enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
- При этом в публикации из всех расширений будет доступен только сервис маркетплейса
- Для файловой базы:
Строку "ib="File="C:\Base\BaseName";" замените на "ib="File="C:\Base\BaseName ";Usr="Логин";Pwd="Пароль";".
- Для клиент-серверной базы:
Строку "ib="Srvr="localhost";Ref="BaseName";" замените на "ib="Srvr="localhost";Ref=" BaseName";Usr="Логин";Pwd="Пароль";"
3.6. Пример готового файла «default.vrd»:
<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
base="/trade"
ib="Srvr="localhost";Ref="trade";Usr="1c_exchange";Pwd="123321d";"
enable="false">
<httpServices publishByDefault="false">
<service name="мп_Yandex"
rootUrl="ExchangeWithYandex"
enable="true"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
</httpServices>
<standardOdata enable="false"
reuseSessions="autouse"
sessionMaxAge="20"
poolSize="10"
poolTimeout="5"/>
<analytics enable="false"/>
</point>
3.7. Проверка работы публикации.
Чтобы проверить работу публикации откройте ссылку в браузере. В ссылке должны быть указаны ваши данные:
https://поддомен.domen.ru/название_публикации/hs/ExchangeWithYandex/ping
При успешной настройки публикации и пользователя для обмена в браузере отобразится следующая информация:
4. Настройка SSL Сертификата #
4.1. Создание сертификата #
Мы рекомендуем использовать бесплатный сервис Letencrypt. Инструкция сервиса по ссылке:
https://letsencrypt.org/ru/getting-started/
4.2. Настройка сертификата #
После получения сертификата в браузере рядом с вашим доменом появится символ замка. Необходимо нажать на него перейти в раздел «Безопасное подключение» → «Действительный сертификат». На вкладке состав найти поле «Отпечаток». Он понадобится в пункте № 5.4 данной главы:
5. Настройка API #
5.1. Номер кампании #
Ваш номер кампании, присваивается Яндексом и заполняется автоматически. Число после дефиса — это идентификатор кампании, campaignId. Он используется в запросах, которые магазин отправляет Маркету.
5.2. Авторизационный токен #
Чтобы получить токен, нажмите на кнопку «Изменить». Этот токен будет использоваться для авторизации при каждом запросе к API.
5.3. URL для запросов API #
В поле URL для запросов API необходимо ввести ссылку в следующем формате:
https://1c.domen.ru/ka_sub.bey/hs/ExchangeWithYandex/v1/00000000
Где:
- 1c.domen.ru – ваш домен/поддомен через который идет работа 1С (см. п. №1 данной главы.)
- ka_sub.bey – имя публикации на веб-сервисе. Должно совпадать со значением в данном поле:
- Hs – константное значение
- ExchangeWithYandex — Имя сервиса (константное значение). Должно совпадать со значением в данной строчке:
- V1 – версия (константное значение)
- 00000000 – номер кампании после дефиса (см. п.5.1.)
5.4. SHA1-отпечаток SSL-Сертификата #
В поле SHA1-отпечаток SSL-Сертификата внести в значение полученное в п. 4.2. данной главы:
5.5. Способ авторизации #
Укажите способ авторизации: HEADER
II. Настройка интеграции E-Commerce #
1. Настройки интеграции #
Настройки интеграции находятся в разделе «E-Commerce» → «Интеграции E-Commerce»:
1.1. Создайте новую, нажав на кнопку «Создать» или выберите действующую карточку настроек из списка с помощью двойного клика мыши:
1.2. Заполните название организации, которая работает с маркетплейсом и выберите нужный маркетплейс из списков:
2. Продажи со своего склада #
2.1. Прайс #
Это инструмент для загрузки цен на марткеплейс. Для работы с ценами используется инструмент «Цены (прайс-лист)»:
В эти поля вы можете загрузить прайс-листы для отображения цен на маркетплейсах, выбрав их из выпадающего списка:
- Прайс (зачеркнутая цена) – это цена отображаемся на маркетплейсе до скидки:
- Прайс (цена со скидкой) – это итоговая цена, по которой покупатель приобретает товар:
2.2. Автоматическая выгрузка остатков #
При активации данной функции система автоматически будет отправлять остатки по товарам на маркетплейс:
2.3. Автоматическая загрузка заказов #
При активации данной функции, новые заказы будут добавляться автоматически:
Если функция не активна, новые заказы можно получить, нажав кнопку «Получить новые» в разделе «Заказы e-commerce»:
2.4. Автоматическое подтверждение заказов #
При активации данной функции новые заказы автоматически переходят в статус «Принят в работу»:
! Для работы данной функции в ЛК Яндекса необходимо установить подтверждения заказов через API. В разделе «Настройки», «Метод работы»:
3. Заполнение документов – заказы и реализации #
Данные поля нужны для автоматического заполнения значений в документации (заказах, отчетах комиссионера, УПД и т.п.):
3.1. Контрагент #
Контрагент – название клиента, в данном случае – Розничный покупатель. Значение из поля будет подставляться в необходимые документы, такие как: заказ, отчет комиссионера, поступление услуг и прочих активов. Например, в заказе:
3.2. Договор #
Если используется опция договоры с клиентами, заполните данное поле. Значение используется в заказах и отчетах комиссионера:
3.3. Соглашения и договор услуг #
Если используются опции «Договоры с поставщиками» и «Соглашения с поставщиками», заполните данное поле. Значение используется в документе поступление услуг и прочих активов:
3.4. Номенклатура Агентское вознаграждение #
Номенклатура Агентское вознаграждение – используется в отчетах комиссионера. Введенное значение будет отображаться на вкладке «Комиссионное вознаграждение» в поле «Услуга»:
4. Интеграция #
Поля в этом разделе необходимы для обмена информацией между 1С и личным кабинетом маркетплейса. Признак «Интеграция включена» устанавливается после заполнения всех полей.
4.1. Yandex campaign id и Yandex auth token #
Зайдите в настройки API в личном кабинете Яндекс.Маркета:
Скопируйте в интеграцию в 1С данные поля:
! В номере кампании копируйте цифры после дефиса.
4.2. Yandex client token и Yandex client secret #
4.2.1. Перейдите по ссылке https://oauth.yandex.ru/client/new
4.2.2. Создайте новое приложение:
Выберите «Другие сервисы»:
4.2.3. Заполните данные для нового приложения.
- Введите название приложения (любое)
- Отметьте галочкой платформу «Веб-сервисы»
- Нажмите кнопку «Подставить URL для разработки»
- Проверьте, что вы авторизованы с помощью аккаунта, который привязан к личному кабинету маркета:
- В разделе «Какие данные вам нужны?» отметьте Яндекс.Маркет / Поиск по товарам:
4.2.4. Внизу страницы нажмите кнопку создать приложение:
4.2.5. Яндекс создает значения Client ID и Client secret, которые необходимо внести в поля Yandex Client ID и Yandex client secret соответственно:
4.3. Yandex access token #
Нажмите кнопку «Yandex получить токен». Авторизуйтесь в базе с помощью аккаунта Яндекса привязанного к личному кабинету продавца. Поле Yandex access token заполниться автоматически:
4.4. Включение интеграции #
Включите интеграцию и запишите настройки:
4.5. Проверка настроек #
После заполнения всех настроек, необходимо проверить работу модуля. Для этого в ЛК Яндекс.Маркета в разделе настройка API необходимо нажать кнопку «Отправить запрос». Не должно возникать никаких ошибок:
5. Склады Маркетплейса #
После выполнения предыдущего пункта инструкции система создаст карточку склада маркетплейса:
5.1. Вернитесь в настройки интеграции. В подсистеме «E-Commerce» → «Настройки» → «Интеграции E-Commerce»:
5.2. Откройте настройку интеграции. В разделе складов появится склад маркетплейса. Откройте его:
5.3. В карточке склада необходимо заполнить поля:
- Склад 1С – существующий в вашей системе склад, с которого будут отправляться остатки на маркетплейс
- Отметить галочкой «Активен» — признак активности склада:
6. Тестирование заказов #
Для проверки настроек и корректной работы модуля можно создать тестовый заказ в ЛК Яндекс.Маркета.
В разделе «Настройки» → «Тестовый заказ»:
