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 01: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

Комментарии
Отзывов нет

Добавить комментарий

Добавить комментарий
Ваш отзыв отправлен. Его опубликуют после проверки администратором