Синхронізація з 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))

Об'єкт синхронізації - ПромЮА

Мал. 1 (Версія програми 2020.6.2)

 

На формі Об'єкт синхронізації заповнюємо Назва, вибираємо Категорію - Інтернет-магазин (Мал. 1 (2)), Синхронізація через - Prom.ua (Мал. 1 (3)) і вводимо отриманий в листі API ключ (Мал. 1 (4)).

З описом інших налаштувань на вкладках Загальна, Клієнти, Центри обліку, Час синхронізації, Файли синхронізації можна ознайомитися тут.

Відмінності від синхронізації через файли:

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

в особистому кабінеті на сайті Prom.ua перейти в Настройки - вкладка Способи оплати та додати необхідні (наприклад, Готівкові, Безготівкові і т.д.) (Мал. 2).

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

Мал. 2

 

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

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

Мал. 3 (Версія програми 2020.6.2)

 

далі необхідно проасоціювати отримані способи оплат з розрахунковими рахунками або касами в програмі Торгсофт- вибираємо спосіб оплати і натискаємо Змінити кнопка Змінити (Мал. 4)

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

Мал. 4 (Версія програми 2020.6.2)

 

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

2. Додано Спосіб синхронізації фотографій (Мал. 1 (6)):

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

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

Через сервіс uploads.ru (сторонній сервіс, за роботу якого ми не несемо відповідальності).

3. На вкладці Файли синхронізації (Мал. 5) з налаштувань залишено тільки Назва файлу синхронізації товарів, за замовчуванням TSGoods.xls.

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

Мал. 5 (Версія програми 2020.6.2)

 

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

1.Файл представляє собою xls документ на першому аркуші якого перелік товарів, а на другому перелік видів товарів (Мал. 6).

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

Приклад переліку товарів

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

Приклад переліку видів товару

Мал. 6

 

2.Перші п'ять колонок в переліку товарів завжди однакові, завжди присутні і ніяк не настроюються. Наступні колонки - настроюються. Перелік видів товарів - колонки не настроюється.

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

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

Мал. 7 (Версія програми 2020.6.2)

 

4.Перед тим як почати заповнювати перелік даних, які будуть вивантажуватися, необхідно ОБОВ'ЯЗКОВО ознайомитися з http://support.prom.ua/documents/841, там описано безліч нюансів. Наприклад, одиниця виміру товару може бути тільки з вказаного в описі переліку, оптова ціна буде працювати тільки, якщо вказано мінімальну оптову кількість або заповнена політика оптових цін. Також вивантажувати можна не тільки ті характеристики, які пропонуються за замовчуванням. Будь-яку характеристику із запропонованого списку в Торгсофт може бути вивантажено. Якщо для характеристики користувач вибрав назву колонки, яка збігається з назвою поля з http://support.prom.ua/documents/841, то це буде вивантажено як звичайна характеристика (це ж стосується і динамічних характеристик товару, якщо назва колонки збігається). Якщо ж назва колонки не збігається ні з однією з перерахованих в довідці, то це дане буде вивантажено як для користувача характеристика в три колонки Назва_Характеристики, Вимірювання_Характеристики, Значенння_Характеристики. Ця система досить гнучка і практично будь-яке поле з Торгсофт можна вивантажити як будь-яке поле в Prom.ua.

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

 

Варто зазначити, що є можливість додати опис як динамічну характеристику. Для цього необхідно створити динамічну характеристику з типом даних Текст і активувати настройку Зберігати в HTML кодуванні, яка дозволяє додавати красивий, великий та відформатований опис, досить буде додати цю характеристику в файли синхронізації (Мал. 7). Детальніше читай тут. Ця установка буде корисна для створення красивого і відформатованого опису товару.

 

Додані нові типи даних, для полів файлу синхронізації товарів: Мінімальна оптова кількість, Одиниця виміру, Знижка, Виробник, ID Моделі. Варто зазначити, що якщо не вивантажується мінімальна оптова кількість, то немає сенсу вивантажувати оптову ціну, без кількості вона не підтягнеться. Це є обов'язковою вимогою Prom.ua для оптових цін.

 

