0 Товары |
0.00 грн.

Ваша корзина

Сумма
Итоговая сумма:
0.00 грн.
В корзину
Среда, 04 декабря 2013 19:43

Cтруктура файлов для CashFront 3.5.5.0

Автор
Оцените материал
(0 голосов)

В процессе работы с СashFornt (далее программа) используются текстовые файлы для хранения и обмена данными (содержатся в каталоге синхронизации). Эти файлы дают возможность экспортировать новые данные в программу и импортировать данные во внешние приложения (бек-офис). Каталог с данными (Каталог синхронизации) содержит четыре подкаталога: «Price», «Jornal», «Sales» и «Invoice». Эти подкаталоги служат для консолидации однообразной информации:

«Price»- Содержит информацию о текущем прайсе (артикулах или товарах) , дисконтных картах, скидках и остатков товаров на текущий момент выполнения программы.

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

«Sales»- Содержит накопленную информацию о проведенных операциях в программе (расшифровка чеков по артикулам), информация фрагментирована по суткам, каждый файл содержит данные о прошедших сутках работы программы.

«Invoice»- Служит для импорта данных об артикулах и остатков из внешних приложений, после захвата файлов программой автоматически очищается.

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

Каталог «Price»:

Служит для помещения файлов с входящими данными из бэк-офиса, прайса, дисконтов и скидок. Могут изменятся бэк-офисом во время выполнения программы.

price.txt:                          файл данных об артикулах 

disc.txt:                            файл данных о дисконтных картах

promo.txt:                        файл данных об акциях и скидках

unsgoods.bin :                  файл данных об остатках товара, двоичный формат *

transact.log :                    Лог файл с информацией о последней транзакции, удаляется после успешной завершения транзакции *

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

Каталог « Jornal»:

Служит для помещения файлов с выходящими данными из CashFront, содержит идентификаторы операций (чеков) с описаниями и признаками. Могут удалятся бэк-офисом во время выполнения программы.

Имена файлов содержат значение даты, каждый файл формируется за текущие сутки:

ДД.ММ.ГГГГ.txt: где ДД—дата. число, ММ- месяц, ГГГГ - год. Данные о чеках

Участвует в выгрузке данных на фтп  ( файл "fcДДММГГГГ.txt").

Каталог «Sales»:

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

Имена файлов содержат значение даты, каждый файл формируется за текущие сутки:

ДД.ММ.ГГГГ.txt: где ДД—дата. число, ММ- месяц, ГГГГ - год. Данные о чеках

Участвует в выгрузке данных на фтп  ( файл "fsДДММГГГГ.txt").

Каталог «Invoice»:

Служит для помещения файлов с входящими данными из бек-офиса, после захвата файла программа очищает каталог автоматически. Файлы должны иметь обязательное расширение «ИмяФайла.INV», ИмяФайла –произвольное, строка с идентификатором входящей накладной.  

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

 

РАСШИФРОВКИ ПОЛЕЙ ФАЙЛОВ


price.txt:  файл данных об артикулах

Для загрузки данных об артикулах (товарах) из внешних программ используется файл price.txt. Файл price.txt предназначен для обновления цен товаров и ввода новых товаров, а также блокировки существующих товаров. Это файл можно использовать для упрощенной передачи данных из бек-офиса, если кассы расположены в пределах локальной сети (режим учета остатков отключен). В синхронном режиме (две или более касс, которые используют  один каталог обмена данными) этот файл служит для синхронизации артикулов между кассами. Пространство кодов в этих файлах может пересекаться, уникальным для артикула имеет значение пара кодов (код | штрих-код) в  случае совпадения информация об артикуле будет замещена последней записью. Каждая строка в этом файле означает информацию о товаре. Сведения о товаре разделены между собой знаком «|» Пример фрагмента файла:

------------------------------------------------------------------------------------------------------------------

2683|4607014270038|Водка Немирофф 05  Lait|бут.|45.50|0.00|FISCAL|1|0|0

1037|4607006371026|GOLD 250г Флекс Корн №6|шт.|14.50|0.00|PRINTER|1|0|0

-------------------------------------------------------------------------------------------------------------------

Назначение полей:

 <Код>|<Штрих-Код>|<Наименование>|<Ед>|<Цена>|<Макс.скидка>|<Регистратор>|<НГ>|<Весовой>|<Блок>

Где:

Код – число, 5 знаков,  внутренний код товара

Штрих-Код – число, 13 знаков.  штрих-код упаковки товара

Наименование – строка, наименование товара

Цена – десятичное число, цена товара

Макс. скидка – десятичное число, ограничение скидки на товар в процентах

