User Guide
  • Intro
    • Welcome
      • About DotApparel
      • What is DotApparel?
      • Where is it hosted?
      • What platform(s) do we support?
      • How does syncing work?
      • Solution architecture
      • Definition of “Instance”
      • Security Overview
    • Implementation
      • Google Cloud and Firebase
  • Quick Links
  • Core
    • Overview
    • Dashboard
    • Orders
      • Mappings
      • Integrations
    • Returns
      • Mappings
    • Products
      • Mappings
        • Default mapping rules
      • Translations
      • Markets
      • Publishing products
    • Inventory
      • Mappings
        • Examples
          • Ignore Sync
          • Inventory Buffer
          • Keep Items Sold Out
          • Unlimited Inventory
    • Customers
    • Rewards
    • System Alerts
    • Settings
      • Shopify Locations, DotApparel Locations and Inventory Buffers
      • ERP credentials
      • Product images
      • Fulfillments
      • Payment gateways
      • Gift cards
      • Refunds
      • Notifications
      • Harmony Integration with DotApparel
    • Modules
      • Ship From Store
      • Local Pickup/Click & Collect
      • Shopify Markets
      • Returns
        • Australia Post (AusPost)
        • Loop Returns
      • Auto-Refunds
        • Refunding Shopify Orders from POS (In-Store)
      • Integrate with Brauz (app)
      • Integrate with The Wishlist (app)
    • Release Notes
    • Troubleshooting
      • FAQs
      • How to raise a support ticket for an issue
      • Good and bad examples of a problem ticket
      • Want to enable a new omnichannel feature?
      • Want to integrate a marketplace using DotApparel?
  • Customers
    • Overview
      • Email Examples
    • Getting Started
      • Understanding Customer Setup in your ERP
      • Data Sync
      • Configuration
      • Testing
    • Data Export Approaches
      • Option A: Consultant
      • Option B: In-House
    • Apparel21 Export Templates
    • Apparel21 Export Changelog
    • Dashboard
    • Customers
    • Orders
    • Translations
    • Mappings
    • Settings
    • Support
  • Loyalty
    • Overview
    • Getting Started
      • Terminology
    • Data Sync
      • Workflows
    • Front-End Implementation
    • Rewards Redemption
    • Rewards Emails
    • Things To Know
Powered by GitBook
On this page
  • Purchase ERP Vouchers Online
  • Redeeming ERP Vouchers
  • Avoiding fraudulent redemptions
  • Step By Step Guide (High-Level)
  • What fields does we need to configure the ERP Gift Vouchers within DotApparel Core?
  • Where do I find this voucher information in the ERP?

Was this helpful?

Export as PDF
  1. Core
  2. Settings

Gift cards

PreviousPayment gatewaysNextRefunds

Last updated 9 months ago

Was this helpful?

Purchase ERP Vouchers Online

The purchasing of a voucher works much like any other product in the ERP. The difference is that on the product detail page, the customer is presented with a form, which captures additional information to pass on to the ERP with the purchase. These attributes are stored as line item properties in Shopify, which are then passed on to the ERP.

In the DotApparel settings section, you will find a gift card section, which allows you to define a Shopify SKU pattern, alongside the type of gift card and the ERP SKU. This allows you to configure a product in Shopify, which has multiple variants to represent each voucher amount, but map all the SKUs to a single voucher SKU in the ERP.

When a customer purchases a voucher in Shopify, it is treated as an ordinary product purchase, except the additional information like the recipient email, is also passed to the ERP. It is then up to the ERP to generate the voucher number and PIN and send an email to the customer containing that information.

If you would like to customise the email which is sent to the customer when a voucher is generated, you should get in touch with the ERP.

Redeeming ERP Vouchers

DotApparel allows ERP Vouchers to be redeemed with a checkout extension that can be installed on Shopify Plus checkouts.

Once our team has installed the Gift Card checkout extension, customers will be able to see the ERP voucher number and voucher PIN fields.

When the customer completes this form, a live request is made to the ERP to check the current balance of the voucher and obtain a validation ID. A temporary Shopify gift card is then created for the value of the ERP voucher, allowing it to be redeemed against the Shopify order.

When the order is posted to the ERP, DotApparel swaps out the Shopify gift card information with the ERP voucher information, thus triggering the ERP to redeem the voucher internally.

Avoiding fraudulent redemptions

Many merchants ask how we avoid customers redeeming vouchers twice. Let’s say the customer has a cart already filled on the website, applies the voucher, but then goes to buy something in-store with the same voucher, before checking out online.

In this case, DotApparel does not apply any sort of special locking or validation to the vouchers. The web order will still be posted to the ERP and accepted in Shopify. However, when the ERP internally tries to redeem the voucher, the posting will fail, saying that the voucher has already been redeemed at POS. In this scenario, you should treat the order as fraudulent, and cancel it in Shopify.

Step By Step Guide (High-Level)

Steps
Responsibility

Make sure the ERP gift voucher is configured in the ERP

Merchant

Merchant

Upgrade to checkout extensibility

Front-End

Configure the ERP Gift Vouchers in the DotApparel Core app

DotApparel

Test the ERP Gift Voucher and check that you can purchase from the PDP. Then place another order to use that the ERP Gift Voucher to redeem at checkout ⚠️ If it's a new ERP Gift Voucher, we recommend to test on a Shopify staging store ⚠️ If you're upgrading your Shopify checkout, you can test it straight on the Shopify production store

Merchant

[Applicable if tested on staging store] Once approved on a Shopify staging store, front-end to upgrade the production Shopify store to checkout extensibility. ⚠️ The DotApparel team MUST be informed the day & time of the checkout upgrade deployment

Front-End

DotApparel team to install the Gift Voucher checkout UI Extension after which point, the ERP Gift Voucher # & 4-digit pin field will now be visible at checkout. Thereby, allowing for the ERP Gift Voucher redemption

DotApparel

What fields does we need to configure the ERP Gift Vouchers within DotApparel Core?

  • ERP voucher SKU ID (i.e., 12345)

  • ERP voucher type (i.e., Email AU)

  • Shopify SKU pattern (i.e., E-VOUCHER)

  • Shopify SKU type (i.e., physical)

Where do I find this voucher information in the ERP?

Someone in your team may be able to find the information directly in the ERP interface. Otherwise, they can be provided by ERP support.

To use the checkout editor, you need to and your store needs to be on the plan.

Provide the ERP gift voucher details for DotApparel team to configure in the app ()

upgrade to checkout extensibility
Shopify Plus
see below