# Coupon Scanning
### Revision History
| Date | Description |
| ---------- | -------------------- |
| 03/04/2016 | Initial Release. |
| 09/15/2016 | Format Update. |
| 02/22/2022 | Cleaned up document. |
### Overview
#### Feature Description
The Coupon Scanning feature provides transaction-level support for scanning coupons at the Point of Sales (POS). It adds the ability to process scanned coupons and to automatically apply either a discount on a matching item or as a method of payment to the transaction.
A coupon is a promotional tool, in the form of a document, which can be redeemed for a discount to purchase goods or services.
The Coupon Families form is used to assign Price Look Up (PLUs) codes to a "family code" that appears on a coupon, even though the code does not appear in the PLU. After the code and PLU are associated in the Coupon Family form, the product with the associated PLU becomes eligible for the discount when the PLU and the coupon are scanned on the POS.
#### Supported Hardware Configuration
* Commander Site Controller with Topaz
* Commander Site Controller with Ruby2
* Commander Site Controller with C18
* RubyCi with Topaz
* RubyCi with Ruby2
## Configuring Coupon Scanning
### Configuring with Commander Configuration Client
From the Command Configuration Client, go to: Promo and Discounts > Coupon Config and Coupon Family.
The Coupon Scanning Configuration window displays.
#### **Site Parameters Tab**
{% stepper %}
{% step %}
Select the Site Parameters tab
{% endstep %}
{% step %}
Configure the Site parameters
| Value | Description |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Site Parameters | |
| Coupon Processing Level | Determines if coupon scanning is enabled or disabled. Transaction: Enables coupon scanning at the transaction-level only. Disabled: Disables coupon scanning. |
| Allow Negative Total | Allows coupons to result in a transaction total that is less than zero. By default, this option is not checked. |
| {% endstep %} | |
| {% endstepper %} | |
#### **Coupon Families Tab**
{% stepper %}
{% step %}
Select the Coupon Families tab
The Coupon Scanning configuration form displays.
{% endstep %}
{% step %}
Select \[Add] to configure a new coupon family
* Delete: Allows an existing coupon family to be deleted.
{% endstep %}
{% step %}
Configure the Coupon Family parameters
| Value | Description |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Coupon Families | |
| Code | Sets the coupon code. |
| Description | Describes the coupon family. |
| Manage PLUs | |
| PLU ID | Sets the PLU ID to associate with the Coupon Family. |
| Modifier | Enter the modifier with the PLU. If the entry is valid, a small yellow index card is displayed to the right of the modifier. Click on the index card to confirm the correct PLU was selected. If the PLU number cannot be validated, a black 'X' is displayed to the right of the modifier. |
| Add PLU | Associates the PLU ID with the Coupon Family. |
| Remove PLU | Removes the PLU from the Coupon Family. |
| {% endstep %} | |
{% step %}
Select \[Save] to accept, or \[Cancel] to exit without saving changes.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
All Coupon Family configuration is to be completed from the Config Client. The logic to process coupon family codes has not yet been implemented on the POS terminal.
{% endhint %}
## Using Coupon Scanning
In the below example, a customer is redeeming a $3.00 coupon. The screen display is the same regardless of how the coupon was entered (scanned or manually entered as MOP).
Regardless of the option level selected for each coupon presented, the customer display always displays a new line item with appropriate amount and a description of Coupon.
After applying scanned coupons for a transaction discount, the amount of each coupon displays in MOP, and displays the amount with the description of Coupon. Subsequent coupons applied display in the same manner with the most recent coupons.
On processing a coupon in a transaction, the coupons are printed at the MOP section of the receipt. A separate line is printed for each coupon accepted.
### Sales Functionality
If the coupon scanning feature is not enabled in the Commander Site Controller, then a message "Scanned Coupon - Coupon Scanning Disabled" displays. After all items are entered into a transaction, coupons may be scanned.
The following table lists the functions that occur and states whether the system or the clerk performs the function:
| Functions | System | Clerk |
| ------------------------------------------------------------------------------------------------------------------------- | ------ | ----- |
| Reject all scanned coupons when feature is disabled (displays "Coupon Scanning Disabled" message when coupon is scanned). | X | |
| Accept coupon entered as MOP in any transaction. | X | |
| Verify coupon is valid based on items in transaction. | | X |
| Present coupon to scanner. Check if coupon is expired (rejects expired coupons). | | X |
| Functions | System | Clerk |
| ------------------------------------------------------------------------------------------------------ | ------ | ----- |
| Add coupon to transaction when amount is determined in coupon's Value Code. | X | |
| Prompt clerk for amount when amount not expressly determined by Value Code (for example, BOGO offers). | X | |
| Enter coupon value when amount when prompted (based on Value Code). | | X |
### Transaction Flow
#### Valid Coupon Processing
The cashier must decide if a coupon may be applied to a transaction before scanning it. Once scanned, the system applies valid coupons (non-expired) at the transaction level.
{% hint style="info" %}
The system accepts valid and non-expired coupons only. The system does not check against items in the transaction and also does not impose any item-based restrictions while accepting coupons.
{% endhint %}
{% stepper %}
{% step %}
Enter \ into the transaction.
{% endstep %}
{% step %}
Scan the coupon.
* On scanning the first coupon, the prompt displays "SCANNED COUPON - ADDITIONAL ITEMS CANNOT BE ADDED AFTER COUPONS ARE SCANNED. CONTINUE? \[Y/N]."
* Select \[YES] to go to method-of-payment (MOP) mode to process the coupon.
* Select \[NO] to go back to subtotal level. The prompt "COUPON NOT PROCESSED" displays and ignores already scanned items.
{% hint style="info" %}
Once a coupon scan has started in a transaction, the user cannot add more items to that transaction. If the user still wants to add a coupon to the same transaction, then the user can scan the coupon or enter the coupon as an MOP.
{% endhint %}
* The system accepts the coupon amount from the coupon, and the coupon amount is applied as a transaction-level amount.
{% endstep %}
{% step %}
Continue to accept more coupons or tender the transaction.
{% endstep %}
{% endstepper %}
#### Expired Coupon Processing
Before scanning the coupon in a transaction, check the expiration date of the coupon and whether the accepted coupon is valid or not. Only valid coupons should be processed for a transaction discount.
To proceed with an invalid coupon in a transaction, do the following:
{% stepper %}
{% step %}
Enter items into the transaction.
{% endstep %}
{% step %}
Scan the coupon.
* If the coupon scanned is expired, then the system displays: "COUPON REJECTED - EXPIRED."
* If the coupon scanned is invalid, then the system displays: "COUPON NOT VALID WITH THIS TRANSACTION".
{% endstep %}
{% step %}
Continue to accept the remaining valid coupons or tender transaction.
{% endstep %}
{% endstepper %}
#### Valid Coupon with Offers Processing
A Coupon with offers is one whose value code requires additional information from the clerk.
For example, in a BOGO offer, when the consumer purchases one item and receives the second item as free, then the amount of that free item must be entered by the clerk.
Before scanning the coupon in a transaction, the cashier checks expiration date of the coupon and whether the accepted coupon is valid or not. Only valid coupons should be processed for a transaction discount.
To proceed with a coupon having offers in a transaction, do the following:
{% stepper %}
{% step %}
Enter \ into the transaction.
{% endstep %}
{% step %}
Scan the coupon.
* On scanning the first coupon, the prompt displays "SCANNED COUPON - ADDITIONAL ITEMS CANNOT BE ADDED AFTER COUPONS ARE SCANNED. CONTINUE? Y/N."
* Select \[YES] to go to method-of-payment (MOP) mode to process the coupon.
* Select \[NO] to go back to subtotal level and the prompt "COUPON NOT PROCESSED" displays and to ignore already scanned items.
* If the coupon scanned has an offer (for example, buy one, get one free), the system displays "Scanned Coupon - Verify required purchases. Enter value of the Coupon."
{% endstep %}
{% step %}
Enter the \ of the coupon.
{% endstep %}
{% step %}
Continue to accept the remaining valid coupons or tender transaction.
{% endstep %}
{% endstepper %}
## Reporting
For reconciliation purposes, non-scanned coupons should be kept separate from the scanned coupons because scanned coupons are reported differently from non-scanned coupons. Coupons that cannot be scanned are reported either as MOPs or as negative-department sales.
### Cashier & Summary Reports
Scanned coupons are not reflected in Sales MOP totals. They are reflected only in the coupon totals provided in the Memo Items section of the Cashier and Summary Reports.
#### **Memo Items**
Various transaction-related items have happened but they either do not affect totals or have already been counted in totals.
**Report Details**
* TITLE: CASHIER DETAILS REPORT.
**MEMO ITEMS**
* ITEMS: Quantity of items sold.
* CUSTOMERS: Number of customers (individual transactions).
* NO-SALES: Number of times the \[NO SALE] key has been pressed.
* VOID LINES: Number of times and total amount caused by using the \[VOID LINE] key. This does not include lines voided as part of a void ticket.
* VOID TICKETS: Number of times and total amount caused by using the \[VOID TICKET] key. This includes a line for positive amounts and a line for negative amounts.
* SCANNED COUPONS TICKET LEVEl: Coupon amounts applied to the entire transaction.
## Appendix
### Manufacturer's Coupons
The current manufacturer's coupons are GS1 (RSS) DataBar format, in the UCC/EAN-128 Extended format.
* UCC/EAN-128 Coupon Extended Code
* GS1 Databar (RSS) Coupon Code
### **UCC/EAN-128 Coupon Extended Code**
Many UCC/EAN-128 coupons are still being distributed and some with no expiration date. These coupons are still valid for redemption at the POS.
The UCC/EAN-128 format coupon consists of 10 digits with 5 as preceding digit.
#### **UPC Coupon Code Examples**
### **GS1 Databar (RSS) Coupon Code**
The GS1 Databar Coupon format provides manufacturers more options for purchase requirements and values and make it possible to code more complex offers.
#### **GS1 Databar Coupon Code Example**
### Value Code Table
A value code table consists of a two digit code that designates how the coupon is to be applied. It can indicate a specific amount or indicate that the clerk should be prompted to enter the amount.
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | ---------------------------------------- | ----------------- | ------------------ |
| 00 | Checker Intervention | | X |
| 01 | Free Merchandise | | X |
| 02 | Buy 4 or more, get 1 free (same product) | | X |
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | -------------------------------- | ----------------- | ------------------ |
| 03 | $ 1.10 | X | |
| 04 | $ 1.35 | X | |
| 05 | $ 1.40 | X | |
| 06 | $ 1.60 | X | |
| 07 | Buy 3 or more, get $ 1.50 off | | X |
| 08 | Buy 2 or more, get $ 3.00 off | | X |
| 09 | Buy 3 or more, get $ 2.00 off | | X |
| 10 | $ 0.10 | X | |
| 11 | $ 1.85 | X | |
| 12 | $ 0.12 | X | |
| 13 | Buy 4 or more, get $ 1.00 off | | X |
| 14 | Buy 1, get 1 free (same product) | | X |
| 15 | $ 0.15 | X | |
| 16 | Buy 2, get 1 free (same product) | | X |
| 17 | Reserved | | X |
| 18 | $ 2.60 | X | |
| 19 | Buy 3, get 1 free (same product) | | X |
| 20 | $ 0.20 | X | |
| 21 | Buy 2 or more, get $ 0.35 | | X |
| 22 | Buy 2 or more, get $ 0.40 off | | X |
| 23 | Buy 2 or more, get $ 0.45 off | | X |
| 24 | Buy 2, get $ 0.50 off | | X |
| 25 | $ 0.25 | X | |
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | ----------------------------- | ----------------- | ------------------ |
| 26 | $ 2.85 | X | |
| 27 | Reserved | | X |
| 28 | Buy 2, get $ 0.55 off | | X |
| 29 | $ 0.29 | X | |
| 30 | $ 0.30 | X | |
| 31 | Buy 2 or more, get $ 0.60 off | | X |
| 32 | Buy 2 or more, get $ 0.75 off | | X |
| 33 | Buy 2, get $ 1.00 off | | X |
| 34 | Buy 2 or more, get $ 1.25 off | | X |
| 35 | $ 0.35 | X | |
| 36 | Buy 2 or more, get $ 1.50 off | | X |
| 37 | Buy 3 or more, get $ 0.25 off | | X |
| 38 | Buy 3 or more, get $ 0.30 off | | X |
| 39 | $ 0.39 | X | |
| 40 | $ 0.40 | X | |
| 41 | Buy 3 or more, get $ 0.50 off | | X |
| 42 | Buy 3 or more, get $ 1.00 off | | X |
| 43 | Buy 2 or more, get $ 1.10 off | | X |
| 44 | Buy 2 or more, get $ 1.35 off | | X |
| 45 | $ 0.45 | X | |
| 46 | Buy 2 or more, get $ 1.60 off | | X |
| 47 | Buy 2 or more, get $ 1.75 off | | X |
| 48 | Buy 2 or more, get $ 1.85 off | | X |
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | ----------------------------- | ----------------- | ------------------ |
| 49 | $ 0.49 | X | |
| 50 | $ 0.50 | X | |
| 51 | Buy 2 or more, get $ 2.00 off | | X |
| 52 | Buy 3 or more, get $ 0.55 off | | X |
| 53 | Buy 2 or more, get $ 0.10 off | | X |
| 54 | Buy 2 or more, get $ 0.15 off | | X |
| 55 | $ 0.55 | X | |
| 56 | Buy 2 or more, get $ 0.20 off | | X |
| 57 | Buy 2, get $ 0.25 off | | X |
| 58 | Buy 2, get $ 0.30 off | | X |
| 59 | $ 0.59 | X | |
| 60 | $ 0.60 | X | |
| 61 | $ 10.00 | X | |
| 62 | $ 9.50 | X | |
| 63 | $ 9.00 | X | |
| 64 | $ 8.50 | X | |
| 65 | $ 0.65 | X | |
| 66 | $ 8.00 | X | |
| 67 | $ 7.50 | X | |
| 68 | $ 7.00 | X | |
| 69 | $ 0.69 | X | |
| 70 | $ 0.70 | X | |
| 71 | $ 6.50 | X | |
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | ----------- | ----------------- | ------------------ |
| 72 | $ 6.00 | X | |
| 73 | $ 5.50 | X | |
| 74 | $ 5.00 | X | |
| 75 | $ 0.75 | X | |
| 76 | $ 1.00 | X | |
| 77 | $ 1.25 | X | |
| 78 | $ 1.50 | X | |
| 79 | $ 0.79 | X | |
| 80 | $ 0.80 | X | |
| 81 | $ 1.75 | X | |
| 82 | $ 2.00 | X | |
| 83 | $ 2.25 | X | |
| 84 | $ 2.50 | X | |
| 85 | $ 0.85 | X | |
| 86 | $ 2.75 | X | |
| 87 | $ 3.00 | X | |
| 88 | $ 3.25 | X | |
| 89 | $ 0.89 | X | |
| 90 | $ 0.90 | X | |
| 91 | $ 3.50 | X | |
| 92 | $ 3.75 | X | |
| 93 | $ 4.00 | X | |
| 94 | Reserved | | X |
| Value Code | Description | Value Code Simple | Value Code Complex |
| ---------- | ----------------------------- | ----------------- | ------------------ |
| 95 | $ 0.95 | X | |
| 96 | $ 4.50 | X | |
| 97 | Reserved | | X |
| 98 | Buy 2 or more, get $ 0.65 off | | X |
| 99 | $ 0.99 | X | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.verifone.com/feature-references/feature-references/coupon-scanning.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.