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

Article
04/25/2017

3/2/2014

Applies and prints a discount or surcharge to the current receipt subtotal.

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

Syntax

'Declaration
Public MustOverride Sub PrintRecSubtotalAdjustment ( _
    adjustmentType As FiscalAdjustment, _
    description As String, _
    amount As Decimal _
)

public abstract void PrintRecSubtotalAdjustment (
    FiscalAdjustment adjustmentType,
    string description,
    decimal amount
)

public:
virtual void PrintRecSubtotalAdjustment (
    FiscalAdjustment adjustmentType, 
    String^ description, 
    Decimal amount
) abstract

public abstract void PrintRecSubtotalAdjustment (
    FiscalAdjustment adjustmentType, 
    String description, 
    Decimal amount
)

public abstract function PrintRecSubtotalAdjustment (
    adjustmentType : FiscalAdjustment, 
    description : String, 
    amount : decimal
)

Parameters

adjustmentType
Type of discount.

description
Text describing the discount.

amount
Amount of the discount.

Remarks

This discount or surcharge can be either a fixed currency amount or a percentage amount relating to the current receipt subtotal.

If the discount or surcharge amount is greater than the receipt subtotal, an error occurs because the subtotal cannot be negative.

In many countries or regions, discount or surcharge operations cause the printing of a fixed line of text expressing the kind of operation that has been performed.

Fixed amount discounts are supported only if CapSubAmountAdjustment is true.

Percentage discounts are supported only if CapSubPercentAdjustment is true.

PrintRecSubtotalAdjustment is performed synchronously if AsyncMode is false, and asynchronously if AsyncMode is true.

PrintRecSubtotalAdjustment 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.)
Illegal	One of the following errors occurred: The printer does not support fixed amount discounts (see the CapSubAmountAdjustment property). The printer does not support percentage discounts (see the CapSubPercentAdjustment property). The adjustmentType parameter is invalid.
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 discount amount is invalid. (Can be returned only if AsyncMode is false.)
ExtendedErrorBadItemDescription	The discount description is too long or contains a reserved word. (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.

Share via

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

Syntax

Parameters

Remarks

Thread Safety

See Also

Reference

Additional resources