Share via

FiscalPrinter.PrintRecSubtotal Method (POS for .NET v1.14 SDK Documentation)

  • Article

3/2/2014

Checks and prints the current receipt subtotal.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride Sub PrintRecSubtotal ( _
    amount As Decimal _
)

public abstract void PrintRecSubtotal (
    decimal amount
)

public:
virtual void PrintRecSubtotal (
    Decimal amount
) abstract

public abstract void PrintRecSubtotal (
    Decimal amount
)

public abstract function PrintRecSubtotal (
    amount : decimal
)

Parameters

  • amount
    Amount of the subtotal.

Remarks

If the CapCheckTotal property is true, the amount value is compared to the subtotal calculated by the printer. If the subtotals match, the subtotal is printed on both the receipt and journal. If the results do not match, the receipt is automatically canceled. If the CapCheckTotal property is false, the subtotal is printed on the receipt. In this case, the amount value is never compared to the subtotal computed by the printer.

PrintRecSubtotal is capable of asynchronous processing. It is performed synchronously if AsyncMode is false, and asynchronously if AsyncMode is true.

If PrintRecSubtotal compares the application’s subtotal with the printer’s subtotal and they do not match, the PrinterState property is changed to FiscalReceiptEnding.

PrintRecSubtotal may cause a PosControlException to be thrown with one of the following values:

Value

Description

Busy

Cannot perform while output is in progress. (Can be returned only if AsyncMode is false.)

ExtendedErrorWrongState:

The printer is not in the FiscalReceipt state.

ExtendedErrorCoverOpen:

The printer cover is open. (Can be returned only if AsyncMode is false.)

ExtendedErrorJournalEmpty:

The journal station is out of paper. (Can be returned only if AsyncMode is false.)

ExtendedErrorReceiptEmpty:

The receipt station is out of paper. (Can be returned only if AsyncMode is false.)

ExtendedErrorBadItemAmount:

The description is too long or contains a reserved word. (Can be returned only if AsyncMode is false.)

ExtendedErrorBadItemAmount:

The subtotal from the application does not match the subtotal computed by the printer. (Can be returned only if AsyncMode is false.)

ExtendedErrorNegativeTotal:

The total computed by the printer is less than zero. (Can be returned only if AsyncMode is false.)

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

FiscalPrinter Class
FiscalPrinter Members
Microsoft.PointOfService Namespace
FiscalPrinter.BeginFiscalReceipt Method
FiscalPrinter.EndFiscalReceipt Method
AmountDecimalPlaces
FiscalPrinter.PrintRecCash Method
PrintRecItem
PrintRecItem
PrintRecItemAdjustment
FiscalPrinter.PrintRecItemAdjustment Method
PrintRecItemFuel
PrintRecItemFuel
PrintRecItemFuelVoid
FiscalPrinter.PrintRecItemFuelVoid Method
FiscalPrinter.PrintRecMessage Method
FiscalPrinter.PrintRecNotPaid Method
PrintRecPackageAdjustment
PrintRecPackageAdjustVoid
PrintRecRefund
FiscalPrinter.PrintRecRefund Method
PrintRecRefundVoid
FiscalPrinter.PrintRecRefundVoid Method
PrintRecSubtotalAdjustment
PrintRecSubtotalAdjustVoid
PrintRecTaxId
PrintRecTotal
PrintRecVoid