Skip to content

Third-Party Integrations

The Third-Party Integrations group controls how amounts from third-party modules (e.g. gift cards, store credit, reward points) are handled in the electronic invoice.

Gift cards (Aheadworks_Giftcard)

Redeemed gift cards are treated as a prepaid amount (BT-113). In the backend, the group carries the name of the supported gift card module.

Gift Card Integration
Gift cards (Aheadworks_Giftcard)
  • Process Gift Cards (third_party_integrations/giftcard/enabled, default: No, BT-113): Includes redeemed gift cards as a prepaid amount. The tax is calculated on the full amount; the gift card reduces the amount due for payment (BT-115).
  • Show gift card reference in invoice (giftcard/show_reference_note, default: Yes): Adds a note with gift card code(s) and amount to the invoice. Visible when processing is enabled.
  • VAT category for gift cards (giftcard/vat_category, default: E): VAT treatment of purchased gift cards (product types aw_giftcard, giftcard). Multipurpose vouchers are usually VAT-free at purchase; VAT is only due upon redemption.
  • Exemption Reason (giftcard/exemption_reason, default: Multipurpose Voucher, BT-120): Reason for the VAT exemption. Mandatory for the categories E (exempt) and O (out of scope); only then visible.

A distinction must be made between a gift card redeemed as a means of payment (prepaid amount BT-113, reduces the amount due) and a multipurpose voucher purchased as a product (its own VAT treatment via the category). Background details under Vouchers & Prepayments.

Custom modules for store credit, reward points or discounts can be connected via adapter interfaces – see Developer.