Регистратор – строка, идентификатор регистратора

НГ- число от 0 до 5 , налоговая группа товара

Весовой - число 0 или 1 в зависимости от типа товара. 0-штучный,1-весовой

Блок- число 0 или 1 запрет на продажу товара. 0-продажа,1-запрет на продажу

Информация в этом файле может содержаться только об измененных артикулах, в этом случае «CashFront» обновляет только эти артикулы.

disc.txt : файл данных о дисконтных картах

Для загрузки данных о дисконтах (скидках) из внешних программ используется файл disc.txt,:. Каждая строка в этом файле означает информацию о дисконтной карте. Сведения о дисконтной карте разделены между собой знаком «|» Пример фрагмента файла:

--------------------------------------------------------------------------------------------

9900002507140|Алексеев |0,00|14.01.2020 0:00:00|0|Киев, Саксагнского 10/и 335 кв.|0509999999|14.01.1975 9:04:25|Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра.|0,00

9900000002107|Босс |10,00|14.01.2020 0:00:00|0|Киев, Леси-Украинки 13|07756893654|14.01.1961 9:04:25|Директор магазина|0,00

9900000002091|Генадий |5,00|14.01.2020 0:00:00|0|Москва, пр. Вернадского 95 /156|0978888888|14.01.1968 9:04:25|Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра.|168,00

--------------------------------------------------------------------------------------------

 Размещение полей:

 <Штрих-Код>|<Наименование>|<Скидка>|<Дата>|<Блок>|<Адрес>|<Телефон>|<ДатаКлиента>|<Примечание>|<Сумма>

 Где:

Штрих-Код – число, 13 знаков.  штрих-код  дисконтной карты

Наименование – строка, наименование клиента

Скидка – десятичное число, процент скидки

Дата–дата в формате «ДД.ММ.ГГ», до которой карта действительна

Блок- число 0 или 1 запрет на скидку. 0-разрешено,1-запрет на скидку

Адрес – строка, адрес клиента

Телефон – строка, телефон клиента

ДатаКлиента –дата в формате «ДД.ММ.ГГ»,дата рождения клиента или дата создания карты

Примечание – строка, дополнительная информация о клиенте

Сумма – десятичное число, сумма покупок (для накопительных карт)

Информация в этом файле может содержаться только об измененных дисконтных картах, в этом случае «CashFront» обновляет только эти карты.

promo.txt : файл данных о скидках и акциях

Для загрузки данных о скидках и акциях  из внешних программ используется файл promo.txt,. Каждая строка в этом файле означает информацию о конкретной скидке или акции. Сведения  разделены между собой знаком «|» и «*»  Пример фрагмента файла:

L&MGRI-83|2|48208642|False|00:00*24:00*7*14.01.2020*14.01.2020*Qunty*10,00*>*5,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Qunty*50,00*>*10,00*%;

Алексеев|1|9900002507140|False|00:00*24:00*7*14.01.2012*14.01.2020*Summ*100,00*=>*3,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Summ*200,00*=>*4,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Summ*300,00*=>*5,00*%;

L&M Silver Label серый|2|48207812|False|00:00*24:00*7*14.01.2012*14.01.2020*Qunty*10,00*>*5,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Qunty*50,00*>*10,00*%;

Бонус (1111111111111)|0|1111111111111|False|00:00*24:00*7*14.01.2012*14.01.2020*Summ*1000,00*=>*10,00*$;

L&M Blue 83 слим|2|48208659|False|00:00*24:00*7*14.01.2012*14.01.2020*Qunty*10,00*>*5,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Qunty*50,00*>*10,00*%;

L&M Blue Label синий|2|48207805|False|00:00*24:00*7*14.01.2012*14.01.2020*Qunty*10,00*>*5,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Qunty*50,00*>*10,00*%;

Генадий|4|9900000002091|False|00:00*24:00*7*14.01.2012*14.01.2020*Summ*1000,00*>*5,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Summ*2000,00*>*7,00*%;00:00*24:00*7*14.01.2012*14.01.2020*Summ*3000,00*>*10,00*%;

Скидка на чек|3|0|False|00:00*24:00*0*14.01.2012*14.01.2020*Summ*1000,00*>*5,00*%;

Информация в этом файле разделена на два блока: Наименование вид и индентификатор акции, и условия проведения акции. Для формирования этого файла изначально рекомендуется сформировать акцию в программе из встроенного редактора, а затем по образу и подобию формировать файл из бек-офиса. После выгрузки файла акцию можно проконтролировать в меню Сервис > Скидки. Кроме того, возможно автоматическое формирование этого файла если в информацию содержащеюся в  файле Invoice.txt добавить в строку условие скидки по конкретному товару (пример приведен будет ниже).  

Назначение полей:

 <Наименование>|<ТипСкидки>|<ШтрихКод>|<Розрешение>|<БлокУсловия1>; … <БлокУсловияN>;

 Где:

Наименование – строка, наименование скидки или акции

ТипСкидки, число тип скидки 0-

0-Бонус, разовая скидка, после использования становится недоступной

1-Динамическая (меняющиеся в зависимости от суммы или времени), скидка по дисконтной карте

2- Динамическая (меняющиеся в зависимости от суммы, количества или времени), скидка по артикулу (товару)

3-скидка на сумму продажи, возможно только одно значение с идентификатором (ШтрихКод) равным «0»

4-накопительная скидка по дисконтной карте

5-специальная цена на товар, возможно ограничение во времени

ШтрихКод – число, 13 знаков.  штрих-код  скидки или акции

Разрешение – значение «True» или «False», разрешение на проведение скидки

<БлокУсловия1>; … <БлокУсловияN> -блоки условий, может быть произвольное количество, главное чтобы не было противоречий и соответствовало здравому смыслу.

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

В блоке условий синтаксические лексемы разделены символом «*», разделитель между блоками условий «;».

Вот пример блока условия для динамической сидки по дисконтной карте, для удобства чтения блоки размещены с нового абзаца:

00:00*24:00*7*14.01.2012*14.01.2020*Summ*100,00*=>*3,00*%;

00:00*24:00*7*14.01.2012*14.01.2020*Summ*200,00*=>*4,00*%;

00:00*24:00*7*14.01.2012*14.01.2020*Summ*300,00*=>*5,00*%;

В наведенном примере скидка по дисконтной карте меняется в зависимости от суммы покупки, от 100 руб 3%, свыше 100 и до 200- 4%, свыше 300-5%. Первое значение означает время наступления скидки, затем время окончания скидки. Затем день недели, число, 7 означает что для всех дней недели. Потом, аналогично период –число-месяц-год для начала-окончания, значение типа условия «Summ» или «Qunty» для суммы и количества соответственно, и «Price» для специальной цены на товар. После чего указывается логика сравнения условия : «<,>,<,= и.тд», величина скидки, десятичное число и способ предоставления, «%» процентом, или суммой «$». Блок закрывается символом «;».


Каталог « Jornal»: ДД.ММ.ГГГГ.txt,: файлы данных о чеках (операциях)

Для загрузки данных о чеках  из внешних программ используется файл ДД.ММ.ГГГГ.txt: где ДД—дата. число, ММ- месяц, ГГГГ- год. Каждая строка в этом файле означает информацию о чеке. Сведения о чеке разделены между собой знаком «|» Пример фрагмента файла:

--------------------------------------------------------------------------------------------------------------

28.11.2010-11:32:30#9|Sales|Many|1346,61|0,00|0|Кассир №1 |PRINTER

28.11.2010-11:48:13#10|ToCash|Many|100,00|0,00|0|Кассир №1 |PRINTER

28.11.2010-11:48:22#11|InCash|Many|-50,00|0,00|0|Кассир №1 |PRINTER

28.11.2010-11:48:53#12|Over|Many|728,00|0,00|1111111111111|Кассир №1 |PRINTER

28.11.2010-12:29:32#13|Invoice|Many|320,00|16,00|1111111111111|Кассир №1 |PRINTER

28.11.2010-12:30:13#14|Inventory|Many|728,00|21,84|1122222222222|Кассир №1 |PRINTER

28.11.2010-12:30:34#15|Sales|Credit|112,32|5,62|1133333333333|Кассир №1 |PRINTER

--------------------------------------------------------------------------------------------------------------

 Размещение полей:

 <Идентификатор>|<Операция>|<Тип Оплаты>|<Сумма чека>|<Сумма скидки>|<Код дисконта>|<Кассир>|<Регистратор>

 Где:

