Skip to main content

Prerequisites

We recommend that your store has the following prerequisites in place:

Networks and stable WiFi​

  • Ensure that you have separate networks; one dedicated to retail operations and another one for sound and digital signage. We recommend that you not allow guest access to these networks.

  • Ensure that you check network requirements for Adyen. See Adyen's guidelines.

  • The iPhone running the app must be connected to the same network as the document and/or label printer.

  • A bandwidth of more than 4Mbps per app. Note that maximum bandwidth is used for catalog browsing.

  • A round trip latency of less than 500ms, at full bandwidth per app.

  • A backup option if you have problems with your WiFi connectivity. For example, additional backup SIM cards with LTE/4G connectivity if you face Internet or power outages.

  • The wireless access points at your stores are mounted or installed so you have minimal interference from nearby networks within range.

  • Store WiFi with signal strength at:

    • -65dBm (Acceptable) across the whole store.
    • -50dBm (Optimal) for core checkout spaces in the store.

    Test the signal strength against the expected peak number of active apps in the store, at any given time.

Domain names​

Ensure that you whitelist these domain names in the respective environments.

Important

NewStore recommends you to use naming conventions such as:

  • <retailer_name>.p.newstore.net,
  • <retailer_name-staging>.p.newstore.net, or
  • <retailer_name-sandbox>.p.newstore.net for your tenant clusters.

Production

  • prod-newstore.auth0.com: Required for authentication via Auth0.
  • id.p.newstore.net: Required for users to log in with valid credentials.
  • zero.id.p.newstore.net: Required for users to log in with valid credentials.
  • lightstep.p.newstore.io: Required for tracing operations.
  • <retailer_name>.p.newstore.net: Required for APIs that are used to interact with the NewStore platform.
  • cloudinary.map.fastly.net: Required for product images used in your business.
  • sentry.io: Required for logging error messages in the platform.
  • amplitude.com: Required for analytic purposes.
  • associate-app-config.s3.us-east-1.amazonaws.com: Required for checking if the platform is available.
  • adyen.com: Required for using Adyen payment terminals.
  • clienteling.c.p.newstore.net: Required if the clienteling feature is used via NewStore Associate App.
  • *.mobile.c.p.newstore.net: Required for platform APIs specific to the Associate App.
  • f11n.c.p.newstore.net: Required for fiscalization checks.
  • fiscal-service.f11n.c.p.newstore.net: Required for fiscalization checks.
  • mqtt.f11n.c.p.newstore.net: Required for fiscalization checks.
  • newstore-production-services.s3.*.amazonaws.com: Required for fetching and printing documents.
  • *.apple.com: Required for running iOS apps.
  • maxcdn.bootstrapcdn.com: Required for the login view.
  • docs.newstore.net: Required for displaying release notes.
  • clients3.google.com/generate_204: Required for checking the connectivity of the application.
  • data.catalog.c.p.newstore.net: Required for the offline mode feature to fetch offline data.
  • newstore-conversation-images-*.s3.amazonaws.com: Required for fetching images sent or received via clienteling chat conversations.

Staging

Deprecated
This feature is now deprecated since January, 2022.

The Staging cluster is now deprecated. Use the Production cluster instead.

NewStore currently allows testing tenants only on the Production cluster, using the recommended naming conventions for these tenants. For example, name your staging tenant as <retailer_name-staging>.p.newstore.net in the production cluster.

  • dev-newstore.auth0.com
  • id.s.newstore.net
  • zero.id.s.newstore.net
  • lightstep.s.newstore.io
  • <retailer_name>.s.newstore.net
  • cloudinary.map.fastly.net
  • sentry.io
  • amplitude.com
  • associate-app-config.s3.us-east-1.amazonaws.com
  • adyen.com
  • clienteling.c.s.newstore.net
  • f11n.c.s.newstore.net
  • fiscal-service.f11n.c.s.newstore.net
  • mqtt.f11n.c.s.newstore.net
  • newstore-staging-services.s3.*.amazonaws.com
  • *.apple.com
  • maxcdn.bootstrapcdn.com
  • docs.newstore.net
  • clients3.google.com/generate_204
  • newstore-conversation-images-*.s3.amazonaws.com

Printers​

The document printer(s) must be AirPrint compatible. We recommend default wired connections to your printers. The iPhone running the app must be connected to the same network as the document and/or label printer. For a complete list of AirPrint-compatible printers, see the Apple website.

For more information on printer models that are supported by Associate App, see Supported printers .

note

For recommended label paper dimensions, See Setting up a printer .

Bluetooth​

If your store uses bluetooth payment devices from Square that are connected to NewStore Associate App, ensure you enable bluetooth on the smartphone running the app.

note

Each Square payment device can only be connected to 1 iPhone at a time.

(Optional) TouchID-capable smartphone​

Using a TouchID-capable smartphone adds an additional layer of security and allows the user to personalize the device. TouchID can be setup in the settings of your device.

note

You can add multiple printers. If a default printing station is not defined, the app uses the first printer in the list. Also see Setting your default printing station .

NewStore recommends the following printing station setup:

  • Receipt printing station

    Located on the sales floor, this printing station should contain only one document printer.

  • Document and label printing station(s)

    Separate printing station(s) named sequentially, for example floor1, floor2.

    Each of these stations should contain one document printer and one label printer.

(Optional) Fiscalization information​

Supported from
This feature is supported from Associate App v1.3.0 and later.

For stores operating in Sweden, the About screen of the app must display the Sweden software version of NewStore Associate App, for example: NewStore SE 1.0.0. The About screen must also contain the cash register name, production number, and control unit serial number being used in the store.

Related topics