Callback
  • Від місця на ринку до магазину

  • -

  • Від магазину до торговельної мережі

  • -

  • Від торгівлі до виробництва

Технічні вимоги для синхронізації інтернет-магазину з програмою Торгсофт

01.02.2019

1. Перелік товарів і ціни

Ваш інтернет-магазин повинен вміти завантажувати прайс-лист з файлу TSGoods.trs в форматі * .csv (роздільник;).

За замовчуванням файл містить наступні поля:

* Ключ товару - GoodID (пошуковий), integer

* Назва товару - string (500)

* Опис товару - string (255)

* Країна - string (100)

* Артикул - string (30)

* Ціна роздрібна - float

* Ціна оптова - float

* Ціна акційна (з товарної знижкою) - float

* Мінімальна кількість для замовлення клієнтом, шт - integer

* Висота, см = 0 - float

* Ширина, см = 0 - float

* Ідентифікатор розділу Інтернет-Магазину - Категорія - integer

* Кількість на складі - float

* Відображення (0- не відображати на сайті; 1 відображати на сайті),

* Розмір - string (20)

* Колір - string (50)

* Матеріал - string (200)

* Назва моделі товару - string (500)

* Стать - цілочисельне (0 - стать не визначена, 1 - чоловіча, 2 - жіноча, 3 - хлопчик, 4 - дівчинка, 5 - унісекс)

* Коротка назва товару - string (255)

* Вид товару повністю - string, містить всю ієрархію виду товару зверху вниз, розділені між собою комами (приклад "одяг, джинси, класика") (максимальна довжина не визначена)

* Колекція виробника повністю - string, містить всю ієрархію колекції виробника зверху вниз, розділені між собою комами (приклад "Польща, WOJCIK") (максимальна довжина не визначена)

* Сезон - string (100)

* Штрих-код - string (40) // з версії бази даних 376

* Упаковка - string (255) // з версії бази даних 380

* Розмір упаковки - string (255) // з версії бази даних 380

* Харчування - string (255) // з версії бази даних 380

* Кількість штук в ящику - string (255) // з версії бази даних 380

* Вік - string (255) // з версії бази даних 380

* Міра - float // з версії бази даних 380

* Одиниця виміру міри - string (255) // з версії бази даних 380

* Ознака уцінки товару - (0 - не знижений в ціні, 1 - знижений у ціні товар) // з версії бази даних 403

* Ціна за одиницю міри - float // з версії бази даних 428

* Оптова ціна за одиницю міри - float // з версії бази даних 428

* Еквівалент роздрібної ціни - float // з версії бази даних 449

* Еквівалент оптової ціни - float // з версії бази даних 449

* Валюта еквівалентної ціни -string (3) // з версії бази даних 449

* Собівартість - float // з версії бази даних 461 (назва колонки за замовчуванням - PrimeCost)

* Код постачальника - string (255) // з версії бази даних 461

* Аналоги - string (1000) // з версії бази даних 481

 

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

Для файлу * .csv назви колонок можуть бути сформовані автоматично або для кожної характеристики назва може бути задано власноруч. Як ви назвете поля у вашій базі інтернет-магазину - не має значення, чи будете ви їх усі використовувати чи ні - теж.

 

Список товарів (прайс) і замовлення клієнта повинні знаходиться в будь-якої папці на ftp-сервері. Фотографії товару повинні знаходиться в іншій папці.

2. Фотографії товару

