---
title: "Configuring commerce components in NewStore Associate App"
slug: "configuring-commerce-components-in-newstore-associate-app"
tags: ["api", "config api", "tutorial", "Associate App configuration", "printer", "gift card", "receipts", "template", "Associate App", "barcode", "product"]
updated: 2025-11-12T12:54:16Z
published: 2025-11-12T12:54:16Z
canonical: "docs.newstore.com/configuring-commerce-components-in-newstore-associate-app"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newstore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring commerce components in NewStore Associate App

To configure the following commerce components in NewStore Associate App, use the NewStore Associate App [Configuration API](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config).

Use the [Get app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/getConfig) method to retrieve the current configuration for NewStore Associate App in your business.

## Configuring barcode types

Specify the barcode types such as `EAN13` or `QR`, among others, which can be scanned via Associate App. You can also specify `CodeTypeAll`, which enables the app to scan all barcode types supported by NewStore.

> [!NOTE]
> Important
> 
> - Configure at least one barcode type to enable associates to use Associate App.
> - Ensure that the barcode type `QR` is configured for associates to be able to scan QR codes containing an **EPC** (Electronic Product Code). See [this guide for EPC support](/v1/docs/set-up-epc-support).
>   - QR codes in the `01/{GTIN}/21/{serial}` and `/{model}/{variation}/{epc}` formats are supported.
>   - When using an EPC code, only 1 item can be added to a cart at a time, irrespective of using the scanner or the quantity picker.
>   - The serial number is decoded from the EPC and carried in the external ID called SN, which is exposed to third parties with the external events.

1. Use the [Update app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/putConfig) method.
2. In `commerce_components` > `barcode_types`, specify the barcodes that can be scanned via NewStore Associate App.

## Configuring gift cards as products

To enable retailers to sell `gift card`s as products during checkout in NewStore Associate App, you must:

- [Configure the product ID](/v1/docs/configuring-commerce-components-in-newstore-associate-app#configuring-the-product-id-of-the-gift-card)
- [Configure the regular expression](/v1/docs/configuring-commerce-components-in-newstore-associate-app#configuring-the-regular-expression-of-the-gift-card)

Products that match the product ID and the regular expression are identified as gift cards in NewStore Omnichannel Cloud. See [Selling gift cards](/v1/docs/integrating-a-gift-card-provider#selling-gift-cards).

### Configuring the product ID of the gift card

To add the product ID of a gift card in NewStore Associate App:

1. Use the [Update app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/putConfig) method.
2. In `commerce_components` > `gift_card_product_id`, specify the product ID. For example `2000081`.

### Configuring the regular expression of the gift card

To add the regular expression of a gift card in NewStore Associate App:

1. Use the [Update app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/putConfig) method.
2. In `commerce_components` > `gift_card_regexp`, specify the expression. For example, `^(\\d{12})$`.

> [!NOTE]
> Important
> 
> The regular expression matching is **NOT case-sensitive**, which means `^([a-z]*)$` will be matched with both `abc` and `ABC`. Associates might type in lower or upper case letters when manually entering a gift card number. The integration must handle situations where the gift card provider requires the gift card number typed in a specific case.
> 
> To correctly extract the gift card's serial from the scanned barcode, provide a [capture group](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Capturing_group). You can capture the whole number or just part of it depending on your integration. An expression like `^SVS_GC-(\\d{15})$` will match all scanned codes that start with `SVS_GC-` but only extract the number following this pattern as the actual gift card number.

**Related topics**

- [Integrating a gift card provider](/v1/docs/integrating-a-gift-card-provider#integ-giftcard)
- [Configuring documents for print in a store or warehouse](/v1/docs/configuring-documents-for-print-in-a-store-or-warehouse#config-notif-docs)