Skip to main content

Configuring customizations in NewStore Associate App

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

Use the Get app configuration method to retrieve the current configuration for Associate App in your business.

Printing in-store hang tags using additional pricebooks

When you enable this customization, NewStore uses the hangtag template to allow associates to print hang tags for in-store items via Associate App.

To enable Associate App to print hang tags:

  1. Set release_toggles > new_hang_tag_template to true. This allows you to start using the hangtag templates in the platform to print hang tags for in-store items.

  2. Use the Update app configuration method.

  3. Set customizations > hang_tag_printing_enabled to true.

  4. Set customizations > hang_tag_pricebooks to:

    ["pricebookNameA" ,"pricebookNameB"] or ["catalogName.pricebookName1" ,"catalogName.pricebookName2"]

    where catalogName is the name of the catalog, and pricebookNameX is the name of the specific pricebook. For such combinations of catalogs and pricebooks, see the business examples here:

    • store-front-catalog-en.regular and store-front-catalog-en.discounted, where

      • store-front-catalog-en is the name of the catalog, and regular is the name of the specific pricebook for regular prices
      • store-front-catalog-en is the name of the catalog, and discounted is the name of the specific pricebook for discounted prices
    note

    If you specify a value for pricebookName and none for the catalog, prices are fetched from the pricebook of the default catalog configured for the store. However, if you specify a value for catalogName.pricebookName, prices are fetched from this specific pricebook of the specified catalog. If no custom prices from additional pricebooks are required, do not specify a value for the property. The platform then uses the default store pricebook prices automatically.

For more information on customizing the hangtag template, see Customizing a template .

Enabling priority orders in store fulfillment

When you enable this feature, NewStore allows the store associates to see any priority orders waiting to be fulfilled.

To enable Associate App to show priority orders:

  1. Use the Update app configuration method.
  2. Set release_toggles > priority_orders_enabled to true.

Printing gift receipts

To enable associates in the store to print receipts for gifts in an order via Associate App:

  1. Use the Update app configuration method.
  2. Set customizations > gift_receipt_printing_enabled to true.
note

Gift receipts include the address of the store where the order was placed and not the store where the gift receipt was printed.

Configuring a PIN for gift cards

When a customer pays with a gift card, you can configure Associate App to ask associates to enter a PIN for the gift card to complete the checkout process. See Choosing a payment option .

Important

When you enable this customization, gift card payments are not allowed without entering a PIN for the card.

  1. Use the Update app configuration method.
  2. Set customizations > gift_card_pin to true.

When customers pay with a gift card, associates in the store now must enter the PIN for the card before checkout can be completed in Associate App.

Configuring gift messages

If required for your business, you can enable associates to add the option to add a gift message for items in an order.

To add a gift message:

  1. In the Cart screen for the order, tap More > Gift Message.
  2. In the dialog box that appears, add a gift message that will be applied to all items in the current order or cart.
Important

If you don't see the option available in the menu, the plugin may not have been enabled yet. To enable the plugin, see the cart management plugins.

Enabling switching to test mode

To enable the associates to switch from a live environment to test mode in Associate App and back:

  1. Use the Update app configuration method.
  2. Set customizations > stage_switch_enabled to true.
Important

Additionally, the associate must also have the Allow switch to Test Mode permission enabled via NewStore Omnichannel Manager. See Permissions for NewStore Associate App .

Configuring cart management plugins

Use this configuration to manage plugins that control options available to associates in Associate App, in the More > Manage Cart screen. For example, you can remove coupon from the list of plugins to remove the Redeem Coupon option from the Manage Cart screen in Associate App.

To manage cart management plugins in Associate App:

  1. Use the Update app configuration method.

  2. In customizations > cart_management, specify the plugins you want to use in the app, in the form of an array. Possible values are:

    • orderDiscount
    • itemDiscount
    • coupon
    • addDelivery
    • automaticDiscount
    • addGiftMessage

    For example, see this example for specifying cart management plugins:

    {
    "cart_management":
    [
    "orderDiscount",
    "itemDiscount",
    "coupon",
    "addDelivery",
    "automaticDiscount",
    "addGiftMessage"
    ]
    }

Disabling contact options

Use this configuration to disable the options available to associates in Associate App to contact customers in your business. After this configuration has been set up, the buttons to contact a customer via phone, email, or SMS in Associate App is disabled in the customer profile screen in Customers.

To disable contact options in Associate App:

  1. Use the Update app configuration method.

  2. In customizations > disabled_contact_buttons, specify the contact options you want to disable in the app, in the form of an array. Possible values are:

    • CALL
    • SMS
    • MAIL
    Important

    The values you specify in the array are case-sensitive.

    For example, see this payload to disable the options for associates to contact the customer via phone or SMS:

    {
    "disabled_contact_buttons":
    [
    "CALL",
    "SMS",
    ]
    }
    note

    In this example, associates can still contact the customer via email.

Related topics