Радис-СУПТО 8.4 - Приложение 31, чл.52в-23

Редакция 11.2019 версия 8.4

Радис-СУПТО 8.4 -Приложение 31 - по чл.52в 2 3, буква А

Този документ се различава от предната версия 8.3 по няколко допълненеия и промени.
Новите текстове в сравнение с предната версия са със сини букви.
Промени има в:
- точка 3.1. колони в регистър 1
- точка 3.2. регистър 2 плащания
- точка 3.4. регистър 4 сторнирани
- точка 3.5.1 регистър Фактури (нов)
- точка 4.9. Номера на документи
- точка 4.11. Групи
- точка 4.16. Списък поддържани принтери
- точка 4.20. Поръчани отвън документи
- точка 5.1 Връзки в регистрите

А) пълно описание на обектите в базата данни (БД), свързани с управлението на продажбите, вкл. таблици и предназначението им, връзки между тях, описание на полетата в таблиците:

Съдържание:

глава 1 Общи сведения	Глава 1. Общи сведения 1.1 Състав на данните 1.2. Съпоставка с други среди 1.3. За връзките между полетата 1.4. Износ и внос 1.5. На екрана
глава 2. Опис на таблиците	2.1. Регистри 2.4. Кошница
глава 3. Регистри	3.1. Регистър 1 - продажби 3.2. Плащания 3.3. Регистър 3 - детайли 3.4. Регистър 4 - сторнирани 3.5. Регистър 5 - анулирани 3.5.1 Регистър Фактури 3.6. Регистър ЛОГ 3.7. Регистър Външни поръчки 3.8. Регистър Служебни суми 3.9. Регистър Приключвания 3.10. Таблица PAYMENT_REPORT
глава 4. Номенклатури и други малки таблици	4.1. Стоки 4.2. Клиенти 4.3. Видове операции 4.4. Видове плащане 4.5. Търговски обекти 4.6. Работни места 4.7. Потребители /Оператори/ 4.8. Роли/ 4.9. Броячи/Номера на документи/ 4.10. Мерки 4.11. Групи 4.12. Таблица настройки 4.13. Операторски пълномощия 4.14. Входни ключове / пароли 4.15. Принтер 4.16. Спиъск поддържани принтери / фискални устройства 4.17. Опис на таблиците 4.18. Статус на таблиците 4.19. Статус на потребителите 4.20. Транспортна таблица за поръчани отвън документи 4.20.1. Таблица за искан докуменнт 4.21. Извадки и подреждания
глава 5. Връзки между полетата в таблиците	5.1. Връзки в регистрите 5.2. Връзки в номенклатури и други малки таблици 5.3. Връзки чрез контроли

Глава 1. Общи сведения
Програмата организира три свои поддиректории: REGS, D, REPORTS и записва данни в тях като:
Регистрите са в директория REGS;
Номенклатурите са в текущата директория;
В директория D опционално се записват малки таблици и кошници за наблюдение;
В директория REPORTS се записват временно отчети и справки.
Директория D обикновено е празна, но при включена опция там се записват копия от работните таблици.
Директория REPORTS може да е празна, но се ползва текущо за временни разултати и обработка.

1.1. Състав на данните
Таблиците - на диска или в оперативната памет - са текст. Между колоните няма разделител, нито такъв има между редовете. Съдържанието е безтипово. Програмата го разпознава по името на файла и позицията. Колоните нямат характеристика като "име на поле" или "тип на поле". Те се задават само като ширина - брой символи. Форматният описател може да е отделен файл, или научен по друг начин. Той представлява крайна поредица цели числа - ширини на колоните. СУПТО-програмата пази всички форматни описатели вътре в себе си. Тя записва форматни файлове само при износ на Б4-таблици. В тези случаи форматните файлове са едноименни с табличните - табличните файлове са с разширение BSF, а форматните - с разширение FMT. Индексни файлове няма. В таблиците по постройка няма ключови колони. Няма системен хедър - участък. Вътре в програмата има функции с аналогично предназначение. Обикновено първа колона работи като индекс или код, но това става от програмата, а не е свойство на таблицата. Читателят на този документ има достъп до сорсове, в които личат както действията, така и форматните дефиниции.

1.2. Съпоставка с други среди
Описаната в предната точка организация предполага съответен вид управление. В някои DB-програми може да се ползват специализирани, например SQL-версии за достъп. Други системи като Б4 може да имат свой език за програмиране, с който се уреждат таблични и интерфейсни операции. В тази СУПТО - програма няма нужда от такива абстракции, защото таблиците и действията са определени поначало. Тук е друго - гладкия запис, обяснен по-горе в 1.1. позволява леко и бързо тълкуване по пряк координатен начин.

