Vouchers (discounts) - residual value management

by ACRIS E-Commerce GmbH

Premium Extension

Rating: 5.0

(2 reviews)

Downloads: 133

With this plugin you can redeem (coupons (discounts) even below the actual value. The not redeemed residual value can be redeemed with a further purchase.

Annually €16.58* /month €238.80 * €199.00* /year 16.67% discount In comparison to the regular monthly price

Monthly €19.90* /month Cancelable monthly

Compatible with:

6.3.0.0 - 6.7.5.1

Includes:

Free trial month

The subscription starts with a free trial month during which it can be canceled at any time.

All updates

During the subscription all released updates are included for free

Support from the Extension Partner

In case you have any questions or problems with your extension you can always ask the Extension Partner for help during the subscription.

Description

Highlights

Flexible creation of individual vouchers with your own designs
Automatic generation of a PDF voucher after purchase
Integrated residual value utilisation for partially redeemed vouchers

Features

Multiple designs per voucher freely configurable
Customisable greeting message and voucher code
Enter a personal greeting message on the product page
Support for absolute and percentage discounts via custom voucher codes
Clear management of all generated vouchers in the admin area

About the Extension

Purpose of the plugin

Shopware offers basic voucher and discount functions as standard, but does not offer the option to create fully personalised vouchers or automatically reuse remaining values after partial redemption.

To close these gaps, we have developed a plugin that expands the entire process surrounding voucher sales:

Flexible creation of individual vouchers with your own designs
With the integrated design tool, shop operators can create and design their own voucher templates. Background images, fonts, positions and formats of voucher codes and greeting messages can be freely defined. In addition, several designs can be created per voucher so that customers can select a suitable template in the front end.
Buyers can also personalise the voucher themselves: directly on the product page, they can enter their own greeting message, which will later appear on the PDF voucher.

Automatic generation of a PDF voucher after purchase

As soon as a voucher has been ordered, the plugin automatically generates a PDF document with all the individual details. This contains the selected motif, the personal message and the valid voucher code. The process is fully automated, without any additional effort on the part of the shop operator.
A clear list of all generated vouchers is available in the admin area, including information such as order, customer, code and status.

Flexible discount logic and integrated residual value management

The plugin supports both absolute and percentage discounts, which can be defined via individual voucher codes. Each discount can be assigned to one or more vouchers. If a voucher is only partially used, the integrated residual value function automatically calculates the remaining amount. This residual value is credited to the respective voucher code and can continue to be used for future purchases.

Details

Available: English, German
Latest update: 9 December 2025
Publication date: 28 October 2020
Version: 5.2.2
Category: Promotions & Voucher

Resources

Reviews (2)

Average rating

5.0

Based on 2 reviews

5.0 Functionality

5.0 Usability

5.0 Documentation

5.0 Support

Write a review

If you downloaded this extension you can write a review in the Shopware Account.

Write a review

Sort by

Restwertverwaltung klappt, Rabatt auf Warenkorb & Versandkosten anwendbar und 1A Support

5.0

by Kaja Schäferhoff | limmaland.com

17 October 2023 09:36

5.0 Functionality

5.0 Usability

5.0 Documentation

5.0 Support

Einwandfreie Funktionalität und lobenswerte Support

5.0

by Hans Jung

19 January 2022 10:50

Genau die App die wir für unsere Aktionen gesucht haben!
Nach einspielen eines Backups gab es ein kleines Problem, welches
aber umgehend gelöst wurde. Top Erweiterung und Top Support

5.0 Functionality

5.0 Usability

5.0 Documentation

5.0 Support

About the Extension Partner

ACRIS E-Commerce GmbH

See all extensions

Partner Status

Shopware
Bronze Partner
Shopware
Premium Extension Partner

Details

Ø-Rating: 5

Average rating of 5 out of 5 stars
Partner since: 2015
Extensions: 168

Support

Based in: Austria
Speaks: German, English
Response time: Very quickly

Installation

Open Plugin Manager via Settings > System > Plugins.
Upload, install and activate the plugin.

Plugin configuration

Settings > Extensions > Vouchers > Configure

Sales channel
Select the sales channels for which the voucher functions should be active.
Display voucher code entry on the order confirmation page
Activates an input field where the customer can enter a voucher code
Allow multiple use of the same promotion with different individual codes
If activated, customers can redeem multiple individual voucher codes from the same promotion in their shopping basket.
Maximum number of vouchers per email
If more vouchers are ordered than specified here, the system will send multiple emails.

Create discount

Marketing > Discounts & Promotions > Create Promotion

Set the name, priority, validity and usage limits as usual.
Under Promotion codes, select the promotion code type Individual promotion codes.
Generate codes automatically or add them manually.
Specify whether remaining values can continue to be used or expire.
Define the desired discount under the ‘Discounts’ tab.

Create voucher product

Catalogues > Products > Create product

Create voucher as a normal product (this product serves as a ‘purchase voucher’ display in the front end)
Product price must correspond to the voucher value.
Assign the desired voucher under Purchase voucher.

Create voucher

Settings > Extensions > Purchase vouchers > Purchase vouchers > Create voucher

Basic settings

Internal ID
Unique technical name of the voucher
Internal name
Name for the admin area
Active
Switches the voucher on or off
Priority
Determines the order when multiple vouchers are available.
File name
Generated automatically (e.g. 10001_0194f3b12fba720eaf9a7be7bbe69f02.pdf). Optionally, a prefix and/or suffix can be added.

Motifs

Several motifs can be stored for each voucher, which the customer can select in the front end:

Internal ID: technical identifier
Internal name: name in the admin area
Name for display: visible motif name in the front end
Active: controls whether the motif is available
The background image, page format, design and positioning of the voucher code and greeting message can be specified individually for each motif.

Assignment to voucher discount promotion

Select voucher discount promotion
Only discount promotions that use the promotion type ‘Individual promotion codes’ are displayed.
Code pattern
Defines the format of the automatically generated voucher codes.

Assignment to products

Select one or more products for which the voucher will be sold in the frontend

Manage vouchers in the admin

Settings > Extensions > Purchase vouchers > Generated vouchers

The overview displays the following:

PDF file of the voucher
Order
Customer
Assigned discount promotion
Individual voucher code
Remaining value
Creation date

Residual value management

If a voucher is only partially redeemed, the following happens:

The remaining amount is calculated automatically
The residual value is credited to the existing voucher code
The code can continue to be used for future orders
If the additional field is activated in the discount promotion, residual values can expire automatically

Is it possible to export and import residual values via the Shopware file import/export?

Yes. For this, an import/export profile based on the object type "Promotion Codes" can be created. In the mapping, at least the following two additional fields must be specified to successfully import residual values: "acrisVoucherValue.currencyShortName", "acrisVoucherValue.value".

Can residual values be retrieved via the Shopware API?

Yes, here is an example call via the Shopware API. The "acrisVoucherValue" field describes the current residual value of the respective voucher code. The order history is stored in the "acrisVoucher" field. The UUID in the filter refers to the UUID of the Shopware promotion. GET /api/search/promotion

{
    "page": 1,
    "limit": 1,
    "total-count-mode": 1,
    "filter": [
        { "type": "equals", "field": "id", "value": "01946eeb49647a7b9403ad92db5b44af" }
    ],
    "associations": {
        "individualCodes": {
            "associations": {
                "acrisVoucherValue": { },
                "acrisVoucher": { }
            }
        }
    }
}

Can residual values be inserted or updated via the Shopware API?

Yes, here is an example call via the Shopware API. The residual value is saved in the "acrisVoucherValue" field. POST api/_action/sync

[
    {
        "action": "upsert",
        "entity": "promotion",
        "payload": [
            {
                "id": "01946eeb49647a7b9403ad92db5b44af",
                "individualCodes": [
                    {
                        "id": "0195a2dc731570c9a52543efc55a0ae8",
                        "code": "1234-ryup",
                        "payload": {
                            "orderId": "43ac798eb693489faadf21f6078c65bc",
                            "customerId": "d8152b80810b436ba20056b29833cf4b",
                            "customerName": "Firstname Lastname"
                        },
                        "acrisVoucherValue": {
                            "id": "0195a2e340827136bbde5544ef86b35e",
                            "value": 7.12,
                            "currencyShortName": "EUR"
                        }
                    }
                ]
            }
        ]
    }
]

The 1st UUID (01946eeb49647a7b9403ad92db5b44af) refers to the Shopware promotion (DB table promotion). The 2nd UUID (0195a2dc731570c9a52543efc55a0ae8) refers to the Shopware Individual Code (DB table promotion_individual_code). The 3rd UUID (0195a2e340827136bbde5544ef86b35e) refers to the ACRIS residual value entry (DB table acris_promotion_code_value). The fields "orderId" and "customerId" in the payload are optional. If filled, a connection can be established with the Shopware customer (UUID of the customer) and the Shopware order (UUID of the order).