Описание на програмния интерфейс към фискални принтери datecs fp1000-02 и datecs fp300-02

Принтерски команди

2DH (45) Отрязване на хартията.

21H (33) Изчистване на дисплея.

23H (35) Показване на текст (долен ред).

2FH (47) Показване на текст (горен ред).

3FH (63) Показване на датата и часа.

64H (100) Дисплей - пълен контрол.

26H (38) Отваряне на служебен бон.

27H (39) Затваряне на служебен бон.

2AH (42) Печатане на свободен текст в служебен бон.

46H (70) Служебно въвеждане и извеждане на пари.

47H (71) Печат на диагностична информация.

50H (80) Издаване на звуков сигнал.

59H (89) Програмиране на производствената тестова област.

6AH (106) Отваряне на чекмедже.

Подробно описание на командите
Забележка: Всички примери предполагат работа с фискален принтер, конфигуриран за България. Там, където има особености в зависимост от държавата, е направено уточнение.
21h (33) ИЗЧИСТВАНЕ НА ДИСПЛЕЯ

Област за данни: Няма данни

Отговор: Няма данни

Изпраща се команда за изчистване на дисплея. Ако е отворен фискален бон и Sw3 e OFF, изчиства се само долния ред.

• 
  Отпечатва се HEADER.
  
• 
  Отпечатва се БУЛСТАТ на продавача.
  
• 
  Връща се отговор, съдържащ Allreceipt.
  

• 
  Фискалната памет не е форматирана.
  
• 
  Има отворен фискален бон.
  
• 
  Вече е отворен служебен бон.
  
• 
  Часовникът не е сверен.
  

ФП извършва следните действия:

• 
  Отпечатва се FOOTER.
  
• 
  Отпечатва се поредния номер, датата и часа на документа
  
• 
  Отпечатва се с широк печат “СЛУЖЕБЕН БОН”.
  

• 
  Връща се отговор, съдържащ Allreceipt.
  

Ако е вдигнат S1.1 командата не е изпълнена защото в момента не е отворен служебен бон.

Принтерът няма хардуерни ключета и използува за целта област във флаш-паметта. Установяването им става с тази команда. Освен това командата записва във флаш-паметта и графичното лого, височината на баркода, плътността на печат и дължината на импулса за отваряне на чекмедже. След RAM ресет стойностите им се възстановяват от тези във флаша.

Ако командата няма данни, то се запазват старите стойности на “ключетата” и се записват останалите данни.

ВНИМАНИЕ! Ключетата се броят отдясно наляво!

Ключе	Функция
Sw1	Автоматично отрязване на хартията
Sw2	Поведение при разширен клиентски бон (фактура)
Sw3	Режим прозрачен дисплей
Sw4	Работа с дисплей с 1251 кодова таблица
Sw5	Работа с DOS-овска кирилица (съвместимост с FP-550)
Sw6	Скорост на серийния порт
Sw7	Скорост на серийния порт
Sw8	Скорост на серийния порт

Sw6	Sw7	Sw8	Скорост
0	0	0	1200 bps
0	0	1	2400 bps
0	1	0	4800 bps
0	1	1	9600 bps
1	0	0	19200 bps
1	0	1	38400 bps
1	1	0	57600 bps
1	1	1	115200 bps

Ако е вдигнат S1.1, значи в момента не е отворен служебен бон и текста не е отпечатан.

Тази команда трябва да се изпълни до 8 пъти, за да се зададат всичките линии на HEADER и FOOTER.

‘0’ до ‘7’ е номера на линията, която се задава. Линиите на HEADER са с номера от 0 до 5, а тези на FOOTER – 6 и 7.

‘А’ Автоматично форматиране на продажбите като за фактура (4 отделни реда).

’B’ Задава височината на баркода в пиксели (0.125 mm). Възможни стойности от 24 (3 mm) до 240 (30 mm). Баркодът се печати с команда 84 (54H).

‘C’ Разрешаване / забраняване на автоматичното отрязване на хартията след всеки документ. След включване на принтера поведението на принтера се определя от ключе Sw1.

’D’ Задава плътност на печат. Възможни стойности:

‘1’: Много блед