Варто зазначити, що Prom.ua не підтримує і не має аналогів деяких змінних з Торгсофт. Наприклад, характеристика Стать. Для того, щоб Стать вивантажувалася на сайт, необхідно у виді товару створити динамічну характеристику, яка буде використовуватися для визначення статевої приналежності. Нову характеристику потрібно додати в перелік файлів синхронізації (об'єкт синхронізації) і ті дані, які були занесені в дану динамічну характеристику будуть відображатися на сайті Prom.ua, в даному випадку Стать.

 

За допомогою кнопки Налаштування імпорту можна налаштувати імпорт товарів сайтом при синхронізації. Налаштування імпорту відповідають можливостям API даного сервісу і майже збігається з настройками імпорту на порталі магазину (при ручному імпорті з файлу). Можливо управляти наступними настройками (Мал. 7а):

Загальні налаштування:

Оновити примусово

Видалити групи яких немає в файлі

Перевірити категорії під час імпорту

Якщо батька з групи не знайдено - переносити до кореневої

Позначати відсутні продукти наступним статусом - Залишити без змін, Ні в наявність, Приховані, Дистанційні

Є різновиди (модельний ряд)

Інформація, яку потрібно оновити:

Оновлювати назву

Оновлювати код товару / артикул

Оновлювати ціну

Оновлювати фото

Оновлювати наявність

Оновлювати кількість

Оновлювати опис

Оновлювати групу

Оновлювати пошукові запити

Оновлювати характеристики

Оновлювати знижки

Налаштування імпорту - Prom.ua

Мал. 7 (Версія програми 2020.6.2)

 

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

 

Налаштування Сертифікована компанія відповідає за установку товарам статусу "Гарантія наявності". Детальніше за посиланням. Ця установка дозволяє підвищити пріоритет товарів, що вивантажуються в каталог на prom.ua. Товари зі статусом "Гарантія наявності" отримують максимальний пріоритет в каталозі Prom.

 

Вивантаження товарів з розмірним рядом:

Для вивантаження розмірного ряду необхідно:

1. На Prom.ua додати додаток Різновиди

2. Замість назви товару вивантажувати назву моделі

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

 

Окремо потрібно зупинитися на типі даних "ID Моделі", товари у яких однаковий цей параметр вивантажуватимуться на сайт як різновид одного товару https://support.prom.ua/documents/388 . Тобто товари розмірного ряду однієї моделі мають однакові "ID Моделі", і на сайті покупцеві не потрібно буде бігати по різних товарах в пошуку потрібного розміру, а при покупці моделі, просто вибрати потрібний розмір. Звісно потрібно в ручну в вивантаження додати поле Розмір, так як його немає в стандартному наборі даних. Без розміру товари модельного ряду все одно згрупуються, але покупець просто не зможе вибрати потрібний розмір. За замовчуванням в Торгсофт "ID Моделі" для товарів не заповнюється. Щоб це включити потрібно зайти в пункт меню Налаштування - Параметри - Товар - Найменування включити Використовувати Правило формування моделі товару (Мал. 8 (1))

Параметри - Товар - Найменування - ПромЮА

Мал. 8 (Версія програми 2020.6.2)

 

та натиснути Налаштувати (Мал. 8 (2)). Потрібно вибрати характеристики товару, які визначають саме модель товару, виключивши ті, які є просто різновидом моделі, наприклад розмір, колір і т.д. (Мал. 9).

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

Мал. 9 (Версія програми 2020.6.2)

 

Після чого натиснути Створити моделі для всіх товарів (Мал. 4 (3)) і обов'язково встановити галочку Створювати модель при створенні товару. Без неї нові товари не будуть об'єднуватися в модель.

 

Після створення Об'єкту синхронізації тиснемо кнопку Записати.

Перелік товарів оновлюється після натискання на кнопку Оновити кнопка Оновити (Мал. 10).

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

Мал. 10 (Версія програми 2020.6.2)

 

Для синхронізації Prom.ua відображається вкладка Журнал синхронізації (Мал. 11).

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

Мал. 11 (Версія програми 2020.6.2)

 

У журналі відображається перелік синхронізацій:

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

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

за таймером - вказується при створенні об'єкта синхронізації на вкладці Час синхронізації,

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

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

3.Текст помилок, якщо вони були. Необхідно вибрати синхронізацію і натиснути Переглянути запис кнопка Переглянути запис, відкриється вікно Журнал синхронізації, в якому буде відображений Текст помилок, якщо вони були (Мал. 12).

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

Мал. 12 (Версія програми 2020.6.2)

 

Для синхронізацій, у яких є зовнішній ID можна Оновити статус кнопка Загрузить обновить способы оплат (Зовнішній ID є у Синхронізації за таймером і Синхронізації товарів). Це необхідно через особливості роботи імпорту Prom.ua, файл зі списком товарів може бути успішно вивантажений на сайт, але його обробка займає чимало часу і помилки можуть з'явитися пізніше. У зв'язку з даною специфікою при кожній синхронізації товарів, відбувається перевірка попередньої синхронізації. І якщо в ній виявлені помилки, то користувачам з правами власника (за замовчуванням) буде дано відповідне повідомлення через систему повідомлень. Щоб налаштувати яким користувачам відправляти повідомлення про помилки синхронізації перейдіть в пункт Налаштування - Користувачі - вкладка Повідомлення, що отримуються (Мал. 13), в якій потрібно Додати (або Видалити) відповідний тип повідомлення (Помилка + Інтернет-магазин).

Користувачі - Повідомлення про помилку ІМ

Мал. 13 (Версія програми 2020.6.2)

 

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

Торгсофт - Головні - Повідомлення

Мал. 14 (Версія програми 2020.6.2)

 

При натисканні на кнопку Повідомлення іконка Повідомлення (Мал. 14 (1)), відкриється список Повідомлення для користувача (Мал. 15).Також перелік сповіщень можна переглянути у вкладці Повідомлення (Налаштування - Користувачі).

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

Мал. 15 (Версія програми 2020.6.2)

 

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

 

Довідка. Опис помилок імпорту та способів їх виправлення знаходяться в статті (посилання на статтю Помилки при імпорті).

 

Для отримання і перегляду замовлень з Інтернет-магазину, необхідно зайти в Документ - Замовлення віддаленого клієнта. Відкриється однойменне вікно (Мал. 16), де вибравши в поле Отримати інформацію з об'єкта синхронізації, можна завантажити все оформлені замовлення на сайті Prom.ua. Замовлення завантажуються за таймером або за дією Прийняти замовлення кнопка Принять заказ. Завантажуються тільки замовлення зі статусом Новий або Оплачений. Після завантаження, замовлення зі статусом Новий отримують на сайті статус Прийнято. Якщо ми завантажуємо оплачене замовлення, то по ньому відразу створюється рахунок із зазначеним на сайті способом оплати, минаючи режим замовлення віддаленого клієнта (більш детально про режим Замовлення віддаленого клієнта можна прочитати тут ).

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

Мал. 16 (Версія програми 2020.6.2)

 

Для синхронізацій з Prom.ua колонка Спосіб оплати заповнюється відповідними даними.

Для замовлень з Prom.ua доступна дія Скасувати замовлення кнопка Отменить заказ. Ви можете скасувати замовлення, для цього необхідно натиснути дію і вказати зі списку причину скасування замовлення та ввести повідомлення для неї (Мал. 17). Для типів причини Змінилася ціна, Недостатньо даних або Інше поле Повідомлення обов'язково до заповнення.

Скасування замовлення

Мал. 17 (Версія програми 2020.6.2)

 

Після скасування замовлення воно позначається відповідним статусом як в Торгсофт, так і на сайті.

При створенні рахунку з режиму замовлення віддаленого клієнта, рахунок буде сформовано на розрахунковий рахунок, який відповідає способу оплати, і в подальшому при оплаті він буде пропонуватися за замовчуванням. Якщо спосіб оплати прив'язаний до каси, то дана інформація при створенні рахунку буде загублена і ніяк автоматично не використовуватиметься.

У торгівлі з випискою рахунку, рахунки сформовані від Prom.ua позначаються відповідною піктограмою иконка ПромЮА(Мал. 18).

ТВР - ПромЮА

Мал. 18 (Версія програми 2020.6.2)

 

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

1.При відвантаженні рахунку, статус замовлення в інтернет-магазині змінюється на Виконано. Якщо рахунок відвантажується разом з оплатою (дія Створити накладну і оплатити її), статус замовлення в інтернет-магазині змінюється на Оплачено і відразу ж на Виконано. Таким чином замовнику буде надіслано повідомлення і про оплату та про виконання замовлення.

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

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

Так само при створенні контакту за рахунком від Prom.ua, якщо ми вибираємо Відмова клієнта або Скасовано, то необхідно вказати Причину скасування замовлення для Prom.ua (Мал. 19). Поле Інформація обов'язково до заповнення, якщо тип причини Змінилася ціна, Недостатньо даних або Інше.

ТВР - Контакти рахунку - причина скасування

Мал. 19 (Версія програми 2020.6.2)