1.3. За връзките между полетата
От горните две точки се разбира, че освен собствения си код, програмата не ползва отвън указани действия или връзки от едно към друго поле в таблиците. По-долу, в Глава 3-регистри и Глава 4 - номенклатури, в описанието на всяка от колоните е казано откъде идва или за какво служи.Виж таблиците с описание на колоните.

1.4. Износ и внос
Транспорт към други системи е възможен - по инициатива на СУПТО през клипборда и чрез текстов износ. Свободен транспорт от други системи към СУПТО не е позволен. В Глава 4.20. има регламент за поръчан отвън документ чрез уговорена транспортна таблица.

1.5. На екрана
Изображенията на екрана са еднотипни. Без значение къде се намират или за какво служат, таблиците на екрана изглеждат по един и същ начин. Допълнителни сведения понякога се появяват в статус-ивицата или в помощния раздел в долната част на програмния прозорец, а има и справка, в която се вижда коя таблица къде е, как е кодирана и др. - такава точка има в меню "Настройки" - "Статус на таблиците".

Таблиците (ако не са извадки) съдържат в началото си антетка-две или повече линии: първите линии са описателни и поне една разделителна, преди съдържанието. Ето пример:


код_|име

====|===

..._|...

..._|...

Регистровите доклади обикновено съдържат в края епилог-две линии, една за разделител и втора - сборна.
пример:


...__|...

...__|...

=====|===

сбор:|3.2

Когато таблица се изнася навън - като текстов файл, или през клипборда, има опция тези участъци да бъдат изключени от изнесения файл.

Големите таблици - STOKI и KLIENTI, както и регистрите (виж в долната таблица колона 3 "описание"), присъстват явно на диска. Всички останали (тоест малките таблици) се четат и записват наведнъж, в един файл. Могат да бъдат разделени при ръчен износ или включена наблюдателна опция.

Глава 2. Опис на таблиците
Ето как изглежда (взет от меню "Настройки" - "Опис на таблиците"):

път таблица	вид таблица	описание
REPORTS\R18_1.BSF REPORTS\R18_2.BSF REPORTS\R18_3.BSF REPORTS\R18_4.BSF REPORTS\R18_5.BSF REPORTS\F.BSF REPORTS\RN.BSF REPORTS\TURN REPORTS\EXRQ REPORTS\LOG.BSF REPORTS\PAYMENT_REPORT.BSF OPIS OPERATORI OPERACII ROLI TABLICA_NASTROIKI KASI_OPERATORI KLIENTI STOKI NOM_MERKI VIDOVE_PLASHTANIA TARGOVSKI_OBEKTI RABOTNI_MESTA PRINTER_SETTINGS PRINTER_LIST REPORTS\IZVADKA TABLE_STATUS NASTROIKI_OPERATORI OPER_STATE DOKUMENTI_OPIS	Извадка от Извадка от Извадка от Извадка от Извадка от Извадка от Извадка от Извадка от Извадка от Извадка от Справка за период Опис на таблиците Статична Статична Статична Статична Междинна Номенклатура Номенклатура Статична Статична Статична Статична Статична Статична Извадка Междинна Статична Статична Статична	регистър - продажби - издадени боно регистър - плащания регистър - продадени позиции - дета регистър - сторнирани бонове регистър - анулирани бонове регистър - фактури регистър - служебно въведени / изве регистър - приключвания регистър - външни поръчки регистър - събития - суми по вид плащане - тази таблица - Индекси; имена и роли за оператор - Видове действия/операции - Списък роли - Настройки Входни ключове/индекси имена и паро Клиенти Стоки - Мерки - Вид плащане - търговски обекти - работни места - настройка за принтера - видове ФУ и протоколи - временна - временна - операторски пълномощия - статус на операторите - броячи на документи

