Skip to content
English
Sign in
Contact us
  • There are no suggestions because the search field is empty.

NZESL / Pricer Integration | Setup & Configuration

Learn how to configure and operate the Bepoz–NZESL integration to keep shelf-edge pricing accurate, automate promotions, and streamline label management across your venues.

📘 Overview

The Bepoz–NZESL Integration enables seamless communication between Bepoz and New Zealand Electronic Shelf Labelling (NZESL) systems. It provides real-time synchronisation of product data, pricing updates, and promotional configurations.

Benefits include:

  • Ensuring accurate shelf-edge pricing across all stores

  • Automating promotion and price point changes via Bepoz

  • Maintaining store-specific pricing logic, including redirection scenarios

  • Reducing manual label handling to optimise workflows

This guide explains how to configure the interface and manage day-to-day operations.

⚙️ Setup

Tag NZESL Products

Within BackOffice:

  1. Navigate to Product Maintenance → Custom Info tab.

  2. Add a new custom flag (e.g., NZESL Product).

  3. For each product intended for NZESL, apply the custom flag:

    • Can be added to the individual product or parent group.

  4. This flag is used in Scheduled Job filtering for easier configuration.

Scheduled Job Configuration

The NZESL interface runs via a Scheduled Job on the Smart Controller.

  • Should be scheduled on startup.

  • In multi-venue environments, configure at Head Office.

NZESL Scheduled Job Configuration

 

 

Job Maintenance Settings
Setting Description
Debug Mode Enables logging for troubleshooting. Outputs JSON to C:\Bepoz\Data\NZESLExport. No data is sent to NZESL in this mode.
Test Mode Uses NZESL development stores; validates without sending live updates.
API Endpoint URL for product/price push (e.g., https://central-manager.<VENUE_ENV>.pcm.pricer-plaza.com).
Client ID Provided by NZESL; used for authentication.
Client Secret Provided by NZESL; used for authentication.
Token Endpoint Auth URL: https://iam.pricer-plaza.com/api/v2/oauth/token.
Products All Products or Custom Flag (only flagged products sent).
Poll Interval (mins) How often the job runs (e.g., every 10 mins).
Store Mapping Links Bepoz store ID to NZESL store ID.
Store Mapping Configuration

  1. Access via Store Mapping Configuration in job settings.

  2. Configure:

    • Venue → filters available stores

    • Store → filters available tills

    • Till → determines price level sent to NZESL

  3. One entry per store is allowed.

  4. The selected till’s pricing is used for NZESL updates.

NZESL Store Mapping Configuration

🛠️ Basic Functional Overview

How It Works:

  • Runs on Smart Controller startup and at set intervals.

  • Each cycle:

    1. Collects updated product & price data from mapped till.

    2. Retrieves promotional pricing updates.

    3. Sends data to NZESL via API.

    4. Logs success/failure and errors in YALV logs.

📄 Data Mapping

NZESL Field Sample Value Bepoz Field & Notes
Department Beer Product Type / ItemGroup
Package Low Carb / Dry Product Group
ItemID 9313419523178 Primary Barcode
ItemName Hahn Ultra Low Carb B330 Product Long Name
Presentation Promo Pricing mode (Standard or Promotion)
Price 21.00 Standard Price
Main PLU 18076-2 ProductID + SizeID
MM Description QLD CB P31 (2FOR) 6pk Multi-buy Name
MM End Date 2025-08-10 Promo Expiry
MM Price 28.00 Multi-buy Price
MM Qty 2 Multi-buy Quantity
Parent PLU 51 Product Group ID
Promo End 2025-08-10 Promo End Date
Promo Name QLD CB P31 (SGL) Price Promo Name
Promo Price 16.00 Promotional Price
Sell Size 6pk Size Name
Short Description Hahn Ultra Low Carb B330 Sgl 6pk Short Name + Size
SICS 9313419523178, 9313419527633 Multiple barcodes

Sample NZESL Payload

🧪 Testing & Validation

Before going live:

  1. Enable Debug Mode.

  2. Trigger the job manually or reduce poll interval.

  3. Review logs and .json output for each storeto confirm the payload information is as required. 

  4. Disable Debug Mode once verified.

🆘 Troubleshooting

Scenario Resolution
Nothing appears on ESLs Check job is enabled and not in Debug Mode.
API auth errors Verify API Key & Endpoint URL.
Only some products update Check filter rules & stock status.
Store mapping errors Ensure IDs match exactly between Bepoz & NZESL.