<< Click to Display Table of Contents >> Navigation:  Дополнительные функции > Сопряжение с Prom.ua

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

 

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

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

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

ID: 3023646

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

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

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

 

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

 

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

 

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

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

 

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

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

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

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

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

Рис. 2

 

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

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

 

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

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

 

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

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

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

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

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

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

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

 

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

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

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

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

Рис. 6

 

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

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

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

 

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

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

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

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

 

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

 

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

 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

 

Настройки Сертифицированная компания отвечает за установку товарам статуса товара в наличии "На складе". Компании с высоким уровнем качества обслуживания могут указать, что их товары есть «на складе». Такие товары будут иметь приоритет в выдаче на Prom. Отметка наличия "На складе" — это подтверждение от продавца, что товар точно налицо (на собственном складе или складе поставщика) и готов к отправке. Более подробно по ссылке.

 

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

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

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

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

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

 

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

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

 

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

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

 

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

 

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

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

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

 

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

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

 

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

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

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

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

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

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

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

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

 

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

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

 

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

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

 

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

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

 

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

 

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

 

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

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

 

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

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

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

 

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

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

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

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

 

Принцип изменения статусов заказа:

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

2.При полной оплате (и переплате) не отгруженного счета, статус заказа в интернет-магазине меняется на Оплачен.

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

 

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

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

 

Импорт товаров через ссылку

Обратите внимание! Если файл импорта превышает 10Мб, то импорт товара напрямую становится невозможным (при превышении размера файла будет отображаться соответствующее сообщение). В таком случае следует использовать импорт через ссылку на файл. Для этого необходимо в объекте синхронизации заполнить поля Адрес доставки и Префикс ссылки на файл (Рис. 20).

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

 

Если эти поля будут заполнены, импорт товаров будет происходить через ссылку на файл.

Prom загрузит файл по указанной вами ссылке (Рис. 21 (1)) и начнет импорт.

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

 

Если файл по какой-либо причине невозможно загрузить по ссылке, будет соответствующее сообщение (Рис. 21 (2)).