Summa Sistemas C.A.

Dynamic Link Library PrnFiscalDLL32 Manual of Reference

Version 8.2 2016

Dynamic Link Library PrnFiscalDLL32

Summa Fiscal Printers
7197-F, 7167-F and A-721-F
Manual of Reference
Version 8.2 2016

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

INDEX
INTRODUCTION 4

GENERAL DESCRIPTION 5

CONVENTIONS USED IN THIS MANUAL OF REFERENCE 6

LIST OF FUNCTIONS OF THE FISCAL PRINTER BY ALPHABETICAL ORDER 9

LIST OF FUNCTIONS OF THE FISCAL PRINTER BY CATEGORY 10

FUNCTIONS DESCRIPTION 12
CANCELTRANSACTION 12
CLOSEDOC 13
CLOSEPORT 15
CONFIGIVA 16
CONFIGPAY 17
DELETELOG 18
DISABLEDLOG 19
ENABLEDLOG 20
GENRPTZ 21
NEWDOC 22
NEWITEM 24
OPENBOX 25
OPENPORT 26
OPRDOC 27
PRINTDOCUMENT 28
PRINTTEXTNOFISCAL 30
PRNCHEQUEF 32
QRYJOURNALBLOCK 33
QRYJOURNALDOCUMENT 34
QUERYPRNFIRMWARE 35
QUERYPRNJOURNAL 36
QUERYPRNMEMORY 37
QUERYPRNSTATUS 39
QUERYPRNTRANSACTION 42
READJOURNAL 45
READJOURNALRESUME 46
READMEMORY 47
RELEASEDLL32 48
RPTX 49
RPTZ 50
SEARCHJOURNALRANGE 52
SEARCHLOG 53
SEARCHPRN 54
SETMSGERR 55
SETTIMEOUTS 56

DIAGRAM OF SEQUENCE OF FUNCTIONS 57

FISCAL DOCUMENTS (INVOICES AND RETURNS) 57
NONFISCAL DOCUMENTS 58
CHECK PRINTING 59
PRINT FISCAL REPORTS 60
FISCAL PRINTER QUERIES 61

ERROR CODES LISTING 62

DLL ERRORS 62
FISCAL MEMORY ERRORS 65

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

2
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

APPENDIX A 66
QUERYPRNSTATUS PARAMETERS RETURNS BY PRINTER MODEL 66
7197-F 66
7167-F 67
A-721-F 68

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

3
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Introduction

The present manual is a reference to Point of Sales (POS) System’s programmers,

for the implementation of the PrnFiscalDLL32, developed to manage the functions of
Fiscal Printers models 7197-F, 7167-F and A-721-F which were developed by SUMMA
SISTEMAS, in fulfillment of the requirements established by the SENIAT concerning
the emission of documents generated by fiscal machines for the Bolivariana Republic of
Venezuela.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

4
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

General description

PrnFiscalDLL32 is a standard 32 bits DLL, developed to operate with the operating

systems: Windows 95 OSR2, Windows 98, Windows Me, NT, Windows 2000 and
Windows XP.
The PrnFiscalDLL32.dll, groups a set of functions that allow to manage the
elementary operations of Fiscal Documents creation (Invoices and Returns), NonFiscal
Documents, as well as a group of general functions for the emission of reports,
consultations and the Fiscal Memory configuration for the Summa Sistemas Fiscal
Printers 7197-F, 7167-F and A-721-F.
The 7197-F Fiscal Printer is a 1 station Thermal Receipt Printer that has a Fiscal
Memory and an Electronic Journal Memory.
The 7167-F Fiscal Printer is 2-station, Thermal Receipt Printer with Impact Slip
Station for Check printing. This fiscal printer also has a Fiscal Memory and an
Electronic Journal Memory.
The A-721-F Fiscal Printer is a 3-Station Receipt/Journal/Slip Impact Printer and
uses only the Fiscal Memory. It has a Paper Journal and uses a 2-ply roll paper. This
printer also is able to print checks on the Slip Station.
The present manual is a guide to the system programmer and a reference for the
implementation of the functions of the DLL PrnFiscalDLL32.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

5
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Conventions Used in this Manual of Reference

 ASCIIZ is a Null String finished in his equivalent in other languages are:

1. In C/C++: Data type char*

2. In Delphi: Data type pchar

3. In Visual BASIC 6: String Data type sent ByVal in the finished definition of DLL

(Declare Sentence) and reception of strings in null one becomes by means of

definitions of Strings of fixed size: Dim CString As String * n+1, where n is the

maximum length of string to receive by reference plus an additional position for null

character “CHR (0)”, Ejm:

Public Declare Function NewDoc Lib “PrnFiscalDLL32.dll” (_

ByVal TipDoc As Byte, _
ByVal NameCliente As String, _ ` Null terminared String
ByVal IDCliente As String, _ ` Null terminared String
ByVal IDCajero As String, _ ` Null terminared String
ByVal IDMemPrn As String, _ ` Null terminared String
ByVal NVoucher As Long, _
ByVal DiaFct As Byte, _
ByVal MesFct As Byte, _
ByVal AnoFct As Byte, _
ByVal HHFct As Byte, _
ByVal MMFct As Byte, _
ByVal SSFct As Byte, _
ByVal AMPMFct As Byte, _
ByVal DiaDev As Byte, _
ByVal MesDev As Byte, _
ByVal AnoDev As Byte, _
ByVal HHDev As Byte, _
ByVal MMDev As Byte, _
ByVal SSDev As Byte, _
ByVal AMPMDev As Byte _
) As Integer
All the previous data are by reference, including the ByVal data, since in Visual
BASIC 6 when passing a string through value to a DLL, is equivalent to pass any other
data type to the DLL ByRef.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

6
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

`Declaration of the variables to receive the data by reference at Procedure or Function

level in VB6

Type TQueryPrnStatus
UltSecX As String * 3 `The size is 2 + a position for CHR (0)
NTickets As String * 13 `The size is 12 + a position for CHR (0)
PrnStatusHdw As String * 3 `The size is 2 + a position for CHR (0)
ErrStatus As String * 3 `The size is 2 + a position for CHR (0)
PaperStatus As String * 3 `The size is 2 + a position for CHR (0)
SlipStatus As String * 3 `The size is 2 + a position for CHR (0)
PrnID As String * 11 `The size is 10 + a position for CHR (0)
TCounter As String * 7 ` The size is 6 + a position for CHR (0)
IvaA As Double
IvaB As Double
IvaC As Double
PrnStatusApp As Byte
LineCounter As Byte
AutStatus As Byte
End Type

Strings finished in null received in VB6, at the end of the string will have the
character CHR (0), which can be eliminated with a simple function of dynamic
substitution of strings of fixed length strings:

Public Function Chr2Str (cString As String) As String

Dim vbString As String
Dim i As Byte

For i = 1 To Len (cString)

If Asc (Mid (cString, i, 1)) = 0 Then
Exit For
Else
vbString = vbString & Mid (cString, i, 1)
End If
Next

Chr2Str = vbString
End Function

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

7
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

 ByVal: Data passed by value to the function in the DLL.

 ByRef: Data passed by reference to the function in the DLL.

 Optional: The data is optional.

 LongWord: They are numeric fields that represent integer numbers without sign in 4

bytes.

 String: They are chains of characters that do not finish in null.

 All the fields of values that represent amounts stored in the fiscal memory, pass by

reference from the DLL to the application in a String format of length 14; of which

the first 12 characters represent the whole part and last the 2 characters represent the

decimal part of the amount. The decimal point is not sent. This means that, when

receiving this String, the application will have on the first place, to turn it from

character to number and then it will have to divide it by 100 to obtain the amount that

is stored in the fiscal memory.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

8
 Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

List of functions of the Fiscal Printer by Alphabetical order

Function Description
Function CancelTransaction () Cancels a Transaction ( Fiscal or nonFiscal)
Function CloseDoc () Closes a Document
Function ClosePort () Closes the Port of the Fiscal Printer
Function ConfigIva () Configurates the Taxes of the Fiscal Printer
Function ConfigPay () Configurates the Names of the Payments Forms
Function DeleteLog () Deletes the Transactions Log
Function DisabledLog () Disables the Transactions Log
Function EnabledLog () Enables the Transactions Log
Function GenRptZ () Prints the Z Report and saves the totals to the Fiscal
Memory
Function NewDoc () Initiates the Process of Document Creation
Function NewItem () Adds/deletes an Item in Invoices or Returns
Function OpenBox () Opens the Cash Drawer
Function OpenPort () Opens the Port of the Fiscal Printer
Function OprDoc () Generates Cancellations, Discounts and Reductions in
Invoices and Returns.
Function PrintDocument() Reprints an invoice, return or a Z Report (from the
journal memory) as a nonfiscal document.
Function PrintTextNoFiscal () Prints nonFiscal Text
Function PrnChequeF () Prints a Check and its Endorsement
Function QryJournalBlock() Queries the records of an specifc journal memory block
Function QryJournalDocument() Queries an specific document from the journal memory
Function QueryPrnFirmware() Queries the firmware version
Function QueryPrnJournal() Queries the journal memory variables
Function QueryPrnMemory() Queries any of the 1825 Z Reports that are saved in the
fiscal memory
Function QueryPrnStatus () Queries the Status of the Fiscal Printer
Function QueryPrnTransaction () Queries the Working Memory and the Last X Report
Function ReadJournal() Reads the information stored in the Journal Memory
and download it to a TXT file
Function ReadJournalResume() Reads and downloads to a TXT file a resume of the
information from the documents stored in the Journal
Memory
Function ReadMemory() Reads the information stored in the Fiscal Memory and
download it to a TXT file.
Function ReleaseDLL32 Visualizes the DLL of 32 Bits version
Function RptX () Prints the X Report
Function RptZ () Prints the Z Report by Time intervals
Function SearchJournalRange() Searchs the upper and lower blocks from the Journal
Memory next to a given range date
Function SearchLog () Determines if the Transactions Log is Active
Function SearchPrn () Determines if the Fiscal Printer this On Line
Function SetMsgErr () Enables or Disables the Msg function of the DLL

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

9
 Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

List of functions of the Fiscal Printer by Category

Creation of Invoices, Returns and nonFiscal Documents Functions

Function Description
Function CancelTransaction () Cancels a Transaction ( Fiscal or nonFiscal)
Function CloseDoc () Closes a Document
Function NewDoc () Initiates the Process of Document Creation
Function NewItem () Creates an Item in Invoices or Returns
Function OprDoc () Generates Cancellations, Discounts and Reductions in
Invoices and Returns.
Function PrintDocument() Reprints an invoice, return or a Z Report (from the
journal memory) as a nonfiscal document.
Function PrintTextNoFiscal () Print nonFiscal Text

Query Functions

Function Description
Function QryJournalBlock() Queries the records of an specifc journal memory
block
Function QryJournalDocument() Queries an specific document from the journal
memory
Function QueryPrnFirmware() Queries the firmware version
Function QueryPrnJournal() Queries the journal memory variables
Function QueryPrnMemory() Queries any of the 1825 Z Reports that are saved in the
fiscal memory
Function QueryPrnStatus () Queries the Status of the Fiscal Printer
Function QueryPrnTransaction () Queries the Working Memory and the Last X Report

Reports Functions

Function Description
Function GenRptZ () Prints the Z Report
Function PrnChequeF () Print a Check and its Endorsement
Function RptX () Prints the X Report
Function RptZ () Prints the Z Report by Time intervals

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

10
 Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Read Functions

Function Description
Function ReadJournal() Reads the information stored in the Journal Memory
and download it to a TXT file
Function ReadJournalResume() Reads and downloads to a TXT file a resume of the
information from the documents stored in the Journal
Memory
Function ReadMemory() Reads the information stored in the Fiscal Memory and
download it to a TXT file.
Function SearchJournalRange() Searchs the upper and lower blocks from the Journal
Memory next to a given range date

Control Functions

Function Description
Function ClosePort () Closes the Port of the Fiscal Printer
Function OpenBox () Opens the Recording Box
Function OpenPort () Opens the Port of the Fiscal Printer
Function ReleaseDLL32 () Visualizes the DLL of 32 Bits version
Function SearchPrn () Determines if the Fiscal Printer this On Line

Log Functions

Function Description
Function DeleteLog () Deletes the Transactions Log
Function DisabledLog () Disables the Transactions Log
Function EnabledLog () Enables the Transactions Log
Function SearchLog () Determines if the Transactions Log is Active

Configuration Functions

Function Description
Function ConfigIva () Configurates the Taxes of the Fiscal Printer
Function ConfigPay () Configurates the Names of the Payments Forms
Function SetMsgErr () Enables or Disables the Msg function of the DLL

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

11
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Functions Description

CancelTransaction

Syntax:

Public Function CancelTransaction () As Integer

Description:

This function cancels the actual transaction. It allows to cancel an invoice or return
without affecting the fiscal totals and leaving the Fiscal Printer ready for any other
operation, as to initiate a new invoice or return, request a status or totals query or to
print reports.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

12
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

CloseDoc

Syntax:

Public Function CloseDoc (_

Optional ByVal FPago1 AS Double, _
Optional ByVal FPago2 AS Double, _
Optional ByVal FPago3 AS Double, _
Optional ByVal FPago4 AS Double, _
Optional ByVal FPago5 AS Double, _
Optional ByVal FPago6 AS Double, _
Optional ByVal DscGlobal AS Double, _
Optional ByVal RcgGlobal AS Double, _
Optional ByVal BarcodeLong AS Byte, _
Optional ByVal BarcodeTipo AS Byte, _
Optional ByVal BarcodeData AS CString _
) As Integer

Description:

This function closes the actual document (Invoice, Return or nonFiscal Document)
and updates the Fiscal Memory.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

FPago1 Double ByVal 14 2 Payment Form 1
FPago2 Double ByVal 14 2 Payment Form 2
FPago3 Double ByVal 14 2 Payment Form 3
FPago4 Double ByVal 14 2 Payment Form 4
FPago5 Double ByVal 14 2 Payment Form 5
FPago6 Double ByVal 14 2 Payment Form 6
DscGlobal Double ByVal 14 2 Fiscal Document Global Discount
RcgGlobal Double ByVal 14 2 Fiscal Document Global Surcharge
BarcodeLong Byte ByVal 4 0 Barcode Length
BarcodeTipo Byte ByVal 4 0 Barcode Type
BarcodeData CString ByVal 26 0 Barcode Data

Note: All the previous data are optional for the closing of a Fiscal Document.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

13
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Barcode Printing in the 7197-F and 7167-F fiscal printers

 The fiscal printers print a bar code for the ASCII characters entered in the
BarcodeData variable and in accordance with the bar code type that is found in
the BarcodeTipo variable.
 The max length of the BarcodeData is 26 characteres.
 If the width of the bar code exceeds one line, the barcode is not printed.
 The check digit is calculated for UPC and JAN (EAN) codes if it is not sent
from the host computer. Six-character zero-suppressed UPC-E tags are
generated from full 11 or 12 characters sent from the host computer according to
standard UPC-E rules. Start/Stop characters are added for Code 39 if they are
not included.

BarcodeTipo = 65 - 73, 75 (see the table)

BarcodeData = 0 - 127 (see the table)
BarcodeLong = 1 - 26 (see the table)

The value of BarcodeTipo selects the bar code system as described in the table.
The variable BarcodeData indicates the character code to be encoded into the specified
bar code system. If character code in BarcodeData cannot be encoded, the printer prints
the bar code data processed so far, and the following data is treated as normal data.

BarcodeTipo BarCode BarcodeData BarcodeLong

65 UPC-A 48- 57 (ASCII numerals) Fixed Length: 11, 12
66 UPC-E 48- 57 Fixed Length: 11, 12
67 JAN13 (EAN13) 48- 57 Fixed Length: 12, 13
68 JAN8 (EAN8) 48- 57 Fixed Length: 7, 8
48- 57, 65- 90 (ASCII alphabet), 32, 36,
37, 43, 45, 46, 47 (ASCII special
69 CODE 39 Variable
characters) d1 = dn = 42 (start/stop
code is supplied by printer if necessary)
Interleaved 2 of 5 Variable (Even
70 48- 57
(ITF) Number)
65- 68, start code 48- 57, 36, 43, 45,
71 CODABAR (NW-7) Variable
46, 47, 58
72 Code 93 0 - 127 Variable
0-105 d1 = 103-105 (must be a Start
73 Code 128 code) d2 = 0-102 (data bytes) (Stop Variable
code is provided by the printer)
75 PDF417 0 – 255 Variable

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

14
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ClosePort

Syntax:

Public Function ClosePort () As Integer

Description:

This function closes the serial port manager for the communication with the Fiscal
Printer.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

15
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ConfigIVA

Syntax:

Public Function ConfigIva (_

ByVal IvaA As Double, _
ByVal IvaB As Double, _
ByVal IvaC As Double _
) As Integer

Description:

This function sets the values of the IVA (Tax)

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

IvaA Double ByVal 4 0 IVA Type A Value
IvaB Double ByVal 4 0 IVA Type B Value
IvaC Double ByVal 4 0 IVA Type C Value

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

16
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ConfigPay

Syntax:

Public Function ConfigPay (_

ByVal FrmPay As ASCIIZ _
ByVal LineFrmPay As Byte _
) As Integer

Description:

This function changes the name of the payment forms of the Fiscal Printer which go
numbered from the 0 to the 5. This operation can be done up to 255 times, for all the 6
payments types.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

FrmPay ASCIIZ ByVal 15 0 Description of Payment Form
LineFrmPay Byte ByVal 1 0 Name of Payment Form (0-5)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

17
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

DeleteLog

Syntax:

Public Function DeleteLog () As Integer

Description:

This function deletes the historical transaction log from the application’s directory.
The historical transactions log file is named “HstPrnCmd.log” and it is located in the
PATH of the DLL.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

18
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

DisabledLog

Syntax:

Public Function DisabledLog () As Integer

Description:

This function deactivates the historical transactions log.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

19
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

EnabledLog

Syntax:

Public Function EnabledLog () As Integer

Description:

This function activates the historical transactions log on the application’s directory.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

20
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

GenRptZ

Syntax:

Public Function GenRptZ (_

ByVal DiaRptZ As Byte, _
ByVal MesRptZ As Byte, _
ByVal AnoRptZ As Byte, _
ByVal HHRptZ As Byte, _
ByVal MMRptZ As Byte, _
ByVal SSRptZ As Byte, _
ByVal AMPMRptZ As Byte _
) As Integer

Description:

This function records the totals of the day in the Fiscal Memory, resets the totals
from the working memory and prints a the Z Reports. It leaves the printer ready for the
next day. This function must be called at least once at a working day.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

DiaRptZ Byte ByVal 2 0 Day of Z Report
MesRptZ Byte ByVal 2 0 Month of Z Report
AnoRptZ Byte ByVal 2 0 Year of Z Report
HHRptZ Byte ByVal 2 0 Hour of Z Report
MMRptZ Byte ByVal 2 0 Minute of Z Report
SSRptZ Byte ByVal 2 0 Second of Z Report
AMPMRptZ Byte ByVal 1 0 AMPM of Z Report (AM=0, PM=1)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

21
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

NewDoc

Syntax:

Public Declare Function NewDoc Lib “PrnFiscalDLL32.dll” (_

ByVal TipDoc As Byte, _
ByVal NameCliente As ASCIIZ, _
ByVal IDCliente As ASCIIZ, _
ByVal IDCajero As ASCIIZ, _
ByVal IDMemPrn As ASCIIZ, _
ByVal NVoucher As LongInt, _
ByVal DiaFct As Byte, _
ByVal MesFct As Byte, _
ByVal AnoFct As Byte, _
ByVal HHFct As Byte, _
ByVal MMFct As Byte, _
ByVal SSFct As Byte, _
ByVal AMPMFct As Byte, _
ByVal DiaDev As Byte, _
ByVal MesDev As Byte, _
ByVal AnoDev As Byte, _
ByVal HHDev As Byte, _
ByVal MMDev As Byte, _
ByVal SSDev As Byte, _
ByVal AMPMDev As Byte _
) As Integer

Description:

It generates a new document (Invoice, Return or nonFiscal).

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

22
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Parameters:

Parameter Tipo Form Long. DEC. Description

Document type
TipDoc Byte ByVal 1 0 0=Invoice, 1=Returns,
3=Non Fiscal
NameCliente ASCIIZ ByVal 106 0 Client’s Name
IDCliente ASCIIZ ByVal 30 0 Client ID (RIF or C.I.)
IDCajero ASCIIZ ByVal 20 0 Cashier’s name
IDMemPrn ASCIIZ ByVal 10 0 Fiscal Printer ID (Only on Returns)
Nvoucher LongInt ByVal 8 0 Invoice Number (Only on Returns)
DiaFct Byte ByVal 2 0 Invoice Day
MesFct Byte ByVal 2 0 Invoice Month
AnoFct Byte ByVal 2 0 Invoice Year
HHFct Byte ByVal 2 0 Invoice Hour
MMFct Byte ByVal 2 0 Invoice Minute
SSFct Byte ByVal 2 0 Invoice Second
AMPMFct Byte ByVal 1 0 Invoice AMPM (0=AM, 1=PM)
DiaDev Byte ByVal 2 0 Returns Day
MesDev Byte ByVal 2 0 Returns Month
AnoDev Byte ByVal 2 0 Returns Year
HHDev Byte ByVal 2 0 Returns Hour
MMDev Byte ByVal 2 0 Returns Minute
SSDev Byte ByVal 2 0 Returns Second
AMPMDev Byte ByVal 1 0 Returns AMPM (0=AM, 1=PM)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

23
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

NewItem

Syntax:

Public Function NewItem (_

ByVal TipOpr As Byte, _
ByVal TipIva As Byte, _
ByVal Amount As Double, _
ByVal Price As Double, _
ByVal Item As ASCIIZ _
) As Integer

Description:

This function permits to add or void an item on the document (Invoice or Return)
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. Description

Type of Operation
TipOpr Byte ByVal 1
0 = Add Item, 1 = Void Item
Type of IVA
TipIva Byte ByVal 1 0 = IvaA, 1 = IvaB, 2 = IvaC,
3 = Exento
Quantity Double ByVal 14 Item’s quantity
Item’s unitary price (with no IVA
Price Double ByVal 14
Added)
Item’s Description (Máx 190
Item ASCIIZ ByVal 25
Characters)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

24
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

OpenBox

Syntax:

Public Function OpenBoxt () As Integer

Description:

This function opens the Cash Drawer that is connected to the Fiscal Printer.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

25
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

OpenPort

Syntax:

Public Function OpenPort (ByVal SerialPort As Byte, ByVal ComBps As Byte) As

Integer

Description:

This function opens the serial port’s manager for the communication with the Fiscal
Printer. This function accepts any valid serial port in the POS.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

SerialPort Byte ByVal 3 0 Serial Port (1)
ComBps Byte ByVal 3 0 Baud Rate Indicator (2)

Note:
1.- The SerialPort parameter accepts any valid value of serial port in the rank from 0 to
255, ejm: COM1 = 1, COM2 = 2, COM3 =3 and so on.
2.- The ComBps parameter accepts only 1=19200 BPS (A-721-F) or 2=115200 BPS
(7197-F, 7167-F).

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

26
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

OprDoc

Syntax:

Public Function OprDoc (_

ByVal TipOpr As Byte, _
ByVal TipIva As Byte, _
ByVal Amount As Double, _
ByVal DscOpr As ASCIIZ _
) As Integer

Description:

This function allows to generate surcharge and discount operations and the
respective cancellations in the fiscal documents (Invoices or Returns).
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Type of Operation
0=Discount
TipOpr Byte ByVal 1 0 1=Void Surcharge
3=Void Discount
4= Surcharge
Type of IVA (A, B or C)
0=Iva A
TipIva Byte ByVal 1 0 1=Iva B
2=Iva C
3=Exento
Amount Double ByVal 14 0 Amount of the operation
Description of the operation (Máx
DscOpr ASCIIZ ByVal 17 0
190 Characters)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

27
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

PrintDocument

Syntax:

Public Function PrintDocument ( _

ByVal NumDoc As Long, _
ByVal DiaDoc As Byte, _
ByVal MesDoc As Byte, _
ByVal AñoDoc As Byte, _
ByVal TipDoc As Byte, _
ByVal DiaPrc As Byte, _
ByVal MesPrc As Byte, _
ByVal AñoPrc As Byte, _
ByVal HoraPrc As Byte, _
ByVal MinutoPrc As Byte, _
ByVal SegundoPrc As Byte, _
ByVal AMPMPrc As Byte
) As Integer

Description:

This function allows reprint an invoice, an return or a Z Report (from the journal
memory) as a nonfiscal document, that means that every 4 lines of nonfiscal text
printed, the fiscal printer will print a fifth line with the phrase “NO FISCAL” in capital
letters.
This function is valid only on the 7197-F and 7167-F thermal fiscal printers (with
electronic journal).

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

28
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Parameters:

Parameter Tipo Form Long. DEC. Description

NumDoc Long ByVal 4 0 Document fiscal consecutive
DiaDoc Byte ByVal 2 0 Day of the document to reprint
MesDoc Byte ByVal 2 0 Month of document to reprint
AñoDoc Byte ByVal 2 0 Year of document to reprint
TipoDoc Byte ByVal 2 0 Type of Document to reprint
0= Invoice, 1=Return, 4= Z Report
DiaPrc Byte ByVal 2 0 Day of this nonfiscal document
MesPrc Byte ByVal 2 0 Month of this nonfiscal document
AñoPrc Byte ByVal 2 0 Year of this nonfiscal document
HoraPrc Byte ByVal 2 0 Hour of this nonfiscal document
MinutoPrc Byte ByVal 2 0 Minute of this nonfiscal document
SegundoPrc Byte ByVal 2 0 Second of this nonfiscal document
AMPMPrc Byte ByVal 1 0 AMPM of this nonfiscal document
(AM=0, PM=1)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

29
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

PrintTextNoFiscal

Syntax:

Function PrintTextNoFiscal (_
ByVal TFonts As Byte, _
ByVal TextNoFiscal As String, _
ByVal NumLine As Byte, _
ByVal Buffer As Byte _
) As Integer

Description:

This function allows printing nonfiscal text within a NonFiscal Document or within
an Invoice or a Return.
If used within a Nonfiscal Document, every 4 lines of nonfiscal text printed, the
fiscal printer will print a fifth line with the phrase “NO FISCAL” in capital letters.
If used within an Invoice or Return, the phrase “NO FISCAL” is never printed. This
command can be used after the NewDoc and NewItem functions as unbuffered and
before CloseDoc as buffered; when the CloseDoc function is called, the printer will
print the buffered text lines before the dot line that comes before the Fiscal Logo Line
(the very last line printed in a fiscal document that conteins the MH and the fiscal
printer serial number). This buffered lines are intended to be used as a footer on the
Invoices or Returns. The fiscal printer allows up to 10 lines of nonfiscal lines as a footer
(0 to 9) and the 0 is used for a description on the Global Discounts and or Returns.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

30
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Parameters:

Parameter Tipo Form Long. DEC. Description

Font Type
1= Normal Font
Tfonts Byte ByVal 1 0
49= Double Font
129=Bold Font
TextoNoFiscal ASCIIZ ByVal 38 0 Text to print
Line number of the Text to
NumLine ASCIIZ ByVal 1 0
print
0=Prints nonFiscal Text
unbuffered
Buffer ASCIIZ ByVal 1 0
1= Buffers the nonFiscal
Text

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

31
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

PrnChequeF

Syntax:

Public Function PrnChequeF (_

ByVal TipPrc As Byte, _
Optional ByVal DiaChq As Byte, _
Optional ByVal MesChq As Byte, _
Optional ByVal AnoChq As Byte, _
Optional ByVal Monto As Double, _
Optional ByVal Destinatario As ASCIIZ, _
Optional ByVal NumCta As ASCIIZ, _
Optional ByVal TitularCta As ASCIIZ, _
Optional ByVal BancoCta As ASCIIZ _
) As Int

Description:

Print a check with all its data and allow to endorse it. The optional fields are
grouped by type of process: 0= (DiaChq, MesCheq, AnoCheq, Amount, Adressee), 1=
(NumCta, TitularCta, BancoCta), 2= (To print Check or Endorsement). According to
the process to make, the other external fields to the group are optional.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Type of Process
0=Print Check
TipPrc Byte ByVal 1 0
1=Endose Check
2=Print Check or Endorsement
DiaChq Byte ByVal 2 0 Check’s Day
MesChq Byte ByVal 2 0 Check’s Month
AnoChq Byte ByVal 2 0 Check’s Year
Monto Double ByVal 12 2 Check’s Amount
Destinatario ASCIIZ ByVal 70 0 Pay to order of
NumCta ASCIIZ ByVal 72 0 Account’s Number
TitularCta ASCIIZ ByVal 73 0 Title’s Account
BancoCta ASCIIZ ByVal 70 0 Account’s Bank

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

32
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QryJournalBlock

Syntax:

Public Declare Function QryJournalBlock ( _

ByVal BlockJournal As Long, _
ByRef JrnMemBlock As TJrnMemBlock _
) As Integer

Description:

This function returns the records of an specifc journal memory block. This records
contain the documents registered in that journal memory block.
Note: The Journal Block Number for an specific date can be obteined using the
DLL’s function SearchJournalRange

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

BlockJournal Long ByVal 4 0 Journal Block Number
JrnMemBlock Record ByRef 980 Journal Memory Block

Note: The record type is form by the TJrnMemBlock structure:

Type TJrnMemBlock
JrnBlk As String * 980
End Type

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

33
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QryJournalDocument

Syntax:

Public Declare Function QryJournalDocument ( _

ByVal TipDoc As String, _
ByVal NumDoc As String, _
ByVal FecDoc As String _
) As Integer

Description:

This function returns an specific document from the journal memory. This document
can be obteined through 3 parameters: type of document, document’s consecutive and
the date when the document was issued. This function creates in the hard disk a TXT
file named JournalDocument.txt that contains the document found and which can be
easily processed and/or displayed.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Document Type
0=Invoice, 1=Returns,
TipDoc String ByVal 4 0
3=Non Fiscal, 4=Z Report,
5=Memory Report
NumDoc String ByVal Document’s Consecutive
Issue date of the document in the
FecDoc String ByVal 980
format DD/MM/YYYY

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

34
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QueryPrnFirmware

Syntax:

Public Function QueryPrnFirmware ( _

ByRef PrnFirmware As TQueryPrnFirmware _
) As Integer

Description:

This function returns the firmware version.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

PrnFirmware Record ByRef 5 Firmware Version

Note: The record type is form by the TqueryPrnFirmware structure:

Type TQueryPrnFirmware
Version As String * 5
End Type

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

35
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QueryPrnJournal

Syntax:

Public Function QueryPrnJournal ( _

ByRef PrnJournal As TQueryPrnJournal _
) As Integer

Description:

This function queries the journal memory variables.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

PrnJournal Record ByRef 43 Journal Memory Variables

Note: The record type is form by the TqueryPrnJournal structure:

Type TQueryPrnJournal
StatusJournal As String * 2
NumberJournal As String * 2
RIFJournal As String * 15
MemIDJournal As String * 10
NumRegHexJournal As String * 6
NumRegDecJournal As String * 8
End Type

Parameter Tipo Form Long. DEC. Description

Status of the Journal
StatusJournal String 2 0 = No linked to the fiscal memory
1 = Linked to the fiscal memory
Consecutive of the Journal
NumberJournal String 2
Memory
RIFJournal String 15 Fiscal Printer owner’s Rif
MemoryIDJournal String 10 Fiscal Printer ID number
String Transaction Number on the Journal
NumRegHexJournal 6
Memory (Hex)
String Transaction Number on the Journal
NumRegDecJournal 8
Memory (Dec)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

36
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QueryPrnMemory

Syntax:

Function QueryPrnMemory (_
ByVal MemRptZ As Integer, _
ByRef PrnMem As TQueryPrnMemory _
) As Integer

Description:

This function allows to query any of the 1825 Z Reports that are saved in the fiscal
memory, from the 1 to the 1825.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

MemRptZ Integer ByVal 1 0 Number of Z Report
PrnMem Record ByRef 792 Z Report in Memory

Note: The record type is form by the TqueryPrnMemory structure:

Type TQueryPrnMemory
DateTimeRptZ As String * 23 (RptZ Date)
DateTimeLastVta As String * 23 (Last Invoice)
DateTimeLastDev As String * 23 (Last Return)
DateTimeLastNoFiscal As String * 23 (Last nonFiscal Doc)
DateTimeLastRptZ As String * 23 (Date of the previous RptZ)
DateTimeLastMemRptZ As String * 23 (Not used)
CounterLastVta As String * 14 (Invoices Counter)
CounterLastDev As String * 14 (Returns counter)
CounterLastNoFiscal As String * 14 (NonFiscal Documents counter)
CounterLastRptZ As String * 14 (RptZ Counter )
CounterLastMemRptZ As String * 14
VtaA As String * 14 (Sale Tax type A)
VtaB As String * 14 (Sale Tax type B)
VtaC As String * 14 (Sale Tax type C)
VtaE As String * 14 (Sale Tax type E)
IvaVtaA As String * 14 (IVA (Tax) Type A)
IvaVtaB As String * 14 (IVA (Tax) Type B)
IvaVtaC As String * 14 (IVA (Tax) Type C)
DscVtaA As String * 14 (Discount Tax Type A)
DscVtaB As String * 14 (Discount Tax Type B)
DscVtaC As String * 14 (Discount Tax Type C)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

37
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

DscVtaE As String * 14 (Discount Tax Type E)

RcgVtaA As String * 14 (Surcharge G Type)
RcgVtaB As String * 14 (Surcharge R Type)
RcgVtaC As String * 14 (Surcharge Type A)
RcgVtaE As String * 14 (Surcharge Type E)
DevA As String * 14 (Return G Type)
DevB As String * 14 (Return R Type)
DevC As String * 14 (Return Type A)
DevE As String * 14 (Return Type E)
IvaDevA As String * 14 (IVA (Tax) Return Type A)
IvaDevB As String * 14 (IVA (Tax) Return Type B)
IvaDevC As String * 14 (IVA (Tax) Return Type C)
DscDevA As String * 14 (Discount Return Tax Type A)
DscDevB As String * 14 (Discount Return Tax Type B)
DscDevC As String * 14 (Discount Return Tax Type C)
DscDevE As String * 14 (Discount Return Tax Type E)
RcgDevA As String * 14 (Surcharge Return Tax Type A)
RcgDevB As String * 14 (Surcharge Return Tax Type B)
RcgDevC As String * 14 (Surcharge Return Tax Type C)
RcgDevE As String * 14 (Surcharge Return Tax Type E)
FPago1 As String * 14 (Payment Form Type 1)
FPago2 As String * 14 (Payment Form Type 2)
FPago3 As String * 14 (Payment Form Type 3)
FPago4 As String * 14 (Payment Form Type 4)
FPago5 As String * 14 (Payment Form Type 5)
FPago6 As String * 14 (Payment Form Type 6)
CounterVta As String * 14 (Incremental sales counter to the date of the previous RptZ)
CounterDev As String * 14 (Incremental Return counter to the date of the previous RptZ)
CounterNoFiscal As String * 14 (Inc. NonFis Docs counter to the date of the previous RptZ )
AnulVtaA As String * 14 (Product Cancellation Sale Tax Type A)
AnulVtaB As String * 14 (Product Cancellation Sale Tax Type B)
AnulVtaC As String * 14 (Product Cancellation Sale Tax Type C)
AnulVtaE As String * 14 (Product Cancellation Sale Tax Type E)
AnulDevA As String * 14 (Product Cancellation Return Tax Type A)
AnulDevB As String * 14 (Product Cancellation Return B Tax Type)
AnulDevC As String * 14 (Product Cancellation Return Tax Type C)
AnulDevE As String * 14 (Product Cancellation Return Tax Type E)
End Type

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

38
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QueryPrnStatus

Syntax:

Function QueryPrnStatus (_
ByRef PrnStatus As TQueryPrnStatus _
) As Integer

Description:

This function allows to query the status of the Fiscal Printer.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Status of the Printer
0=Idle
PrnStatusApp Byte ByRef 1 0 1=Invoice
2=Return
3=NoFiscal
Line number of NonFiscal Text
LineCounter Byte ByRef 1 0 (It prints 4 lines, fifth (5) “NO
FISCAL ” and so on)
Last X Sector (Fiscal Memory Area)
UltSecX (7197-
(7197-F, 7167-F only) / Last
F, 7167-F only)
String ByRef 2 0 Transaction finish status (A-721-F
/ LastTransStat
only)
(A-721-F only)
PrnStatusHdw String ByRef 2 0 * Hardware Status
ErrStatus String ByRef 2 0 * Error Status
PaperStatus String ByRef 2 0 * Paper Status
SlipStatus String ByRef 2 0 * Check Status
Authentication Status
0=Authentication Error (it does not
AutStatus Byte ByRef 1 0
have personalización code )
1=Fiscal Printer Authenticated
PrnID String ByRef 10 0 Fiscal Printer ID
IvaA String ByRef 4 2 % of IVA A
IvaB String ByRef 4 2 % of IVA B
IvaC String ByRef 4 2 % of IVA C
PrnMdlMrk String ByRef 10 Model of the fiscal printer
Rif String ByRef 15 0 Fiscal Printer owner’s Rif
MemoryNumber String ByRef 2 0 Memory Number of the Fiscal Printer
Tcounter String ByRef 6 0 Transactions counter
UltZ Long ByRef 16 0 Last Z Report Number

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

39
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

* See Apendix A

- On 7197-F and 7167-F:

Structure of QueryPrnStatus Data:

Type TQueryPrnStatus
UltSecX As String * 3
PrnStatusHdw As String * 3
ErrStatus As String * 3
PaperStatus As String * 3
SlipStatus As String * 3
PrnID As String * 11
TCounter As String * 7
PrnMdlMrk As String * 11
Rif As String * 16
MemoryNumber As String * 3
IvaA As String * 8
IvaB As String * 8
IvaC As String * 8
PrnStatusApp As Byte
LineCounter As Byte
AutStatus As Byte
UltZ As LongWord
End Type

IvaA, IvaB, IvaC are strings of length 8 which they represent double numbers of 6 integers and
2 decimals without decimal point.

- On A-7121-F:

Structure of QueryPrnStatus Data:

Type TQueryPrnStatus
LastTransStat As String * 3
PrnStatusHdw As String * 3
ErrStatus As String * 3
PaperStatus As String * 3
SlipStatus As String * 3
PrnID As String * 11
TCounter As String * 7
PrnMdlMrk As String * 11
Rif As String * 16
MemoryNumber As String * 3
IvaA As String * 8
IvaB As String * 8
IvaC As String * 8
PrnStatusApp As Byte
LineCounter As Byte
AutStatus As Byte
UltZ As LongWord
End Type

IvaA, IvaB, IvaC are strings of length 8 which they represent double numbers of 6 integers and
2 decimals without decimal point.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

40
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Last Transaction finish status (Only on A-721-F fiscal printers):

The first byte represents the type of the last document:
 0: Invoice

 1: Returns

 2: Non Fiscal Document

 3: Z Report

 4: Memory Report

The second byte represents the finish status of the last transaction:
 0: Transaction finished OK

 1: Canceled by the user (usando el comando 0x09 de anular transacción en

curso)

 2: Canceled because of an energy failure

Example: if the command returns on this field:

 10 means that the last transaction was an invoice and was cancelled by the user.

 21 means that the last transaction was a return and it was cancelled because an
energy failure.

 00 means that the last transaction was an invoice and finished OK.

When an invoice, return or a non fiscal document is cancelled by the user, the fiscal
printer increments the respective transaction counter, prints the frase “Transaccion
Anulada” (Transaction Cancelled) and prints the respective transaction document’s
footer:
Transaccion Anulada
MH JJD0000012

When an invoice, return or a non fiscal document is cancelled by an energy failure, the
fiscal printer increments the respective transaction counter, prints the frases
“Transaccion Anulada” “*Falla de Energia*”(Transaction Cancelled / Energy Failure)
and prints the respective transaction document’s footer:
*Falla de Energia*
Transaccion Anulada
MH JJD0000012

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

41
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

QueryPrnTransaction

Syntax:

Function QueryPrnTransaction (_
ByVal TReport AS Byte, _
ByRef PrnStatus AS TQueryPrnTransaction _
) As Integer

Description:

This function allows to query the Fiscal Printer’s Status (Working Memory and Last
X totals). The Working Memory always will contain the result of the last operation
made (NewDoc, NewItem, OprDoc, CloseDoc, RptX, RptZ, GenRptZ ). Last X totals
will contain the summary of all the transactions made with the Fiscal Memory (Updated
with CloseDoc) since the last Z Report emitted (GenRptZ). The data to consult are
passed and updated by DLL through the TQueryPrnTransaction structure, detailed at the
end of this function.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

42
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Parameters:

Parameter Tipo Form Long. DEC. Description

TReport ByVal Byte 1 0 Type of Report
1= Working Memory
2= Last X totals
RptDate ByRef ASCIIZ 6 0 Date last operation
RptTime ByRef ASCIIZ 6 0 Hour last operation
RptAMPM ByRef ASCIIZ 1 0 Meridiam (AM=0, PM=1)
VoucherVta ByRef Long 16 0 Last Processed Invoice
VoucherDev ByRef Long 16 0 Last Processed Return
VtaA ByRef String 14 2 Total Invoices IVA A
VtaB ByRef String 14 2 Total Invoices IVA B
VtaC ByRef String 14 2 Total Invoices IVA C
VtaE ByRef String 14 2 Total Invoices Exento
IvaVtaA ByRef String 14 2 Total IVA A Invoices
IvaVtaB ByRef String 14 2 Total IVA B Invoices
IvaVtaC ByRef String 14 2 Total IVA C Invoices
DscVtaA ByRef String 14 2 Total Discount IVA A Invoices
DscVtaB ByRef String 14 2 Total Discount IVA B Invoices
DscVtaC ByRef String 14 2 Total Discount IVA C Invoices
DscVtaE ByRef String 14 2 Total Discount Exento Invoices
RcgVtaA ByRef String 14 2 Total Surcharge IVA A Invoices
RcgVtaB ByRef String 14 2 Total Surcharge IVA B Invoices
RcgVtaC ByRef String 14 2 Total Surcharge IVA C Invoices
RcgVtaE ByRef String 14 2 Total Surcharge Exento Invoices
DevA ByRef String 14 2 Total Returns IVA A
DevB ByRef String 14 2 Total Returns IVA B
DevC ByRef String 14 2 Total Returns IVA C
DevE ByRef String 14 2 Total Returns Exento
IvaDevA ByRef String 14 2 Total IVA A Returns
IvaDevB ByRef String 14 2 Total IVA B Returns
IvaDevC ByRef String 14 2 Total IVA C Returns
DscDevA ByRef String 14 2 Total Discount IVA A Returns
DscDevB ByRef String 14 2 Total Discount IVA B Returns
DscDevC ByRef String 14 2 Total Discount IVA C Returns
DscDevE ByRef String 14 2 Total Discount Exento Returns
RcgDevA ByRef String 14 2 Total Surcharge IVA A Returns
RcgDevB ByRef String 14 2 Total Surcharge IVA B Returns
RcgDevC ByRef String 14 2 Total Surcharge IVA C Returns
RcgDevE ByRef String 14 2 Total Surcharge Exento Returns
FPago1 ByRef String 14 2 Payment Type 1
Fpago2 ByRef String 14 2 Payment Type 2
Fpago3 ByRef String 14 2 Payment Type 3
Fpago4 ByRef String 14 2 Payment Type 4
Fpago5 ByRef String 14 2 Payment Type 5
Fpago6 ByRef String 14 2 Payment Type 6

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

43
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Structure of QueryPrnTransaction Data:

TYPE TQueryPrnTransaction
RptDate AS ASCIIZ * 9
RptTime AS ASCIIZ * 9
RptAMPM AS ASCIIZ * 3
VoucherVta AS LONGWORD
VoucherDev AS LONGWORD
VtaA AS STRING * 14
VtaB AS STRING * 14
VtaC AS STRING * 14
VtaE AS STRING * 14
IvaVtaA AS STRING * 14
IvaVtaB AS STRING * 14
IvaVtaC AS STRING * 14
DscVtaA AS STRING * 14
DscVtaB AS STRING * 14
DscVtaC AS STRING * 14
DscVtaE AS STRING * 14
RcgVtaA AS STRING * 14
RcgVtaB AS STRING * 14
RcgVtaC AS STRING * 14
RcgVtaE AS STRING * 14
DevA AS STRING * 14
DevB AS STRING * 14
DevC AS STRING * 14
DevE AS STRING * 14
IvaDevA AS STRING * 14
IvaDevB AS STRING * 14
IvaDevC AS STRING * 14
DscDevA AS STRING * 14
DscDevB AS STRING * 14
DscDevC AS STRING * 14
DscDevE AS STRING * 14
RcgDevA AS STRING * 14
RcgDevB AS STRING * 14
RcgDevC AS STRING * 14
RcgDevE AS STRING * 14
FPago1 AS STRING * 14
FPago2 AS STRING * 14
FPago3 AS STRING * 14
FPago4 AS STRING * 14
FPago5 AS STRING * 14
FPago6 AS STRING * 14
END TYPE

The amounts sent like STRING * 14, represent fields type Double of 12 integers and 2 decimals without
decimal point.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

44
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ReadJournal

Syntax:

Public Function ReadJournal ( _

ByVal FechaI As String, _
ByVal FechaF As String, _
ByVal ArchivoSalida As String _
) As Integer;

Description:

This function allows read the information stored in the Journal Memory and
download it to a TXT file.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

FechaI String ByVal 10 0 Search Initial Date in a
format DD/MM/AAAA
FechaF String ByVal 10 0 Search Final Date in a
format DD/MM/AAAA
ArchivoSalida String ByVal 255 0 Name of the TXT file
where the information is
going to be stored

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

45
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ReadJournalResume

Syntax:

Public Declare Function ReadJournalResume ( _

ByVal FechaI As String, _
ByVal FechaF As String, _
ByVal ArchivoSalida As String _
) As Integer

Description:

This function downloads to a TXT file a resume of the information from the
documents stored in the Journal Memory. The basic information (Document type,
Document’s consecutive, Date and Time of issue) returned from this function can be
generated fast and is useful in certain times.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

FechaI String ByVal 10 0 Search Initial Date in a
format DD/MM/AAAA
FechaF String ByVal 10 0 Search Final Date in a
format DD/MM/AAAA
ArchivoSalida String ByVal 255 0 Name of the TXT file
where the information is
going to be stored

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

46
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ReadMemory

Syntax:

Public Function ReadMemory ( _

ByVal FechaI As String, _
ByVal FechaF As String, _
ByVal ArchivoSalida As String _
) As Integer;

Description:

This function allows read the information stored in the Fiscal Memory and
download it to a TXT file.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

FechaI String ByVal 10 0 Search Initial Date in a
format DD/MM/AAAA
FechaF String ByVal 10 0 Search Final Date in a
format DD/MM/AAAA
ArchivoSalida String ByVal 255 0 Name of the TXT file
where the information is
going to be stored

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

47
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

ReleaseDLL32

Syntax:

Public Function ReleaseDLL32 () As Integer

Description:

This function visualizes the version of the 32 bits DLL PrnFiscalDLL32 of the
Fiscal Memory. Its function is for version control.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

48
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

RptX

Syntax:

Public Function RptX (_

ByVal DiaRptX As Byte, _
ByVal MesRptX As Byte, _
ByVal AnoRptX As Byte, _
ByVal HHRptX As Byte, _
ByVal MMRptX As Byte, _
ByVal SSRptX As Byte, _
ByVal AMPMRptX As Byte, _
Optional ByVal IDCajero As ASCIIZ _
) As Integer

Description:

Print the X Report. This is a NonFiscal Report and can be substituted by an own’s
application X Report.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

DiaRptX Byte ByVal 2 0 X Report’s Day
MesRptX Byte ByVal 2 0 X Report’s Month
AnoRptX Byte ByVal 2 0 X Report’s Year
HHRptX Byte ByVal 2 0 X Report’s Hour
MMRptX Byte ByVal 2 0 X Report’s Minute
SSRptX Byte ByVal 2 0 X Report’s Second
AMPMRptX Byte ByVal 1 0 AMPM of X Report (0=AM, 1=PM)
IDCajero ASCIIZ ByVal 20 0 Cashier’s Name (Optional)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

49
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

RptZ

Syntax:

Function RptZ (_
ByVal TipRptZ AS Byte, _
ByVal IDiaRptZ AS Byte, _
ByVal IMesRptZ AS Byte, _
ByVal IAnoRptZ AS Byte, _
ByVal FDiaRptZ AS Byte, _
ByVal FMesRptZ AS Byte, _
ByVal FAnoRptZ AS Byte,_
ByVal EDiaRptZ As Byte, _
ByVal EMesRptZ As Byte, _
ByVal EAnoRptZ As Byte, _
ByVal EHHRptZ As Byte, _
ByVal EMMRptZ As Byte, _
ByVal ESSRptZ As Byte, _
ByVal EAMPMRptZ As Byte _
) AS Integer

Description:

Prints the Z Report between date intervals. These are Fiscal Reports and are
intended to be used by the Seniat.
There are two types of reports:
- Summarized day by day: summarize all the Z Reports emitted in a day a prints
one Z for the whole day and for each day within the solicited range.
- Summarized month by month: summarize all the Z Reports emitted in a month
a prints one Z for the whole month and for each month within the solicited
range.
At the end of each type of report, prints a summarized totals of the solicited range.
Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

50
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Parameters:

Parameter Tipo Form Long. DEC. Description

Type of RptZ
TipRptZ Byte ByVal 1 0
1=Day by Day, 0=Month by Month
IdiaRptZ Byte ByVal 2 0 Beginning Day of Z Report
IMesRptZ Byte ByVal 2 0 Beginning Month of Z Report
IAnoRptZ Byte ByVal 2 0 Beginning Year of Z Report
FDiaRptZ Byte ByVal 2 0 Ending Day of Z Report
FMesRptZ Byte ByVal 2 0 Ending Month of Z Report
FAnoRptZ Byte ByVal 2 0 Ending Year of Z Report
EDiaRptZ Byte ByVal 2 0 Z Report’s Day
EMesRptZ Byte ByVal 2 0 Z Report’s Month
EAnoRptZ Byte ByVal 2 0 Z Report’s Year
EHHRptZ Byte ByVal 2 0 Z Report’s Hour
EMMRptZ Byte ByVal 2 0 Z Report’s Minute
ESSRptZ Byte ByVal 2 0 Z Report’s Second
EAMPMRptZ Byte ByVal 1 0 AMPM of Z Report (0=AM, 1=PM)

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

51
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

SearchJournalRange

Syntax:

Public Declare Function SearchJournalRange ( _

ByVal FechaI As String, _
ByVal FechaF As String, _
ByRef JournalRange As TJournalRange _
) As Integer

Description:

This function returns the upper and lower blocks from the Journal Memory next
to a given range date. This function is used with the function QryJournalBlock the
narrow or enclose the search within a range date. It’s is use is optative but is very useful
if combined with the functions QryJournalBlock, QryJournalDocument and
SearchJournalRange. For example: a range date can be chosen and the
SearchJournalRange will return the blocks range next to the dates (+/- un block),
QryJournalBlock will get this blocks and the QryJournalDocument function will let see
the information of an specific document within a block, all this displayed and in real
time directly from the fiscal printer.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters: None.

Parameter Tipo Form Long. Description

FechaI String ByVal 10 0 Search Initial Date in a
format DD/MM/AAAA
FechaF String ByVal 10 0 Search Final Date in a
format DD/MM/AAAA
JournalRange Record ByRef

Note: The record type is form by the TJournalRange structure:

Type TJournalRange
JrnBlkInf As Long
JrnBlkSup As Long
End Type

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

52
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

SearchLog

Syntax:

Public Function SearchLog () As Boolean

Description:

This function determines if historical transactions log is active.

Returning Values:

Type: Boolean (True, False)

True: Historical of transactions log is active
False: Historical of transactions log is not active

Parameters: None.

Parameter Tipo Form Long. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

53
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

SearchPrn

Syntax:

Function SearchPrn () As Integer

Description:

This function determines if the Fiscal Printer is On Line.

This function is for internal use by the DLL and it is exported like an aid to the
programmer.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

54
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

SetMsgErr

Syntax:

Function SetMsgErr (ByVal SetErr As Byte) As Integer

Description:

This function enables or disables the messages function of the DLL. If the messages
function is enabled, the DLL will show an message error windows for the DLL errors
and for the Fiscal Memory errors, on the other hand, the DLL will not visualize any
error message (With exception of disc errors related to the Log and parameters errors of
the SetMsgErr function). On any case all the functions will return an error code to the
POS for their handling in case that this it is required.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

SetErr ByVal Byte 1 0 0=Disabled, 1=Enabled

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

55
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

SetTimeOuts

Syntax:

Function SetTimeOuts(Timeout : Byte) : Byte;

Description:

This function set the timeout between the DLL and the fiscal printer. This timeout is
set by default in 2.
Note: Everytime the DLL starts, the timeout is reset to it’s default value. If you need
to change this value, you should do it everytime you start using the DLL.

Returning Values:

Type: Integer.
Result = 0: The operation was successful.
Result <> 0: The operation failure (See Error Codes Listing)

Parameters:

Parameter Tipo Form Long. DEC. Description

Default=2
Timeout ByVal Byte 1 0
Valid values = 0,…,255

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

56
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Diagram of Sequence of Functions

Fiscal documents (Invoices and Returns)

Init Create
Document

NewDoc

¿Cancel
Yes CancelTransaction
Document ?

No

¿Discounts
No NewItem Surcharges Yes OprDoc
Anulations ?

No
¿Close
Document ?

Si

CloseDoc

Print
Document

End Create
Document

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

57
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

NonFiscal Documents

Init Create
Document

NewDoc

¿Cancel
Yes CancelTransaction
Document ?

No

No
PrintTextNoFiscal

¿Close
Document ?

Yesi

CloseDoc

Print
Document

End Create
Document
Document

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

58
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Check Printing

Init Check Print

PrnChequeF
(Generate
)

¿Cancel
Yes CancelTransaction
Check ?

No

PrnChequeF
(Print )

Print Check

End Check Print

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

59
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Print Fiscal Reports

Init GenRptZ Init RptX Init RptZ

GenRptZ
Generates
( and RptX RptZ
Prints )

Print RptZ Print RptX Print RptZ

End GenRptZ End RptX End RptZ

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

60
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Fiscal Printer Queries

Init Query Init Query Init Quey

QueryPrnStatus QueryPrnMemory QueryPrnTransaction

End Query End Query End Query

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

61
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Error Codes Listing

DLL Errors

Msg [301] Error in Reception

Msg [302] Error in Transmission
Msg [303] Invalid command
Msg [304] Repeated Packaged
Msg [305] Fiscal memory does not respond
Msg [306] Error Opening the Historical Transactions Log
Msg [307] Error Recording in the Historical Transactions Log
Msg [308] Invalid Type of Report
Msg [309] TimeOut in Communication
Msg [310] Invalid Date format
Msg [311] Invalid Hour format
Msg [312] Closing error at the Historical Transactions Log
Msg [313] The Amount Cannot Be Zero
Msg [314] The Price Cannot Be Zero
Msg [315] The Amount Cannot to be Greater to 12 Digits
Msg [316] The Price Cannot be Greater to 12 Digits
Msg [317] Item ‘s Description Cannot Be Empty
Msg [318] Global Surcharge , payment types and Discount of Documents Cannot to be
Greater to 14 Digits
Msg [319] Length of Client’s Name Cannot Be Greater to 106 Characters
Msg [320] Invalid Operation Type
Msg [321] Invalid IVA Type
Msg [322] The Amount Cannot Be Zero
Msg [323] The Amount Cannot to be Greater to 12 Digits
Msg [324] Length of the Barcode Cannot Be Greater to 12 Digits
Msg [325] Operation’s Description Cannot Be In Empty
Msg [326] Length of Client’s ID Cannot Be Greater to 30 Characters
Msg [327] The Printer is Not Online
Msg [328] The Check’s Amount Cannot Be Zero
Msg [329] The Maximum Length of nonFiscal Text Is 38 Characters
Msg [330] The Check’s Amount Cannot be Greater to 12 Digits
Msg [331] The Check ‘s Amount In Letters Exceeds the 120 Characters
Msg [332] The Year‘s Validation Paramter is Optional and Only accepts Value 1
Msg [333] The Type of Report by Intervals Z Must Be Only 0 = Month to Month or 1=
Day to Day
Msg [334] Invalid Line Number
Msg [335] The Header ‘s Maximum Length is 38 Characters
Msg [336] The Payment Types Maximum Length is 15 Characters
Msg [337] The Products Item Maximum Length is 190 Characters
Msg [338] Invalid IVA length [Max. 2 integers and 2 Decimal]
Msg [339] Client’s Name Cannot Be Empty
Msg [340] Fiscal Memory ID Cannot Be Empty
Msg [341] Document Number Cannot Be Zero or Empty
Msg [342] The Initial Date Cannot Be Greater to the Final Date
Msg [343] The Cancellations/Surcharges’ Descriptions Maximum Length Is 190
Characters
Msg [344] Invalid Type of Check Process
Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4
Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

62
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Msg [345] The IVA Amount Cannot Be Empty

Msg [346] There is a Transaction In Process In the Fiscal Memory
Msg [347] Pay to the Order of Cannot Be Empty
Msg [348] Account Number Cannot Be Empty
Msg [349] Account Number Cannot Be Alphanumeric
Msg [350] Length of Account Number Must Be 10 Min and Max 72 Digits
Msg [351] To Account’s title Cannot Be Empty
Msg [352] Bank of Cuenta Cannot Be Empty
Msg [353] Historical Transactions Log Activated
Msg [354] Historical Transactions Log Deactivated
Msg [355] [Create|Delete] Transactions Log Error
Msg [356] Historical Transactions Log Erased
Msg [357] Historical Transactions Log does not exist in the PATH of the DLL
Msg [358] Parameter Buffer of PrintTextNoFiscal 0 Unbuffered, 1 Buffered
Msg [359] Invalid Type Document
Msg [360] The Allowed Rank of Consultation of RptZ in Memory is from 1 to 1825
Msg [361] Fiscal Memory ID Must Be of 10 Characters
Msg [362] Invalid Type Fonts
Msg [363] Length of Memory ID Cannot Be Greater to 10 Characters
Msg [364] Length of Pay to Order of Cannot Be Greater to 70 Characters
Msg [365] Length of Voucher Cannot Be Greater to 6 Characters
Msg [366] Length of Cashier’s Name Cannot Be Greater to 20 Characters
Msg [367] Length of Title’s Account Cannot Be Greater to 73 Characters
Msg [368] Length of Bank’s Account Cannot Be Greater to 70 Characters
Msg [369] The Serial Port is not Enabled
Msg [370] SetMsgErr Config Error, Only allows 0=Disabled, 1=Enabled
Msg [371] Function Win32 API Error
Msg [372] Invalid Configuration Bps Value 0=9600 Bps, 1=19200 Bps
Msg [373] Invalid Serial Port
Msg [374] Bps Configuration Error
Msg [375] Fiscal Memory fault at Internal Level or Electrical Energy
Msg [376] Licencia invalida. Comuníquese con su Proveedor
Msg [377] Número de Documento Invalido
Msg [378] Tipo de Documento Invalido
Msg [379] No se encuentra el Journal o no está Asociado con la Memoria Fiscal
Msg [380] Documento No Encontrado en el Journal en base a los Parámetros de
Búsqueda
Msg [381] Tipo de Código de Barra Inválido
Msg [382] Longitud de Código de Barra Inválido
Msg [383] El Archivo LicenciaPrnFiscal.txt no esta en el Directorio del DLL
Msg [384] Error de I/O en Apertura de Archivo LicenciaPrnFiscal.txt
Msg [385] Nombre de Arhivo de Salida del Journal no Puede Estar en Blanco
Msg [386] La Sintaxis de la Ruta y/o Nombre de Archivo de Salida No Es Valida
Msg [387] Error de I/O en Archivo de Salida del Journal
Msg [388] Error de I/O Por Reflexión o Circuiteria
Msg [389] El Archivo LicenciaPrnFiscal.txt No puede Tener Lineas en Blanco
Msg [390] Licencia Fiscal Verificada Satisfactoriamente
Msg [391] Los ID de la Memoria Fiscal y Journal no coinciden, solo se permiten
Consultas
Msg [392] Impresor Fiscal no Autenticado con la Memoria Fiscal
Msg [393] No se han Generado RptsZ en el Rango de Fecha Solicitado
Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4
Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

63
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Note:

1. The errors with the message “Without defining” will be used in future extensions of
the messages table.
2. The messages of the DLL begin in the 301 and ahead., those of the Fiscal Memory in
1 up to 255. The 256-300 range will be used in future versions of the Fiscal Memory
as required.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

64
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Fiscal Memory Errors

Msg [01] The Date Sent in the Command is Smaller to Last

Msg [02] There are no Pending Transactions To cancel
Msg [03] Numerical error in Arithmetical Operation
Msg [04] Error in the Parameters of the Command
Msg [05] The Configuration’s Parameter Limit is reached
Msg [06] Error of Paper by Exhaustion
Msg [07] The Command Cannot Be executed, There is a Transaction in Course
Msg [08] Empty Fiscal memory
Msg [09] Fiscal memory Full
Msg [10] Communication’s Error with the Fiscal Printer
Msg [11] Fiscal printer Not authenticated
Msg [12] The Check Has not been placed or the Information Has not been sent To print
it
Msg [13] The previous Command is in Course
Msg [14] There is a Check in Course
Msg [16] Error of Reading-Recording in Fiscal Memory (CRC Error)
Msg [249] Fiscal memory Processing Transactions
Msg [250] Error in Sequence of Packages
Msg [251] Error in Package’s Sequence Counter
Msg [252] Error In Head of Packages
Msg [253] Error of CRC in Package
Msg [254] Error of TimeOut in Package (2,5 Seconds)
Msg [255] Invalid Command Number

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

65
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

APPENDIX A

QueryPrnStatus Parameters Returns by Printer Model:

7197-F:

Slip status: 0x00 always. This printer does not support Slip Station.

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

66
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

7167-F:

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

67
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

A-721-F:

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

68
Summa Sistemas C.A. Dynamic Link Library PrnFiscalDLL32 Manual of Reference
Version 8.2 2016

Propiedad intelectual de Summa Sistemas C.A. RIF J-00089796-4

Prohibida su reproducción total o parcial o el uso de la información contenida sin autorización previa y expresa de Summa Sistemas C.A.

69