(В горната таблица не влизат първичните регистри, те са описани по-долу. Влизат техни извадки, за по-удобна работа. Извадките винаги носят формат от първичноте регистри, но имат различен брой линии заради периодиката. Освен това имат надписи и епилози за по-лесно тълкуване. Колоната "Редакция" в горната таблица е за служебно разпознаване.

Таблиците са:
2.1. Регистри - В регистрите се записват събития - издадени документи, лог-статистика и външни поръчки.
2.2. Номенклатури - Това са статични съдържания, повечето са описани в Н-18;
2.3. Статични - повечето са описани в Н-18, те са за свързаното ФУ и други стартови стойности
(Във втората колона от горната таблица "Междинна" е същото като "Статична")
Справката "Суми по вид плащане" не е класирана, тя се изработва като бърз доклад за оперативна работа. Спада към малките таблици.
Предназначението на таблиците, описани като справки в наредбата не се коментира, освен допълнителните колони и съдържания. Това е казано за всяко поле по-долу. Останалите таблици са записани с предназначение и коментари.

2.4. Кошница
Кошницата е видимата на екрана решетка, в която оператора добавя продаваните позиции. Тя не се записва на диска явно, нито присъства като таблица в паметта. Но се строи от трите основни регистъра 1,2,3 (от по-долу) - техни участъци се подговят и присъстват като таблици в паметта при подготовката на кошницата, а при запис се добавят към регистрите. В кошницата има 7 колони: код, стока, количество, цена, стойност, отстъпка, баркод. На екрана изглежда според илюстрациите - виж Глава 2. Стандартно въвеждане от ръководството.

Глава 3. Регистри:
Тук са описани първичните регистри, които се намират в директория REGS.
Те имат фиксирани периоди - месечни или годишни.
Регистрите носят имена R18_X_GGMM, гъдето X е индекс 1..5 съгласно прил.29 по т.18.1..18.5 1..5, GG-година, MM-месец.
Всеки регистър се отнася за определен период от време. Програмата съставя нов комплект регистри 1..5 + служенбни суми + лог - за всеки месец. Регистър приключвания и регистър Външни поръчки са годишни - програмата отваря нови всяка година.

Регистри 2,4,5 имат точно съответствие с исканите в Наредбата формати;
В регистър 1 и регистър 3 - е добавена отдясно колона за нотация (за приложни цели), 10 символа, описана по-долу.
Лог регистър - името му е LOG_GGMM; този регистър има колони:
- дата, час, код на оператор, име на оператор, код на операция, к6, к7
колона 6 е празна, а в колона 7 се записва име на операцията, но
при модификация в колона 6 и 7 се записват линия номер и име на таблицата;
при сторно, анулиране, прекъсване и продължение, в тези колони се записва вид на събитието и унп на докумнента;
Регистър външни поръчки е изискан, но неописан от НАП - името му е EXRQ_GG; описан е по-долу.

Програмата води още два регистъра неописани в прил.29.
Регистър служебни суми (RN_GGMM) този регистър има колони:
- номер на ФУ, номер на бон, код оператор, сума лв, код на клиент, име на клиент, дата, час, нотация.
Регистър приключвания (TURN_GG) - този регистър има колони:
- дата, час, код оператор, налична сума лв;
В него се очаква една линия за работен ден. Той се води цял за годината, без да се дели на месеци.

Ето и подробно за всеки регистър:
3.1. Регистър 1 - продажби (твърде широк за една страница, затова е на лява и дясна част)
лява част:

---
1
2
3
4
5

1
---------------------
УНП
=====================
DT278290-0276-0000362
DT278290-0354-0000363
DT278290-0276-0000372

2
----------
н.продажба
==========
0000429
0000430
0000441

3
---------------
то.к име
===============
0101 магазин 1
0101 магазин 1
0101 магазин 1

4
----------
дата1
==========
01.04.2019
01.04.2019
07.04.2019

5
--------
час1
========
15:59:06
15:59:19
15:43:42

6
----
рм
====
0001
0001
0001

7
-----
оп.
=====
0001
0003
0001

8
------
сделка
======
0.25
0.1
0.0833

9
-----
отстъ
=====
0
0
0

10
-----
ддс
=====
0.05
0.02
0.016

дясна част:

---
1
2
3
4
5

11
--------
дължима
========
0.3
0.12
0.1

12
------------
ф.номер
============

Ф.?000013269

13
----------
ф.дата
==========

07.04.2019

14
----------
дата2
==========
01.04.2019
01.04.2019
07.04.2019

15
--------
час2
========
15:59:07
15:59:21
15:43:44

16
------
кл.код
======

15234

17
---------------------------
клиент идентификатор
===========================

УСТРЕМ 97 ООД

18
----------
кл.част/м
==========

0000_2000

Колони в регистър 1:
- УНП - серийния номер на ФУ се чете от таблица "Работни места", колона 3; Този номер се уточнява още при свързването с ФУ; Кодът на оператор е вътрешният код - колона 1 от номенклатура "оператори" - виж по-долу; последните седем цифри се прочитат от таблица "Броячи на документи". Преди и след бона този брояч се сверява със записания УНП от ФУ. Виж ръководството - Глава 6.1.3 УНП;
- н.продажба - това е индивидуалния номер на бележка, ФУ го връща по запитване за последен номер, след отпечатването на бона;
Когато е записана фактура с банково плащане, бон не се издава и този номер има вид "S00000031" - супто-номер. Неговия брояч присъства в таблица номера на документи, описана по-долу в точка 4.9.
- то. к име - Кодът на търговския обект се взема от текущото работно място в таблица "Настройки"; Името на търговския обект идва от таблицата "Търговски обекти" (виж по-долу);
- дата1, час1 - четат се от ФУ в началото на отпечатване на бона;
- рм - това е работното място в "таблица настройки" (виж по-долу):
- оп.- това е принтерски код на оператора - таблица оператори, колона 3;
- сделка - сбор на бона без ддс;
= отстъпка - има две версии: или p12 - което значи 12 процента; или a2 - което значи 2 лв отстъпка; отстъпката се приспада от крайната сума, след това се смятат сделка и ддс;
- ддс - сбор на ддс по бона;
- дължима - това е сделка плюс ддс;
- ф.номер, ф.дата - тук се записва издадената заедно с бона фактура; Пример: ф.0000000242 / 02.03.2019
Ако фактурата е отпечатана като разширен клиентски бон от фискалното устройство, нейния номер се записва без префикс "ф.", само като 10-цифрено число.
Пример: 0000000712 / 02.03.2019
Ако фактурата е издадена след бона, колоните ф.номер, ф.дата, кл. код и клиент идентификатор остават празни.
Когато се изработва справка 1 - продажби, тези полета се извличат от регистър "Фактури (виж по-долу)
- дата2, час2 - край на бона според ФУ;
Когато продажбата е с банково плащане, тези две полета - дата2 и час2 - остават празни.
- кл.код, клиент идентификатор - тези се попълват, когато преди бона е посочен клиент; в противен случай справката ги заема от регистър Фактури.
Задължително ги има в колони 1 и 2 от номенклатура КЛИЕНТИ (виж по-долу).
- кл.част/м - нотация, за тази колона виж отклонението по-долу;
Чек сума се очаква по колоните ддс и дължима.
[отклонение]
В регистри 1 и 3 има добавена отдясно колона 10 символа - нотация или
- кл.част/м, служи за индикация на маса/поръчка, данъчна_група и времено за сторно флаг.
Тя най- често е празна, но може да носи четири различни съдържания за специални случаи:
- 1..4. маса - ако работим с кафе или заведение - по желание на оператора (4 символа), или поръчка в случай на необходимост;
- 5. разделител - един символ "_";
- 6. данъчна група - 1 символ (0,1,2,..8) - за временна настройка, различна от основната;
според протоколите на ФУ данъчната група може да варира за всеки ред от продажбата, затова в регистър 3
е предвидена колона за конкретната позиция. Обаче програмата предполага
една и съща група за бона като цяло, без да има възможност
за вариращи групи в позициите. Затова данъчната група да се записва и в регистър 1.
- 7..9. допълнение (3 символа, може да е резерва за по-късно ползване);
- 10. сторно флаг * ползва се временно при обръщението между работни и записани данни.
Напримере: "0022_4000" означава поръчка 22, данъчна група "Г"
[/край на отклонението]

3.2. Регистър 2 - плащания

ф.номер	ф.дата	продажба.н	унп	сума	пл.	кл.	клиент	към ф-ра	какъв док.
ф.0000000104 к.0000000105 ф.0000000106 к.0000000107 ф.0000000108 к.0000000109 ф.0000000110 ф.0000000110	01.12.2019 01.12.2019 01.12.2019 01.12.2019 01.12.2019 01.12.2019 01.12.2019 01.12.2019	0000372 0000372 0000372 0000372 S0000107 S0000107 0000374 0000374	ZK144783-0104-0000178 ZK144783-0104-0000178 ZK144783-0104-0000178 ZK144783-0104-0000178 ZK144783-0104-0000182 ZK144783-0104-0000182 ZK144783-0104-0000184 ZK144783-0104-0000184	0.5200 -0.5200 0.5200 -0.5200 0.3200 -0.3200 4 9.12	P P P P N N D P	5 5 7 7 4 4 6 6	МОРСКО ОБОРУДВАНЕ АД МОРСКО ОБОРУДВАНЕ АД МАНДРА ПЕТРОХАН МАНДРА ПЕТРОХАН КЕНТЪКИ ЕООД КЕНТЪКИ ЕООД ШИП СЪРВИЗ LTD ШИП СЪРВИЗ LTD	ф.0000000104 ф.0000000106 ф.0000000108	4 ф. стар бон 14 кр.изв. стар бон 4 ф. стар бон 14 кр.изв. стар бон 3 ф. банка 13 кр.изв. банка 2 ф. бкс 2 ф. бкс

поз.	файл	тип	шифр.	вътр.фо	RSHA	V-disk
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29	KASI_OPERATORI.BSF OPIS.BSF ROLI.BSF OPERATORI.BSF VIDOVE_PLASHTANIA.BSF TARGOVSKI_OBEKTI.BSF TABLICA_NASTROIKI.BSF RABOTNI_MESTA.BSF OPER_STATE.BSF KLIENTI.BSF STOKI.BSF NOM_MERKI.BSF DOKUMENTI_OPIS.BSF NOM_GRUPI.BSF PRINTER_SETTINGS.BSF PRINTER_LIST.BSF OPERACII.BSF NASTROIKI_OPERATORI.BSF TABLE_STATUS.BSF REGS\R18_1_ REGS\R18_2_ REGS\R18_3_ REGS\R18_4_ REGS\R18_5_ REGS\RN_ REGS\LOG_ REGS\TURN_ REGS\EXRQ_ REGS\RF_	0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0	1 1 1 1 1 1 1 1 1 1 1 1	1 1 1 1 1 1 1 1 1 1 1 1	1 1 1 1 1 1 1 1 1 1 1 1	1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1

	ДОК ДАТА КЛИЕНТ НДР ЕИК ЕГН ГРАД АДРЕС МОЛ ПОЛУЧ ПЛАЩА СБОР ЗАПИСИ СЪКРАТ ОПЕР КОМПОРТ РАБ.М надп. подп.	МОРСКО ОБОРУДВАНЕ АД BG102108881 102108881 102108881 АЙТОС УЛ. ЗЕЛЕН КАМЪК 4 ПЕТЪР ПОПОВ ПЕТЪР ПОПОВ КРЕДИТ 6.12 2 4 110 COM5 0003
1 2		ДЪРВЕН МАТЕРИАЛ ТОРТА БУКЕТ	0.2 1	24.00 1.32	0000_2000 0000_2000	3333333333333 7777777777777	p0 a0

кол.	наименование	от къде идва	за какво служи
1	УНП	от колона 2 на таблица Броячи на документи.	Пренася се в регистри 2, 3, 4, 5, външни поръчки. УНП се споменава и в ЛОГ-регистъра и справките.
2	номер продажба	ФУ връща този номер при запитване, след отпечатването на бона; Когато е записана продажба с банково плащане този номер има вид "S00000031" - супто-номер. Броячът е в колона 3 на таблица Броячи на документи	този номер се записва успоредно с УНП в регистрите 2,3,4,5 и в справките.
3	търговски обект код и име	от таблица търговски обекти линията в тази таблица е наме рена от текущото работно място	задължително поле по прил.29 към наредбата.
4,5	дата1, час1	тези двете идват като отговор на запистване към ФУ преди. и след отпечатването на бона. ако няма бон, идват от PC.	записват се в регистри 1..5, външни поръчки и в справките.
6	код на работно място	от таблица настройки. този код присъства в таблицата работни места	записва се в регистрите от него се извлича търговския обект и фискалното устройство
7	код на оператора	от таблицата настройки този код сочи линия в таблица оператори	този код е част от УНП. по него се извличат принтерскитв идентификатори и пароли, също служи за извличане на справки.
8	сделка	сбор от цена * количество на всички продавани позиции преди отстъпката	от този сбор се приспада отстъпката и се получава данъчната основа.
9	отстъпка	въвежда се ръчно за всяка продавана позиция. може да идва от външна поръчка	преважда се от сделката за да бъде получена данъчната основа
10	ддс	начислява се върху данъчната основа	записва се в регистрите 1..5, както и в справките
11	дължима сума	сбор данъчна основа + ддс	записва се в регистрите 1,2 и в справките
12	фактура номер	от фактурния брояч, в колона 3 на таблицата броячи на документи	ползва се при справки
13	фактура дата	от PC	ползва се при справки
14,15	дата2, час2	ФУ ги връща след отпечатване на бона. Ако няма бон са празни.	изисквани от прил.29
16	клиент код	колона 1 на номенклатура клиенти	за извличане на клиентските стойности
17	клиент име	колона 2 на номенклатура клиенти	участва в клиентски бонове, фактури и справки
18	нотация	въвежда се ръчно или идва от външна поръчка	означава маса, поръчка и поискана отвън данъчна група