Подключение к Яндекс.Маркет

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. Перейдите на вкладку «Прочие», выберите в списке пункт «Полные права» и нажмите кнопку «OK»

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="Пароль";"

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/ (должна быть выполнена авторизация почты, привязанная к кабинету Яндекс.Маркета):

4.2.2. Заполните название и описание приложения:

4.2.3. В разделе «Платформы» отметить галочкой: «Веб-Сервисы» и нажать кнопку «Подставить URL для разработки»:

4.2.4. В разделе «Доступы» отметьте галочкой «Яндекс.Маркет / поиск по товарам»:

4.2.5. В конце страницы нажмите кнопку «Создать приложение»:

4.2.6. Яндекс присваивает ID и пароль, которые необходимо внести в поля Yandex Client ID и Yandex client secret соответственно:

4.3. Yandex access token

Нажмите кнопку «Yandex получить токен» и поле Yandex access token заполниться автоматически:

4.4. Включение интеграции

5. Склады Маркетплейса

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

5.1. Зайдите в подсистему «E-Commerce» → «Справочники» → «Склады маркетплейса»:

5.2. Откройте созданный склад дважды кликнув по нему мышью:

5.3. В карточке склада необходимо заполнить поля:

• Наименование
• Склад 1С – существующий в вашей системе склад, с которого будут отправляться остатки на маркетплейс
• Отметить галочкой «Активен» — признак активности склада:

6. Тестирование заказов

Для проверки настроек и корректной работы модуля можно создать тестовый заказ в ЛК Яндекс.Маркета.

В разделе «Настройки» → «Тестовый заказ»: