Description:

yjy fiscal printer

Fiscal Printer #
In order to easily interface with different brands of fiscal printers and use their same functions, this module defines a unified interactive data structure and interfaces. By implementing these interfaces to interact with a certain certain brand of fiscal printer.
Interactive data structure #
Fiscal.Receipt



Name
Desc




operator
to identify the operator


sales
sale items or cancel sale items


lottery
national lottery unique customer code


personalTaxCode



refunds
refund items or cancel refunds


subtotals



payments



barCode



qrCode



graphicCoupon



openDrawer




Fiscal.Report



Name
Desc




type
report type: daily financial report or daily fiscal closure or both


operator



timeout



openDrawer




Fiscal.Cancel



Name
Desc




type
void or redund


zRepNum
daily fiscal closure report number


docNum
document number


date



fiscalNum
fiscal serial number of the printer


operator




Fiscal.Command



Name
Desc




code
command type


data
data required by the command



Commands



Command
Desc
Support




OPEN_DRAWER
value: 0, open drawer
Epson / Custom


QUERY_PRINTER_STATUS
value 1, query printer status
Epson / Custom


RESET_PRINTER
value 2, reset printer
Epson / Custom


GET_NATIVE_CODE_FUNCTION
value 3, use printer native code command
Epson / Custom


GET_INFO
value 4, get printer device info
Custom Only



Interfaces #



Epson
Custom




printFiscalReceipt(receipt: Fiscal.Receipt)
printFiscalReceipt(receipt: FPrinterCustom.Receipt)


printFiscalReport(report: Fiscal.Report)
printFiscalReport(report: FPrinterCustom.Report)


printCancel(cancel: Fiscal.Cancel)
printCancel(cancel: FPrinterCustom.Cancel)


executeCommand(...commands: Fiscal.Command[])
executeCommand(...commands: FPrinterCustom.Command[])



Usage #

Epson Fiscal ePOS-Print XML Examples

// Create a client
final fprinter = new EpsonXmlHttpClient(epson.Config(
host: '192.168.1.1',
deviceId: 'local_printer',
timeout: 10000
));

// Fiscal receipt
await fprinter.printFiscalReceipt(epson.Receipt(
sales: [
epson.Sale(
type: Fiscal.ItemType.HOLD,
description: 'A',
quantity: 1,
unitPrice: 5
),
epson.Sale(
type: Fiscal.ItemType.HOLD,
description: 'B',
quantity: 2,
unitPrice: 2.5
),
epson.Sale(
type: Fiscal.ItemType.HOLD,
description: 'C',
quantity: 3,
unitPrice: 3
),
],
payments: [
epson.Payment(
description: 'Payment in cash',
payment: 19
)
]
));

// Fiscal Report
await fprinter.printFiscalReport(epson.Report(
type: Fiscal.ReportType.DAILY_FISCAL_CLOUSE,
));
copied to clipboard

Custom Protocol Examples
Note: unit quantity multiplied by 1000, unit price multiplied by 1000, include the discount, payment

// Create a client
const fprinter = new CustomXmlHttpClient(custom.Config(
host: '192.168.1.1',
fiscalId: 'STMTE500432', // 11 digits
));

// Fiscal receipt
await fprinter.printFiscalReceipt(custom.Receipt(
sales: [
custom.Sale(
type: Fiscal.ItemType.HOLD,
description: 'A',
quantity: 1 * 1000,
unitPrice: 5 * 100
),
custom.Sale(
type: Fiscal.ItemType.HOLD,
description: 'B',
quantity: 2 * 1000,
unitPrice: 2.5 * 100
),
custom.Sale(
type: Fiscal.ItemType.HOLD,
description: 'C',
quantity: 3 * 1000,
unitPrice: 3 * 100
),
],
payments: [
custom.Payment(
description: 'Payment in cash',
payment: 19 * 100,
paymentType: 1
)
]
));

// Fiscal Refund
// step 1 request to make sure the annulment is possible, if responseBuf === 1 then execute step 2
await fprinter.printCancel(custom.Cancel(
docRefZ: '0021',
docRefNumber: '0034',
docDate: '011022', // DDMMYY
printPreview: CustomProtocol.EnableType.DISABLE,
fiscalSerial: 'STMTE500432',
checkOnly: CustomProtocol.EnableType.ABLE,
codLottery: 'ASDSFES7',
));

// step 2 to proceed with the actual void request
await fprinter.printCancel(custom.Cancel(
docRefZ: '0021',
docRefNumber: '0034',
docDate: '011022', // DDMMYY,
printPreview: CustomProtocol.EnableType.DISABLE,
fiscalSerial: 'STMTE500432',
checkOnly: CustomProtocol.EnableType.DISABLE,
codLottery: 'ASDSFES7',
));

// Fiscal Report
await fprinter.printFiscalReport(custom.Report(
type: CustomProtocol.ReportType.DAILY_FISCAL_CLOUSE,
));

// Fiscal Command
await fprinter.executeCommand([custom.Command(
code: CustomProtocol.CommandCode.OPEN_DRAWER
)]);
copied to clipboard
Implemented #



Epson
Custom




Fiscal ePOS-Print XML

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter