Skip to main content

Configuring commerce components in NewStore Associate App

To configure the following commerce components in NewStore Associate App, use the NewStore Associate App Configuration API.

Use the Get app configuration 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, which can be scanned via NewStore Associate App.

Important

Configure at least one barcode type to enable associates to use NewStore Associate App.

  1. Use the Update app configuration 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 cards as products during checkout in NewStore Associate App, you must:

Products that match the product ID and the regular expression are identified as gift cards in NewStore Omnichannel Cloud. See 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 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 method.

  2. In commerce_components > gift_card_regexp, specify the expression. For example, ^(\\d{12})$.

    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, you need to 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