‘2’: Блед

‘3’: Нормален

‘4’: Плътен

‘5’: Много плътен

‘E’ Разрешаване / забраняване на печата на общата сума в EUR при първата команда за плащане (53) във фискален бон. По подразбиране печатът е забранен. Опционално командата задава и валидния курс EUR / ЛВ. Синтаксис на данните:

‘L’ Разрешаване / забраняване печата на графичното лого непосредствено преди HEADER-а. Логото се дефинира с команда 115. Данните Text са във формат <H>,<Enable>. H е височината на логото в пиксели, а Enable е един байт със стойност ‘1’ (разрешено) или ‘0’ (забранено).

‘N’ Разрешаване / забраняване на отпечатването на името на департамента в началото на всеки фискален бон.

‘T’ Разрешаване / забраняване на отпечатването на натрупания ДДС за бона в нормален (не разширен) фискален бон.

‘X’ Разрешаване / забраняване на автоматичното генерирането на импулс за отваряне на чекмедже при команди 53 (35H) и 70 (46H).

‘I’ Дава възможност да прочетем стойностите, зададени по-рано с команда 43. След буквата ‘I’ следва точно още един символ, съвпадащ с някой от по-горните.

Ако <Item> е цифра от ‘0’ до ‘7’ – текста от който се състои съответната линия.

Ако <Item> = ‘А’ – един символ ‘0’ или ‘1’, като ‘0’ забранява, а ‘1’ разрешава форматирането тип “фактура”. Ако е разрешено, тогава за всяка продажба се отпечатват по 4 реда – за име, единична цена, количество и цена с данъчна група.

Ако <Item> = ‘B’ – Число, задаващо височината в на баркода пиксели.

Ако <Item> = ‘C’ – един символ ‘0’ или ‘1’, като ‘0’ забранява, а ‘1’ разрешава автоматичното отрязване на бона.

Ако <Item> = ‘D’ – Плътността на печат (от 1 до 5).

Ако <Item> = ‘E’ – Връща се Enable,Rate, където Enable е флагът забранено / разрешено, а Rate е текущият програмиран обменен курс.

Ако <Item> = ‘L’ – Връща се H,Enable, където H е височината на графичното лого, а Enable е флагът забранено / разрешено.

Ако <Item> = ‘N’ – един символ ‘0’ или ‘1’, като ‘0’ забранява, а ‘1’ разрешава отпечатването на името на департамента в началото на всеки фискален бон.

Ако <Item> = ‘Т’ – един символ ‘0’ или ‘1’, като ‘0’ забранява, а ‘1’ разрешава отпечатването на натрупания ДДС в нормален (не разширен) фискален бон.

Ако <Item> = ‘X’ – един символ ‘0’ или ‘1’, като ‘1’ забранява, а ‘0’ разрешава автоматичното отваряне на чекмедже при команди 53 (35H) и 70 (46H).
2Ch (44) Придвижване на хартията.

Област за данни: [Lines]

Отговор: Няма данни

Lines Броят на редовете, с които да бъде придвижена хартията. Трябва да бъде положително число не по-голямо от 99 /1 или 2 байта/. Ако параметър липсва, подразбира се 1 ред.
2Dh (45) ОТРЯЗВАНЕ на хартията.

Област за данни: Няма данни

Отговор: Няма данни

Предизвиква отрязването на хартията. Трябва да се има предвид, че програмата трябва да се погрижи за придвижването на хартията поне с два реда, иначе е възможно отрязване на края на бона. Ако принтерът е в режим “автоматично рязане”, той сам позиционира коректно хартията преди рязането, а командата е излишна.

При блокиране на режещия механизъм трябва да се извади хартията (ако има такава) от резачката, и да се изключи и включи принтера – разачката ще се позиционира в изходно положение.
2F (47) ПОКАЗВАНЕ НА ТЕКСТ НА ГОРНИЯ РЕД НА ДИСПЛЕЯ

Област за данни: Text

Отговор: Няма данни

Text Текст до 20 символа, който се изпраща директно към дисплея. Преди него се изпраща команда за позициониране и изчистване на горния ред. Командата се отхвърля, ако е отворен фискален бон и Sw3 е OFF.
30h (48) Отваряне на фискален (КЛИЕНТСКИ) бон

