Read Me

OLE-сервер для фискального регистратора Datecs FP3530T с версией прошивки 5.2. 

Установка:
~~~~~~~~~~
Для работы библиотеки необходимо:
1. скопировать файл fpl.dll, поставляемый с регистратором, в тот же каталог, где находится DVV_FP3530T.dll
2. установить .NET Framework 2.0
   http://www.microsoft.com/ru-ru/download/details.aspx?id=1639
3. установить  Распространяемый пакет Microsoft Visual C++ 2008 пакет обновления 1 (SP1) (x86)
   http://www.microsoft.com/ru-ru/download/details.aspx?id=5582
4. Зарегистрировать библиотеку
   "%WINDIR%\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe" /codebase DVV_FP3530T.dll

Описание функций (возвращаемые функциями коды см. в разделе "Коды возврата"):
~~~~~~~~~~~~~~~~~

OpenPort(port, baud)
	описание: подключает библиотеку у COM-порту
	port (тип - целое число): номер порта (1, 2, ...)
	baud (тип - целое число): скорость (9600, 19200, ...)
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
ClosePort()
	описание: отключает библиотеку от COM-порта
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
GetArticle(art)
	описание: получает информацию о запрограммированном артикуле
	art (тип - целое число): порядковый номер артикула (1, 2, ...)
	возвращаемое значение: 
		0 - артикул запрограммирован 
		102 - артикул не запрограммирован
		другое значение - код возврата

SetArticle(art, nalg, price, pass, name)
	описание: программирование артикула
	art (тип - целое число): порядковый номер артикула (1, 2, ...)
	nalg (тип - строка): налоговая группа ("А", "Б", "В", "Г", "Д")
	price (тип - вещественное число): цена товара
	pass (тип - строка): пароль оператора
	name (тип -строка): наименование товара, одна или две строки, разделенные символом табуляции (09H), каждая длиной до 24 символов
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
OpenFiscalCheck(oper, pass)	
	описание: открытие фискального чека	
	oper (тип - целое число): номер оператора
	pass (тип - строка): пароль оператора
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
OpenFiscalRetCheck(oper, pass)	
	описание: открытие фискального чека	возврата
	oper (тип - целое число): номер оператора
	pass (тип - строка): пароль оператора
	возвращаемое значение: 0 - успех, другое значение - код возврата

Sale(art, quant)
	описание: продажа товара
	art (тип - целое число): порядковый номер артикула (1, 2, ...)
	quant (тип - вещественное число): количество товара
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
SubTotal()
	описание: печать подсуммы по чеку
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
SubTotalSum()
	описание: возвращает подсумму после выполнения функции SubTotal
	возвращаемое значение (тип - строка): значение подсуммы
	
Total(comment, paymentType, sum)
	описание: оплата	
	comment (тип - строка): комментарий, строка до 25 символов
	paymentType (тип - строка): тип оплаты ("P" - оплата наличными, "N" - оплата в кредит, "C" - оплата чеком, "D" - оплата платежной картой)
	sum (тип - вещественное число): сумма оплаты
	возвращаемое значение: 
		204 - сумма оплаты больше суммы чека (успех)
		202 - вычисленная сумма отрицательна. Оплата не совершается
		203 - сумма оплаты меньше суммы чека 
		205 - сумма по некоторой налоговой группе отрицательна
		другое значение - код возврата 

CloseFiscalCheck()
	описание: закрытие чека или чека возврата
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
Report(pass, z)
	описание: печать дневного отчета
	pass (тип - строка): пароль оператора
	z (тип - целое число): 0 - печать X-отчета, 1 - печать Z-отчета
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
ServiceInputOutput(sum)
	описание: служебный внос/вынос денег
	sum (тип - вещественное число): положительное число - внесение, отрицательная сумма - вынос
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
GetSendStr()
	описание: возвращает последнюю команду, отправленную в регистратор
	возвращаемое значение (тип - строка):  строка, которая была послана непосредственно в фискальный регистратор

ReportByDate(pass, date1, date2)
	описание: печать сокращенного периодического отчета
	pass (тип - строка): пароль оператора
	date1 (тип - строка): дата начала интервала в формате DDMMYY
	date2 (тип - строка): дата конца интервала в формате DDMMYY
	возвращаемое значение: 0 - успех, другое значение - код возврата
	
Коды возврата:
~~~~~~~~~~~~~~
0 - успех
-1 - библиотека fpl.dll определила ошибку в передаваемых функции параметрах 
101 - ошибка при программировании артикула
102	- ошибка при чтении информации об артикуле
201 - функция Total: ошибка	
202 - функция Total: вычисленная сумма отрицательна. Оплата не совершается	
203 - функция Total: сумма оплаты меньше суммы чека 	
204 - функция Total: сумма оплаты больше суммы чека 	
205 - функция Total: сумма по некоторой налоговой группе отрицательна 
301 - Синтаксическая ошибка     
302 - Неверная команда      
303 - Дата и время неверны     
304 - Ошибка печати      
305 - Арифметическое переполнение     
306 - Команда не разрешена  
307 - Обнуление ОЗУ      
309 - Разрушение информации в ОЗУ   
310 - Нет бумаги       
311 - Открыт фискальный чек      
312 - Открыт нефискальный чек   
313 - Открыт служебный чек     
314 - Не обнаружен модуль фиск. памяти        
316 - Ошибка записи в фиск. память   
317 - Фиск. память переполнена          
318 - Запись в фиск. память запрещена     
319 - Ошибка последнего Z-отчета   
320 - Ошибка протокола  
321 - Принят NACK   
322 - Таймаут (нет ответа от регистратора)      
323 - Общая ошибка