--- title: "Internal Gift Cards - Setup and Configuration" canonical: "https://kb.myframeworks.com.au/space/FRAM/179011634/Internal%20Gift%20Cards%20-%20Setup%20and%20Configuration" format: markdown --- # Overview > Macro (excerpt-include) > ⚠️ This functionality is NOT feature-driven. > ℹ️ Configure security groups to manage user access to gift card functions based on role requirements. Refer to [Security Group Maintenance](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/28401628) for more information. Before gift cards can be used, the following system administration activities must be completed. --- # Internal Gift Card Processing This process allows you to configure internal gift cards to sell, register, redeem, and refund cards directly through Point of Sale (POS) and Sales Order Processing. To use internal gift cards, you'll need to configure the following: 1. [Set the Gift Card Number Length](#1-giftcardlength-table) 2. [Configure the Product Group for GL Posting](#2-product-group-maintenance) 3. [Create products to sell the Gift Cards](#3-product-maintenance) 4. [Define the Internal Gift Card tender type](#4-tender-types) 5. [Link the voucher type to the tender type](#5-gift-cards--vouchers) 6. [Register the Gift Cards](#GC-register) --- ## > Macro (anchor) 1. Gift Card Length (Optional) The **GIFTCARDLENGTH** code controls the valid gift card number length for card validation during registration and the sale processes. 1. Click the **Frameworks Menu** and navigate to **System Administration > System Setup > Configuration > System Settings - Integers** from the navigation tree. 2. Using the grid filter, find the **GIFTCARDLENGTH **code. 3. In the **Value** field, enter the required card number length. For example, **16** for sixteen-digit cards. 4. Click **Save**. Frameworks validates all card numbers against this length and produces the error message "Invalid Gift Card Number" when validation fails. --- ## > Macro (anchor) 2. Product Group Maintenance In **Product Group Maintenance**, configure the GL accounts for gift card sales and liability tracking. 1. Click the **Frameworks Menu** and navigate to **System Administration > System Setup > Inventory > Product Group Maintenance** from the navigation tree or search for **Product Group Maintenance**. 2. Create or identify the product group for gift cards (e.g., "GIFTCARD"). > ⚠️ **Important:** Ensure **Is Non Balanced Stock Group** is enabled on the **Product Group** you are allocating the Gift Card products to. 3. Configure the **GL Accounts**: - **Sales Account**: Set to your gift card liability account (e.g., 2150 - Gift Card Liability) - **Cost of Sales Account**: Set to nil or the same liability account - **Stock Account**: Not applicable for gift cards 4. Click **Save.** > ℹ️ **Note:** The Sales Account becomes the liability account. When a gift card is sold, the system credits this liability account. When redeemed, the tender type clearing account (also set to the same liability) is debited, reducing the liability. --- ## > Macro (anchor) 3. Product Maintenance In **Product Maintenance**, define products to sell fixed-value gift cards (e.g., $25, $50, $100) and variable-value gift cards. 1. Click the **Frameworks Menu** and navigate to **Inventory > Maintenance > Product Maintenance** from the navigation tree or search for **Product Maintenance**. 2. Click **New Product** to create the gift card products. 3. Enter the details. 4. Click **Save.** ![image-20251027-020614.png](media://7e0d8474-9abe-4965-b870-34b5e236d379) ### a. Fixed-Value Gift Cards Define the following **Key Details** when creating fixed-value Gift Card products (e.g., $25, $50, $100). - **Product ID**: Enter a product ID for the gift card (e.g., GC0025, GC0050, GC0100). - **Barcode**: Enter the barcode used on the gift card to allow scanning at POS, if required - **Product Type**: Select **Miscellaneous** from the drop-down menu to ensure the SOH isn't managed in Frameworks. > ⚠️ **Important:** Before creating the products, ensure **Is Non Balanced Stock Group** is enabled on the **Product Group** you are allocating the Gift Card products to. - **Product Description**: Enter a description to identify the card on transactions (e.g., Gift Card $50) - **Product Group**: Search and select the product group used for gift cards (configured in Step 2). - **GST Code**: Select **No GST** from the drop-down menu. - **Unit Sell GST Inc**: Enter the fixed value for the card (e.g., $50.00) ![image-20251027-021941.png](media://aab931f0-9cfc-4091-852b-a6a25444752d) ### b. Variable-Value Gift Cards Define the following **Key Details** when creating variable-value Gift Card products. This allows you to enter any amount when adding the product to a POS transaction. - **Product ID**: Enter a product ID for the gift card (e.g., GCVAR) - **Barcode**: Enter the barcode used on the gift card to allow scanning at POS. - **Product Type**: Select **Miscellaneous** from the drop-down menu to ensure the SOH isn't managed in Frameworks. > ⚠️ **Important:** Before creating the products, ensure **Is Non Balanced Stock Group** is enabled on the **Product Group** you are allocating the Gift Card products to. - **Product Description**: Enter a description to identify the card (e.g., Gift Card Variable Value). - **Product Group**: Search and select the product group used for gift cards (configured in Step 2). - **GST Code**: Select **No GST** from the drop-down menu. - **Unit Sell GST Inc**: Enter **$0.00** to allow operator entry at POS. ![image-20251027-022951.png](media://7f6e2b65-af9c-4bf7-8216-e74095ba4254) --- ## > Macro (anchor) 4. Tender Types In **Tender Types**, configure the tender type for the gift cards to be sold and redeemed across POS, Sales Order Processing, and Customer Payments. 1. Click the **Frameworks Menu** and navigate to **System Administration > System Setup > Tendering > Tender Types** from the navigation tree or search for **Tender Types**. 2. Click **New** to create the tender type. 3. Enter the details: - **Code**: Enter a code (e.g., "INTGC"). - **Description**: Enter "Internal Gift Card." - **Integration via**: Select **Internal Gift Card** from the drop-down menu. **Note:** Internal gift cards are managed completely within your Frameworks system, acting like store credit. They don’t require third-party integration, APIs, or fees like external gift cards. This makes them simpler to use, with your staff controlling everything from registration to refunds. - **Clearing Account**: Set to your gift card liability account (e.g., 2150 - Gift Card Liability) 4. Configure additional tender type settings as required (payment processing options, till reconciliation settings, and receipt printing options). 5. Click **Save.** > ⚠️ **Important:** The Clearing Account must match the Sales Account in your Gift Card Product Group for proper liability reduction. ![image-20251027-064040.png](media://04712baf-e906-4615-b648-1bcc68b8ed82) > ✅ Refer to [https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/28385410](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/28385410) for more information about Tender Types. --- ## > Macro (anchor) 5. Gift Cards & Vouchers In the **Gift Cards & Vouchers** maintenance screen, define the card type and products that will be recognised as gift cards when sold via Point of Sale. Define each gift card product you plan to sell here to ensure proper recognition at the point of sale. 1. Click the **Frameworks Menu** and navigate to **System Administration > System Setup > Tendering > Gift Cards & Vouchers** from the navigation tree, or search for **Gift Cards & Vouchers**. 2. Click **New** to create the voucher type. 3. Enter the details: - **Voucher Type**: Select **Internal Gift Card** from the drop-down menu. - Select the **Product **(gift card previously created in Product Maintenance). - **Integrate via**: Select **Internal Gift Card** 4. Enable the **Fixed Value? **Checkbox if the product selected is for a fixed-value gift card. Leave disabled if the product selected is for a variable-value gift card. 5. Click **Save.** ![image-20251027-064315.png](media://44dbb498-1433-4d0b-8e05-9502e6909d22) --- ## > Macro (anchor) 6. Gift Card Registry Before gift cards can be sold, they must be registered in the **Gift Card Registry**. This registry ensures unique card validation and prevents duplicate sales. **Navigation Path**: System Administration > System Setup > Tendering > Gift Card Registry Cards can be registered manually (entering card numbers and values individually) or imported in bulk. Set cards as "New" for registration or "Pre-Existing" for legacy cards with existing balances. ![image-20251027-085759.png](media://6b903845-b0d1-4bbc-af76-eec84a7ec6f2) > ✅ Refer to [https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/192446477](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/192446477) for more information about registering gift cards for sale. --- # Additional Information > ✅ Refer to [Getting Started with Internal Gift Cards](https://sterlandsupport.atlassian.net/wiki/spaces/FRAM/pages/179011627) for more information about internal gift cards.