Идентификатор  – уникальный идентификатор чека, строка (дата-время#номер)

Операция – тип чека, может принимать значения:

«Sales»: продажа товара

«ToCash»: служебный внос в кассу

«InCash»: инкассация (выдача денег из кассы)

«Over»: возврат товара

«Invoice»: приход товара, информация о входящем файле (*.INV) либо введенный вручную приход товара

«Inventory»: инвентаризация, идентификатор проведенной или полученной инвентаризации

 «Z»: Зет-отчет с обнулением

 Тип Оплаты - вид оплаты по чеку:

«Card»: карточка (кредитка)

«Credit»: кредит

«Chek»: по чеку

«Many»: наличные

Сумма чека  – десятичное число, сумма по чеку

Сумма скидки  – десятичное число, сумма скидки по чеку

Код дисконта - число, 13 знаков,  штрих-код дисконтной карты

Кассир – строка, наименование оператора

Регистратор – устройство, на котором напечатан чек, может принимать значения:

«PRINTER»: печать произведена на ESC/POS  принтере

«FISCAL»: печать произведена на фискальном регистраторе


Каталог «Sales»: ДД.ММ.ГГГГ.txt,: файлы данных об проданных товарах

ВНИМАНИЕ! Начиная с версии 3.5.5.0 файл содержит расшифровки проведенных инвентаризаций и приходов (импортов) товара. Идентификаторы этих операций содержатся в соответствующем файле журнала (Каталог «Jornal»).

Для загрузки данных о продажах товаров  из внешних программ используется файл ДД.ММ.ГГГГ.txt: где ДД—дата. число, ММ- месяц, ГГГГ- год. Каждая строка в этом файле означает информацию о продаже или возврате товара. Сведения о товаре разделены между собой знаком «|» Пример фрагмента файла:

------------------------------------------------------------------------------------------------------------------------------------

28.11.2010-11:32:30#9|3373|Авт. выкл. 1р, 02А(шт.)|11,16|1,000|11,16|0,00|PRINTER|3|0,00| 2000020647962

28.11.2010-11:32:30#9|3010|АВВГ 4*150|74,66|1,000|74,66|0,00|PRINTER|3|0,00|48102568546

28.11.2010-12:30:34#15|3009|АВВГ 4*240|112,32|1,000|112,32|5,62|PRINTER|3|5,00|100021541200

-------------------------------------------------------------------------------------------------------------------------------------------

Размещение полей:

<Идентификатор>|<Код>|<Наименование>|<Цена>|<к-во>|<Сумма>|<Скидка>|<Регистратор>|<НГ>|<Макс.скидка>|<штрих-код>

Где:

Идентификатор  – уникальный идентификатор чека, строка (дата-время#номер)

Код – число, 5 знаков,  внутренний код товара

Наименование – строка, наименование товара

Цена – десятичное число, цена товара

К-во - десятичное число, количество товара

Сумма– десятичное число, сумма по товару

Скидка  – десятичное число, сумма скидки по товару

Регистратор – строка, идентификатор регистратора

НГ - число от 0 до 5 , налоговая группа товара

Макс. скидка – десятичное число, ограничение скидки на товар в процентах

Штрих-код- штрих-код товара


  • Файл импорта данных *.INV:

файл данных об артикулах c информацией о количестве товара (накладная) предназначен для загрузки данных об артикулах (товаров) из внешних программ  с информацией о товаре и  количестве  товара.  Файл *.INV аналогичен по структуре с файлами price.txt. Сведения о количестве товара содержатся в двух дополнительных полях в конце строки, предпоследнее значение определяет метод установки количества: 0- добавляет количество к существующему (“ADD”), 1-устанавливает значение количества из файла (“SET”). Последнее значение – количество товара. Программа использует этот файл при включенном режиме контроля остатков. После захвата файла программой он удаляется. Возможна пакетная загрузка нескольких файлов одновременно. Для импорта данных файлы *.INV необходимо поместить в каталог синхронизации данных, в директорию «Invoice», В случае удаленного расположения клиента этот файл помещается в каталог ФТП- сервера, определенного для конкретной кассы. Пример фрагмента файла:

6096|1000000040364|Marlboro RED|шт.|13.00|0.00|PRINTER|1|0|0|0|3   

Файл также поддерживает передачу динамической скидки для артикула (товара) в этом случае к окончанию строки добавляют сокращенную запись скидки :

|#|False|

00:00*24:00*7*16.10.2012*16.10.2013*Qunty*10*<*-10*%;

00:00*24:00*7*16.10.2012*16.10.2013*Qunty*10*=>*-5*%;

Где за символом «» идет сокращенная запись скидки (в данном случае надбавка ), второй признак устанвливает актуальность скидки, затем следует блоки условий (см. описание «promo.txt»). * Для удобства чтения блоки разнесены абзацами, в реальном файле все должно быть одной строкой

 

 

Прочитано 2855 раз

Кратко:

Разработка программного обеспечения для торговли;
Поставка компьютерной техники с установленным ПО;
Системы контроля и учета: весы, сканеры штрих-кода, принтеры чеков и другое торговое оборудование.

Расположение:

58000, Украина, Черновцы
+380 (68) 196 8830
+380 (50) 374 9540
E-mail: office@cashfront.net