Сопряжение с Prom.ua

<< Click to Display Table of Contents >>

Navigation:  Дополнительные функции >

Сопряжение с Prom.ua

Previous pageReturn to chapter overviewNext page

Посмотреть видео по настройке опции можно по ссылке иконка Ютуб.

 

Для начала работы с дополнительной функцией необходимо зарегистрировать свой магазин на prom.ua и получить API ключ.

Для получения API ключ необходимо отправить на почту api@prom.ua письмо с таким текстом:

Предоставьте, пожалуйста, ключ API для моей компании:

ID: 3023646

Сайт https://example-cs123456.prom.ua

почта, которая привязана к сайту example@mail.com

Стоит отметить, что у каждого предприятия будет свой ID, сайт и почта.

 

Обратите внимание! При синхронизация с Prom.ua происходит полная синхронизация с товарным справочником Торгсофт, а это значит - с сайта удалится всё, чего нет в Торгсофт.

 

После того, когда будет получен API ключ можно перейти к настройкам объекта синхронизации, заходим в пункт меню Склад - Синхронизация с интернет-магазином (пункт станет доступен после активации дополнительной функции) и создаем объект синхронизации, нажав на кнопку Добавить кнопка Добавить (Рис. 1 (1))

Объект синхронизации - PromUA

Рис. 1 (Версия программы 2019.0.2)

 

На форме Объект синхронизации заполняем Название, выбираем Категорию - Интернет-магазин (Рис. 1 (2)), Синхронизация через - Prom.ua (Рис. 1 (3)) и вводим полученный в письме API ключ (Рис. 1 (4)).

С описанием остальных настроек вкладок Общее, Клиенты, Центры учета, Время синхронизации, Файлы синхронизации можно ознакомиться здесь.

Отличия от синхронизации через файлы (доп.опция Сопряжение с интернет-магазином):

1. Указания куда поступают оплаты (Рис. 1 (5)) несущественно, но обязательно. Большинство заказов/счетов будет оформляться на то, что указал клиент при оформлении заказа. Для ассоциации способов оплаты на Prom.ua с нашими счетами и кассами необходимо:

в личном кабинете на сайте Prom.ua перейти в Настройки - вкладка Способы оплаты и добавить необходимые (например, Наличные, Безналичные и т.д.) (Рис. 2).

ПромЮА - сайт Способоы оплаты

Рис. 2

 

на форме редактирования Объект синхронизации перейти на вкладку Способы оплаты (Рис. 3). На данной вкладке необходимо нажать кнопку Загрузить/обновить способы оплаты кнопка Загрузить обновить способы оплат (Рис. 3 (1)) - будет загружен перечень возможных оплат.

Объект синхронизации - Способы оплаты

Рис. 3 (Версия программы 2019.0.2)

 

далее необходимо проассоциировать полученные способы оплат расчетными счетами или кассами в программе Торгсофт- выбираем способ оплаты и нажимаем Изменить кнопка Изменить (Рис. 4)

Способ оплаты заказа - редактирование

Рис. 4 (Версия программы 2019.0.2)

 

Название и Описание не меняется. Нужно выбрать куда поступают оплаты: в кассу или расчетный счет и выбрать соответствующее значение. Таким образом, при оплате заказа из Prom.ua деньги будут поступать на выбранный расчетный счет или кассу. Также необходимо указать является ли данный способ оплаты наложенным платежом (при создании счета будет установлена соответствующая галочка).

2. Добавлен Способ синхронизации фотографий (Рис. 1 (6)):

Не синхронизировать

Свой сайт - файлы выгружаются на FTP в папку (указывается Адрес доставки информации), которая является общедоступной для вашего сайта, и, добавив к имени файла префикс, получается прямая ссылка на фотографию. Обратите внимание, что все файлы старше одних суток удаляются из данной папки.

Через сервис uploads.ru (сторонний сервис, за работу которого мы не несем ответственности).  

3. На вкладке Файлы синхронизации (Рис. 5) из настроек оставлены только Название файла синхронизации товаров, по умолчанию TSGoods.xls.

Объект синхронизации - PromUA - Файлы синхронизации

Рис. 5 (Версия программы 2019.4.2)

 