Област за данни: <OpCode>,<OpPwd>,[,Invoice]

Отговор: Allreceipt, FiscReceipt

OpCode Номер на оператор /1 до 16/

OpPwd Операторска парола /4 до 6 цифри/

TillNmb Номер на касово място /цяло число от 1 до 99999/

Invoice Един символ със стойност “I”. Наличието му предизвиква отпечатването на разширена клиентска бележка (фактура). Автоматично след HEADER-а се отпечатва номера на фактурата, а след първата команда за плащане разпечатка на сумите по данъчни групи. След плащането трябва да се отпечата информация за купувача с команда 57 (39h).

Allreceipt Броят на всички издадени бонове (фискални и служебни) от последното приключване на деня до момента. /4 байта/

FiscReceipt Броят на всички издадени фискални бонове от последното приключване на деня до момента. /4 байта/

ФП извършва следните действия:

• 
  Отпечатва се HEADER.
  
• 
  Отпечатва се БУЛСТАТ.
  
• 
  Отпечатва се номер и име на оператор и номер на касово място.
  
• 
  Връщат се AllReceipt и FiscReceipt.
  

• 
  Има отворен фискален или служебен бон.
  
• 
  Фискалната памет е пълна.
  
• 
  Фискалната памет е повредена.
  
• 
  Липсва код или парола на оператор, или номер на касово място.
  
• 
  HEADER съдържа по-малко от 2 реда.
  
• 
  Не е зададен БУЛСТАТ.
  
• 
  Не е вярна операторската парола.
  
• 
  Часовникът не е сверен.
  
• 
  Електронната контролна лента е пълна.
  

При три грешни операторски пароли принтерът блокира и трябва да се изключи и включи за продължаване на работата.

или

ФП извършва следните действия:

• 
  Ако продажбата е по департамент и е разрешено с команда 43, подкоманда ‘N’, отпечатва се името на департамента.
  

• 
  Текстът описващ продажбата се отпечатва заедно с цената и кода на данъчната група. Ако има зададено количество, информацията за него също се отпечатва.
  
• 
  Цената на стоката се прибавя към натрупаните суми в регистрите в оперативната памет. В случай на препълване се установяват съответните битове от статус полето.
  
• 
  Ако има отстъпка или надбавка, тя се отпечатва на отделен ред и се добавя в предвидени за това регистри на принтера. Стойностите за целия ден се отпечатват при дневния финансов отчет.
  
• 
  Ако е указан департамент, натрупаната стойност се прибавя към него. Надбавките и отстъпките, ако има такива, се отчитат.
  

Командата няма да бъде изпълнена успешно, ако:

• 
  Не е отворен фискален бон.
  
• 
  Вече са направени максималния брой продажби за един бон (380).
  
• 
  Командата (35h) е изпълнена успешно.
  

• 
  Сумата по някоя от данъчните групи става отрицателна.
  
• 
  Сумата от надбавки или отстъпки в рамките на бона става отрицателна.
  
• 
  Електронната контролна лента е пълна.
  

Запетаята е задължителна, когато се задават Start и End. В случай, че областта за данни е празна, само се връща информация за последните зададени ставки.

Изчислява се сума на всички продажби регистрирани във фискалния бон до момента. По желание сумата може да бъде отпечатана и/или показана на дисплея. Към PC се връща изчислената сума и натрупаните до момента суми за всяка данъчна група. Ако е посочена надбавка или отстъпка, тя се отпечатва на отделен ред и натрупаните суми по данъчни групи се коригират съответно.

или

Tab Един байт със съдържание 09h

TaxCd Един байт, съдържащ буквата, показваща вида на данъка (‘А’, ‘Б’, ‘В’, ...). Има ограничение, зависещо от параметъра Enabled_taxes, който се установява при задаването на валутата в команда 83.

Dept Номер на департамент. Цяло число от 1 до 60 включително. Продажбата се причислява към данъчната група, с която е асоцииран департаментът при програмирането му.

Sign Един байт със стойност ‘-‘.

