Torgsoft
Выберите язык RU UA
Главная » Статьи » Практика применения "ТоргСофт" » Синхронизация программы учета с Интернет-магазином

 

Синхронизация программы учета с Интернет-магазином

Описание формата синхронизации Интернет-магазина с ТоргСофт. Информация для web-разработчика

1. Загрузка товаров на сайт:

Перечень того, что должен уметь интернет-магазин, для удачного сопряжения.

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

* Ключ товара - GoodID (поисковый), целочисленный

* Название товара - строковое (500)

* Описание товара - строковое (255)

* Страна - строковое (100)

* Артикул - строковое (30)

* Цена розничная - вещественное

* Цена оптовая - вещественное

* Цена акционная  (с товарной скидкой)  - вещественное

* Минимальное количество для заказа клиентом, шт - целочисленное

* Высота, см =0 - вещественное

* Ширина, см =0 - вещественное

* Идентификатор раздела Интернет-Магазина - Категория - целое число

* Кол-во на складе  - вещественное

* Отображение (0- не отображать на сайте; 1- отображать на сайте),

* Размер - строковое (20)

* Цвет - строковое (50)

* Материал - строковое (200)

* Название модели товара - строковое (500)

* Пол - целочисленное (0 - пол не определен, 1 - мужской, 2 - женский, 3 - мальчик, 4 - девочка, 5 - унисекс)

* Краткое название товара - строковое (255)

* Вид товара полностью - строковое, содержит всю иерархию вида товара сверху вниз, разделенные между собой запятыми (пример "одежда,джинсы,клешь") (максимальная длина не определена)

* Коллекция производителя полностью - строковое, содержит всю иерархию коллекции производителя сверху вниз, разделенные между собой запятыми (пример "Польша,WOJCIK") (максимальная длина не определена)

* Сезон - строковое (100)

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

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

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

* Питание - строковое (255) //с версии базы данных 380

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

* Возраст - строковое (255) //с версии базы данных 380

* Мера - вещественное //с версии базы данных 380

* Единица измерения меры - строковое (255) //с версии базы данных 380

* Признак уценки товара - целочисленное (0 - не уценен, 1 - уцененный товар) //с версии базы данных 403

* Цена за единицу меры - вещественное //с версии базы данных 428

* Оптовая цена за единицу меры - вещественное //с версии базы данных 428

* Эквивалент розничной цены - вещественное //с версии базы данных 449

* Эквивалент оптовой цены - вещественное //с версии базы данных 449

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

* Себестоимость - вещественное //с версии базы данных 461 (название колонки  по умолчанию - PrimeCost)

* Код поставщика - строковое (255) // с версии базы данных 461 (название колонки  по умолчанию - SuppLierCode)

 

 Прайс и заказы находятся в какой-то папке на ftp сервере, Фотографии находятся в другой папке и имеют название, аналогичное GoodID, а

расширение файлов фотографий соответствует их типу.

* С 452 версии базы данных, в папку с фотографиями перемещаются также дополнительные фотографии товара с именем такого формата:

Код фотографии (ID товара), нижнее подчеркивание, номер дополнительной фотографии (не обязательно по порядку), точка, расширение файла.

Как Вы назовете поля в Вашей базе интернет-магазина -  непринципиально, будете ли Вы их все использовать или нет - тоже.

Дополнительные опции:

а) Настройки порядка полей в *.csv файле и возможность исключать ненужные для интернет-магазина поля из файла.

б) Формировать название колонок в *.csv файле. Они могут формироваться как автоматически, так и вручную пользователем.

 

2. Для обработки заказов в программе:

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

Набор полей :

1. ФИО - строковое поле (100)

2. e-mail - строковое поле (50)

3. Номер телефона, мобильный  - строковое поле (100)

4. Скидка клиента - вещественное поле

5. Городской телефон - строковое поле (255)

6. Номер карты (штрих-код клиента) - строковое поле (16)

7. Индекс - строковое поле (15)

8. Страна - строковое поле (50)

9. Область - строковое поле (100)

10. Город - строковое поле (50)

11. Адрес - строковое поле (255)

12. Дополнительная информация - строковое поле неопределенное (максимальная длина не определена)

13. Сумма для расчета скидки - вещественное поле

14. Сумма накопленных бонусов - вещественное поле

 

3. Формировать заказы в файлы такого типа (простые текстовые с расширением sal):

[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=Новая Почта  - строковое (255)  //с 390 версии базы данных

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

SaleType=1*

BonusPay=28,50 - вещественное число, отображающее сумму по заказу, которую клиент оплатил бонусами //с 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 версии БД), в зависимости от настройки Объекта синхронизации.

 

4. Экспорт политики оптовых цен (c 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 - секция количества, значение - количество для перехода, вещественный

QuantityPrice - секция цены, значение - цена при переходе, вещественный

 

5. Экспорт подарочных сертификатов (c 470 версии БД) в файл *.csv формата с названием TSGiftCertificate.trs

Формировать ли данный файл (имя файла можно изменить), решает пользовательсоответствующей настройкой, отправляется в ту же папку, что и TSGoods.trs.

Набор полей:

1. Штрих-код сертификата - строковое поле (40)

2. Сумма сертификата - вещественное поле

3. Дата окончания срока действия сертификата - дата формата ddmmyyyy (если отсутствует, то у сертификата нет срока действия или он отсчитывается от даты продажи сертификата, но еще не продан)

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

21.06.2017

×
Тестировать Торгсофт® онлайн
Ознакомьтесь с Политикой конфиденциальности Торгсофт® и поставьте галочку, в случае согласия с ней.
Получить доступ к Торгсофт® онлайн
×
Оставить отзыв
Введите, пожалуйста, корректный адрес электронной почты.
Отправить отзыв

Благодарим Вас за отзыв! Для нас очень ценно Ваше мнение!

×
Установите мне программу
Ознакомьтесь с Политикой конфиденциальности Торгсофт® и поставьте галочку, в случае согласия с ней.
Отправить запрос
Ваш запрос отправлен. Наши специалисты свяжутся с Вами
×
Скачать демо
Ознакомьтесь с Политикой конфиденциальности Торгсофт® и поставьте галочку, в случае согласия с ней.
Отправить запрос
Скачать демо

Не получилось установить с помощью первой ссылки? Воспользуйтесь этими

Скачать Торгсофт с Яндекс. Диск

Скачать Торгсофт с Google Drive