Назва фотографій товарів формується за наступним принципом: фотографія товару має назву, аналогічну GoodID товару, а розширення файлів фотографій відповідати їх типу. Якщо товару присвоєно кілька фотографій, то назва наступних фотографій формується як Код фотографії (GoodID), нижнє підкреслення, номер додаткової фотографії (не обов'язково по порядку), точка, розширення файлу. (Підтримка додаткових фотографій доступна з версії БД 452)

 

3. Список клієнтів

Також Торгсофт може формувати файл *.csv (роздільник;) з клієнтською базою TSClients.trs (чи формувати даний файл  - вирішує користувач, відповідно до налаштувань), файл відправляється в ту саму папку, що і TSGoods.trs.

Набір полів:

1. ПІБ - string (100)

2. e-mail - string (50)

3. Номер телефону, мобільний - string (100)

4. Знижка клієнта - float

5. Міський телефон - string (255)

6. Номер картки (штрих-код клієнта) -string (16)

7. Індекс - string (15)

8. Країна - string (50)

9. Область - string (100)

10. Місто - string (50)

11. Адреса - string (255)

12. Додаткова інформація - string (максимальна довжина не визначена)

13. Сума для розрахунку знижки - float

14. Сума накопичених бонусів - float

 

4. Політика оптових цін (починаючи з версії БД 447)

При активації додаткової функції "Політика оптових цін" файл з описом політики оптових цін в форматі xml може бути переданий на FTP-сервер в папку зі списком товару.

Приклад файлу:

<?xml version="1.0" encoding="UTF-8"?>

<WholesalePrice>

  <Good GoodID="1378">

<Price>

   <Quantity>2</Quantity>

   <QuantityPrice>33</QuantityPrice>

</Price>

<Price>

   <Quantity>3</Quantity>

   <QuantityPrice>32</QuantityPrice>

</Price>

<Price>

   <Quantity>5</Quantity>

   <QuantityPrice>30</QuantityPrice>

</Price>

  </Good>

  <Good GoodID="42">

<Price>

   <Quantity>2</Quantity>

   <QuantityPrice>6.5</QuantityPrice>

</Price>

<Price>

   <Quantity>3</Quantity>

   <QuantityPrice>6.3</QuantityPrice>

</Price>

<Price>

   <Quantity>5</Quantity>

   <QuantityPrice>6.1</QuantityPrice>

</Price>

  </Good>

</WholesalePrice>

 

Опис тегів:

WholesalePrice - батьківська секція (кореневий елемент)

Good - секція товару, має один параметр GoodID - ключ товару (пошуковий), цілочисельний

Price - секція ціни

Quantity - секція кількості, значення - кількість для переходу, float

QuantityPrice - секція ціни, значення - ціна при переході, float

 

5. Список подарункових сертифікатів (починаючи з БД 470)

При активованої платній функції "Подарункові сертифікати" в інтернет-магазин може бути вивантажений файл зі списком подарункових сертифікатів TSGiftCertificate.trs в форматі *.csv (роздільник;). Файл відправляється в ту саму папку, що і TSGoods.trs.

Набір полів:

1. Штрих-код сертифіката - string (40)

2. Сума сертифіката - float

3. Дата закінчення терміну дії сертифіката - дата формату ddmmyyyy (якщо відсутня, то у сертифіката немає терміну дії або він відраховується від дати продажу сертифіката, але ще не проданий)

4. Тип сертифіката - може приймати значення 1 або 2 (1 випущений, можна продати, але не можна використовувати для оплати покупок; 2 - куплений клієнтом, можна використовувати для оплати покупок)

6. Формування замовлення з інтернет-магазину

Файл замовлення з інтернет магазину повинен бути простим текстовим файлом з розширенням *.sal і мати такий вигляд (аналогічно ini-файлу):

[Client] (Блок інформації про клієнта)

Name = ПІБ

Mphone = 0672356147

CPhone = 2568974

ZIP = 61072

Country = Україна

Region = Харківська

City = Харків

Address = вул. Тобольська 42-А

EMail=info@torgsoft.ua

 

[Options] (Блок інформації про замовлення)

OrderNumber = 12/21

Comment = Доставка з 14 до 18

DeliveryCondition = Нова Пошта - string (255) // з 390 версії бази даних

ReserveDate = 28082013 - дата резерву в форматі ddmmyyyy // з 392 версії бази даних

SaleType = 1 *

BonusPay = 28,50 -float, сума, яку клієнт оплатив бонусами // з 463 версії бази даних

GiftCertificate = +9567200000106,9567200000182 - перелік подарункових сертифікатів, використаних клієнтом для оплати замовлення через кому // з 470 версії бази даних

OrderDate = 2009-01-31 1:55:14 - дата оформлення замовлення (необов'язкове поле) в форматі yyyy-mm-dd hh: mm: ss // з 470 версії бази даних

  

[1] (Блок інформації про перший товар замовлення)

 

GoodID = 201 (Ключ товару)

Price = 120,05 (Ціна продажу товару)

Count = 20 (Кількість замовленого товару)

 

[2] (Блок інформації про другий товар замовлення)

GoodID = 20294

Price = 19,00

Count = 1

 ....

[N] (Блок інформації про n-му товарі замовлення)

GoodID = 13854

Price = 63,00

Count = 5

* Значення SaleType може бути від 1 до 5:

1 - попереднє замовлення (створюється замовлення, за яким можна буде створити рахунок)

2 - оформлено продаж (створюється рахунок зі 100% передоплатою),

3 - оформлено продаж з відвантаженням (створюється рахунок зі 100% передоплатою, за яким відбувається відвантаження товару (створення видаткової накладної))

4 - оформлено продаж з відвантаженням, але без оплати (створюється рахунок без оплати, за яким відбувається відвантаження товару (створення видаткової накладної))

5 - тільки рахунок (замовлення не створюється, створюється одразу рахунок)

 

 

Кодування файлів із замовленнями - Win-1251 або UTF-8 (c 428 версії БД), в залежності від налаштування Об'єкту синхронізації в Торгсофт.

 

Виникли питання?

Напишіть нам на e-mail service@torgsoft.ua або telegram @torgsoft_help

 

Додати коментар

Додати коментар
Ваш відгук відправлено. Його опублікують після перевірки адміністратором