Price Това е цената и е до 8 значещи цифри.

Qwan Незадължителен параметър, задаващ количеството на стоката. По подразбиране е 1.000. Дължина до 8 значещи цифри.

Perc Това е незадължителен параметър, показващ стойността на надбавката или отстъпката (в зависимост от знака) в проценти върху текущата продажба. Допустими стойности са от -99.00 % до 99.00 %.

Abs Това е незадължителен параметър, показващ стойността на надбавката или отстъпката (в зависимост от знака) като сума. Не е допустима отстъпка със стойност по-голяма от стойността на продажбата.
Допустим е само един от аргументите Perc или Abs.

ФП ще извърши следните действия:

• 
  Ако продажбата е по департамент и е разрешено с команда 43, подкоманда ‘N’, отпечатва се името на департамента.
  

• 
  Текстът, описващ продажбата, се отпечатва заедно с цената и кода на данъчната група.
  
• 
  Цената на стоката се прибавя към натрупаните суми в регистрите в оперативната памет. В случай на препълване се установяват съответните битове от статус байтовете.
  
• 
  Ако има отстъпка или надбавка, тя се отпечатва на отделен ред и се добавя в предвидени за това регистри на принтера. Стойностите за целия ден се отпечатват при дневния финансов отчет.
  
• 
  Цената на стоката са показва на горния, а описанието и на долния ред на дисплея.
  

• 
  Ако е указан департамент, натрупаната стойност се прибавя към него. Надбавките и отстъпките, ако има такива, се отчитат.
  

• 
  Не е отворен фискален бон.
  
• 
  Вече са направени максималния брой продажби за един бон.
  
• 
  Командата “Total” е изпълнена успешно.
  
• 
  Сумата по някоя от данъчните групи става отрицателна.
  
• 
  Сумата от надбавки или отстъпки в рамките на бона става отрицателна.
  
• 
  Електронната контролна лента е пълна.
  

‘P’ - Плащане в брой (по подразбиране);

‘N’ - Плащане с кредит;

‘C’ - Плащане с чек;

‘D’ - Плащане с дебитна карта

‘I’ - Програмируем тип плащане 1

‘J’ - Програмируем тип плащане 2

‘K’ - Програмируем тип плащане 3

‘L’ - Програмируем тип плащане 4

В зависимост от кода сумите се натрупват в различни регистри и могат да бъдат получени в дневния отчет.

‘F’ Грешка.

‘E’ Изчислената под сума е отрицателна. Плащане не се извършва и Amount ще съдържа отрицателната под сума.

‘D’ Ако платената сума е по-малка от сумата на бона. Остатъкът за доплащане се връща в Amount.

‘R’ Ако платената сума е по-голяма от сбора на бележката. Ще се отпечата съобщение “РЕСТО” и рестото се връща в Amount.

‘I’ Сумата по някоя данъчна група е бил отрицателен и затова се е получила грешка. В Amount се връща текущата под сума.

Тази команда предизвиква изчисляването на сумите от фискалния бон, отпечатването на сумата със специален шрифт и показването й на дисплей. Възможно е отпечатването на допълнителен текст. При успешно изпълнение на командата се генерира импулс за отваряне на чекмедже, ако това е разрешено с подкоманда ‘X’ на команда 43. Ако след символа <Tab> няма повече данни, то принтерът автоматично плаща цялата налична сума в брой.

Командата няма да бъде изпълнена успешно, ако:

• 
  Не е отворен фискален бон.
  
• 
  Натрупаната сума е отрицателна.
  
• 
  Ако някоя от натрупаните суми по данъчни групи е отрицателна.
  

Необходимо е да е отворен фискален бон. В противен случай не се отпечатва текста и се вдига S1.1. Ако текстът е по-дълг от 36 символа, то буквите след 36-та се изрязват.

Натрупаните суми от фискалния бон се прибавят към дневните суми в регистрите на оперативната памет.

Командата няма да бъде изпълнена успешно, ако:

• 
  Не е отворен фискален бон.
  
• 
  Команда 53 (35h) не е изпълнена успешно.
  
• 
  Платената сума по команда 53 е по-малка от общата сума на фискалния бон.