Особенности формирования данных в файле синхронизации товаров:

1.Файл представляет собой xls документ на первом листе которого перечень товаров, а на втором перечень видов товаров (Рис. 6).

Перечеь товаров

Пример списка товаров

Перечень видов товара

Пример списка видов товара

Рис. 6

 

2.Первые пять колонок в перечне товаров всегда одинаковые, всегда присутствуют и никак не настраиваются. Последующие колонки - настраиваемые. Перечень видов товаров - колонки не настраиваемые.

3.По действию Добавить все поля в файл синхронизации (Рис. 7) добавляется перечень основных полей характеризующих товар, у которых есть однозначная ассоциация в Торгсофт и на Prom.ua. Название колонок для таких полей нельзя поменять. Для Prom.ua порядок колонок не имеет значения.

Объект синхронизации - PromUA - Файлы синхронизации - Добавить тип данных

Рис. 7 (Версия программы 2019.4.2)

 

4.Перед тем как начать заполнять перечень выгружаемых данных, необходимо ОБЯЗАТЕЛЬНО ознакомиться с http://support.prom.ua/documents/841 , там описано множество нюансов. Например, единица измерения товара может быть только из указаного в описании списка, оптовая цена будет работать только, если указано минимальное оптовое количество или заполнена политика оптовых цен. Также выгружать можно не только те характеристики, которые предлагаются по умолчанию. Любая характеристика из предложенного списка в Торгсофт может быть выгружена. Если для характеристики пользователь выбрал название колонки, которое совпадает с названием поля из http://support.prom.ua/documents/841 , то это будет выгружено как обычная характеристика (это же касается и динамических характеристик товара, если название колонки совпадает). Если же название колонки не совпадает ни с одним из перечисленных в справке, то это данное будет выгружено как Пользовательская характеристика в три колонки Название_Характеристики, Измерение_Характеристики, Значение_Характеристики. Это система довольно гибкая и практически любое поле из Торгсофт можно выгрузить как любое поле в Prom.ua.

При настройке объекта синхронизации семейства Prom.ua можно менять название колонки в поле файла синхронизации товаров для типов данных, у которых есть зарезервированное название на сервисе. Это позволяет более гибко настраивать синхронизацию с интернет-магазином. Например, розничную цену выгружать как оптовую.

Для примера возьмем описание товара в Торгсофт. Оно имеет ограничение в длине 255 символов, что крайне мало для любого интернет-магазина. Убираем из списка выгружаемых полей описание по умолчанию и добавляем какую-то динамическую характеристику товара, в которую пользователь заносит своё большое описание, либо  даже можно использовать какое-то статическое поле из Торгсофт большого размера, например Аналоги. Главное в названии колонки указать четко "Описание".

Стоит отметить, что есть возможность добавить описание товара как динамическую характеристику. Для этого необходимо создать динамическую характеристику с типом данных Текст и активировать настройку Хранить в HTML кодировке, которая позволяет добавлять красивое, большое и отформатированное описание, достаточно будет добавить данную характеристику в файлы синхронизации (Рис. 7). Подробнее читай тут. Данная настройка будет полезна для создания красивого и отформатированного описания товара.

 

Добавлены новые типы данных, для полей файла синхронизации товаров: Минимальное оптовое количество, Единица измерения, Скидка, Производитель, ID Модели. Стоит отметить, что если не выгружается минимальное оптовое количество, то нет смысла выгружать оптовую цену, без количества она не подтянется. Это является обязательным требование Prom.ua для оптовых цен.

 

Стоит отметить, что Prom.ua не поддерживает и не имеет аналогов некоторых переменных из Торгсофт. Например, характеристика Пол. Для того, чтобы Пол выгружался на сайт, необходимо в виде товара создать динамическую характеристику, которая будет использоваться для определения половой принадлежности. Новую характеристику нужно добавить в перечень файлов синхронизации (объект синхронизации) и те данные, которые были занесены в данную динамическую характеристику будут отображаться на сайте Prom.ua, в данном случае Пол.

 

