FiscalPrinter.PrintRecVoidItem Method (String, Decimal, Decimal, FiscalAdjustment, Decimal, Decimal)

Cancels an item that has been added to the receipt and prints a void description.

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

Usage

'Usage
Dim description As String
Dim amount As Decimal
Dim quantity As Decimal
Dim adjustmentType As FiscalAdjustment
Dim adjustment As Decimal
Dim vatRate As Decimal
Dim fiscalPrinter1 As FiscalPrinter
fiscalPrinter1.PrintRecVoidItem(description, amount, quantity, adjustmentType, adjustment, vatRate)

Syntax

'Declaration
Overloads Public MustOverride Sub PrintRecVoidItem( _
    ByVal description As String, _
    ByVal amount As Decimal, _
    ByVal quantity As Decimal, _
    ByVal adjustmentType As FiscalAdjustment, _
    ByVal adjustment As Decimal, _
    ByVal vatRate As Decimal _
)
public abstract void PrintRecVoidItem(
    string description, 
    decimal amount, 
    decimal quantity, 
    FiscalAdjustment adjustmentType, 
    decimal adjustment, 
    decimal vatRate
);
public: abstract Void PrintRecVoidItem(
    String^ description, 
    Decimal^ amount, 
    Decimal^ quantity, 
    FiscalAdjustment^ adjustmentType, 
    Decimal^ adjustment, 
    Decimal^ vatRate
);
public abstract void PrintRecVoidItem(
    System.String description, 
    System.Decimal amount, 
    System.Decimal quantity, 
    FiscalAdjustment adjustmentType, 
    System.Decimal adjustment, 
    System.Decimal vatRate
);
public abstract function PrintRecVoidItem(
     description : String, 
     amount : Decimal, 
     quantity : Decimal, 
     adjustmentType : FiscalAdjustment, 
     adjustment : Decimal, 
     vatRate : Decimal
) : Void;

Parameters

  • description
    Text description of the item void.
  • amount
    Amount of item to be voided.
  • quantity
    Quantity of item to be voided.
  • adjustmentType
    Type of discount.
  • adjustment
    Amount of the discount/surcharge.
  • vatRate
    VAT rate amount.

Remarks

If amount is a positive number, it is printed as a negative and is decremented from the totals registers.

Fixed amount discounts/surcharges are supported only if CapAmountAdjustment is TRUE. Percentage discounts are supported only if CapPercentAdjustment is TRUE.

If CapOnlyVoidLastItem is TRUE, only the last item transferred to the fiscal printer can be voided.

PrintRecVoidItem is performed synchronously if AsyncMode is FALSE, and asynchronously if AsyncMode is TRUE.

PrintRecVoidItem returns void if successful, and can throw the following exceptions:

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 adjustments (see the CapAmountAdjustment property).

  • The printer does not support percentage discounts (see the CapPercentAdjustment 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.)

ExtendedErrorSlipEmpty

The slip station was specified, but a form is not inserted. (Only applies if AsyncMode is FALSE.)

ExtendedErrorBadItemAmount:

The amount is invalid. (Can be returned only if AsyncMode is FALSE.)

ExtendedErrorBadItemQuantity:

The quantity is invalid. (Can be returned only if AsyncMode is FALSE.)

ExtendedErrorBadVat:

The VAT information is invalid. (Can be returned only if AsyncMode is FALSE.)

ExtendedErrorBadItemDescription:

The description is too long or contains a reserved word. (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.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000

Target Platforms

See Also

Reference

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