С помощью кнопки Настройки импорта (Рис. 7) можно настроить импорт товаров сайтом при синхронизации. Настройки импорта соответствуют возможностям API данного сервиса и почти совпадает с настройками импорта на портале магазина (при ручном импорте из файла). Возможно управлять следующими настройками (Рис. 7а):

Общие настройки:

Обновить принудительно

Удалить группы которых нет в файле

Проверить категории во время импорта

Если родитель группы не найден - переносить в корневую

Помечать отсутствующие продукты следующим статусом - Оставить без изменений, Нет в наличие, Скрытые, Удаленные

Есть разновидности (модельный ряд)

Информация, которую нужно обновить:

Обновлять название

Обновлять код товара/артикул

Обновлять цену

Обновлять фото

Обновлять наличие

Обновлять количество

Обновлять описание

Обновлять группу

Обновлять поисковые запросы

Обновлять характеристики

Обновлять скидки

Настройки импорта - Prom.ua

Рис. 7а (Версия программы 2019.4.3)

 

Например, Вам необходимо, чтобы у товара оставалось описание. Необходимо снять галочку Обновить описание, и тогда после синхронизации описание товара на Prom.ua обновляться не будет.

 

Настройка Сертифицированная компания отвечает за установку товарам статуса "Гарантия наличия". Подробнее по ссылке. Данная настройка позволяет повысить приоритет выгружаемых товаров в каталог на prom.ua. Товары со статусом "Гарантия наличия" получают максимальный приоритет в каталоге Prom.

 

Выгрузка товаров с размерным рядом:

Для выгрузки размерного ряда необходимо:

1. В приложениях на Prom.ua добавить приложение Разновидности

2. Вместо названия товара выгружать название модели

3. В личном кабинете Prom.ua в настройках (Управление сайтом - Дизайн и оформление - Дополнительные настройки) нужно убрать одну галочку Разновидности в списке.

 

Отдельно нужно остановиться на типе данных "ID Модели", товары у которых одинаковый этот параметр будут выгружаться на сайт как разновидности одного товара https://support.prom.ua/documents/388 Т.е. товары размерного ряда одной модели имеют одинаковые "ID Модели", и на сайте покупателю не нужно будет бегать по разным товарам в поиске нужного размера, а при покупке модели, просто выбрать нужный размер. Естественно нужно в ручную в выгрузку добавить поле Размер, так как его нет в стандартном наборе данных. Без размера товары модельного ряда все равно сгруппируются, но покупатель просто не сможет выбрать нужный размер. По умолчанию в Торгсофт "ID Модели" для товаров не заполняется. Чтобы это включить нужно зайти в пункт меню Настройки - Параметры - Товар - Наименование включить Использовать Правило формирования модели товара (Рис. 8 (1))

ПромЮА - Использовать правило формирования модели

Рис. 8 (Версия программы 2019.0.2)

 

и нажать Настроить (Рис. 8 (2)). Нужно выбрать характеристики товара, которые определяют именно модель товара, исключив те, которые являются просто разновидностью модели, например размер, цвет и т.д) (Рис. 9).

ПромЮА - Правило формирования модели

Рис. 9 (Версия программы 2019.0.2)

 

После чего нажать Создать модели для всех товаров (Рис. 4 (3)) и обязательно установить галочку Создавать модель при создании товара. Без неё новые товары не будут объединяться в модель.

 

После создания Объекта синхронизации жмем кнопку Записать.

Список товаров обновляется по нажатию на кнопку Обновить кнопка Обновить (Рис. 10).

Синхронизация с интернет-магазином - ПромЮА

Рис. 10 (Версия программы 2019.0.2)

 

Для синхронизации с Prom.ua отображается вкладка Журнал синхронизации (Рис. 11).

Синхронизация с интернет-магазином - Журнал синхронизации

Рис. 11 (Версия программы 2019.0.2)

 

В журнале отображается список синхронизаций:

1.Результат (успешно, не успешно);

2.Тип синхронизации:

по таймеру - указывается при создании объекта синхронизации на вкладке Время синхронизации,

синхронизация товаров - по кнопке Провести синхронизацию;

загрузка заказов - загрузка из режима Заказ удаленного клиента.

3.Текст ошибок, если они были. Необходимо выбрать синхронизацию и нажать Просмотреть запись кнопка Просмотреть запись, откроется окно Журнал синхронизации, в котором будет отображен Текст ошибок, если они были (Рис. 12).

Журнал синхронизации - Текст ошибки

Рис. 12 (Версия программы 2019.0.2)

 

Для синхронизаций, у которых есть внешний ID можно Обновить статус кнопка Загрузить обновить способы оплат (внешний ID есть у Синхронизаций по таймеру и Синхронизации товаров). Это необходимо из-за особенности работы импорта Prom.ua, файл со списком товаров может быть успешно выгружен на сайт, но его обработка занимает значительное время и ошибки могут появиться позже. В связи с данной спецификой при каждой синхронизации товаров, происходит проверка предыдущей синхронизации. И если в ней обнаружены ошибки, то пользователям с правами хозяина (по умолчанию) будет дано соответствующее уведомление через систему уведомлений. Чтобы настроить каким пользователям отправлять уведомления об ошибках синхронизации перейдите в пункт Настройки - Пользователи - вкладка Получаемые уведомления (Рис. 13), в которой нужно Добавить (или Удалить) соответствующий тип уведомления (Ошибка + Интернет-магазин).

Получаемые уведомления - Ошибка интернет-магазина

Рис. 13 (Версия программы 2019.0.2)

 

После настройки уведомлений, пользователю будут поступать уведомления об ошибках синхронизации с интернет-магазином на главной форме программы (Рис. 14).

Главная форма - Уведомления

Рис. 14 (Версия программы 9.3.6)

 

По нажатию на иконку Уведомления иконка Уведомления (Рис. 14 (1)), откроется список Уведомлений для пользователя (Рис. 15). Также список уведомлений можно просмотреть во вкладке Уведомления (Настройки - Пользователи).

Уведомления пользователя об ошибка ИМ

Рис. 15 (Версия программы 2019.0.2)

 

После того, как будет проведена синхронизация, товары отобразятся на Вашем сайте Prom.ua.

 

Справка. Описание ошибок импорта и способы их исправления указаны в статье (ссылка на статью Ошибки при импорте).

 

Для получения и просмотра заказов из Интернет-магазина, необходимо зайти в Документ - Заказ удаленного клиента. Откроется одноименное окно (Рис. 16), где выбрав в поле Получить информацию с объекта синхронизации, можно загрузить все оформленные заказы на сайте Prom.ua.Заказы загружаются по таймеру или по действию Принять заказы кнопка Принять заказ. Загружаются только заказы со статусом Новый или Оплаченный. После загрузки, заказы со статусом Новый получают на сайте статус Принят. Если мы загружаем оплаченный заказ, то по нему сразу создается счет с указанным на сайте способом оплаты, минуя режим заказа удаленного клиента (более подробно про режим Заказ удаленного клиента можно прочитать здесь.

Заказ удаленного клиента - ПромЮА

Рис. 16 (Версия программы 2019.0.2)

 

Для синхронизаций с Prom.ua колонка Способ оплаты заполняется соответствующими данными.

Для заказов из Prom.ua доступно действие Отменить заказ кнопка Отменить заказ. Вы можете отменить заказ, для этого необходимо нажать действие и указать из списка причину отмены заказа и набрать сообщения для неё (Рис. 17). Для типов причины Изменилась цена, Недостаточно данных или Другое поле Сообщение обязательно к заполнению.

Отмена заказа

Рис. 17 (Версия программы 2019.0.2)

 

После отмены заказа он помечается соответствующим статусом как в Торгсофт, так и на сайте.

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

В Торговле с выпиской счета, счета сформированные от Prom.ua помечаются соответствующей пиктограммой иконка ПромЮА(Рис. 18).

ТВС - ПромЮА

Рис. 18 (Версия программы 2019.0.2)

 

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

Так же при создании контакта по счету от Prom.ua, если мы выбираем Отказ клиента или Отменен, то необходимо указать Причину отмены заказа для Prom.ua (Рис. 19). Поле Информация обязательно к заполнению, если тип причины Изменилась цена, Недостаточно данных или Другое.

Контакт счета - Причина отмены

Рис. 19 (Версия программы 2019.0.2)