HelpCenter

Explore
Parlevel - Remote Price Changes
Updated

Purpose

This article outlines the steps required for performing a remote price change to a product in Parlevel VMS.
 

Requirements Per Machine

  1. Has a PayPlus reader installed.
  2. Is compatible with remote price changes.
  3. Has  the Remote_Price_Changes Compatibility Flag enabled in the VMS.
     

White List Vending Machines

The following are machines we know remote pricing works for:

  • DN-5800
  • DN-501E
  • USI 3500 series
  • Vendo machines running VEC version 12.1 or higher
  • AP Revision door (Vendors Exchange Board v4.4 or higher)
     

Additional Compatibility Notes

AMS Vendors

  • Sensit I and Sensit II: Not compatible.
  • Sensit III: Compatible only with newer boards and firmware. (Requires 2018 or newer. Firmware v1.4 or higher for boards: 25900, 26900, 28500, and 29272-20.)
    • Older Sensit III boards (Ex. AMS G8-624 with older Sensit III) will require a board upgrade to support Remote Pricing.
       

Royal Vendors

  • Coke 550 (67325-2 blue button board): May or may not work with Remote Pricing.
  • Red board (firmware 67121): Not compatible.
  • Firmware 67105 (EPROM upgradable): May still not work with Remote Pricing.
    • Royal Vendors no longer use EPROM chips; VMC boards must be sent to the manufacturer for firmware updates.
       

Request This Feature

This feature is not turned on by default. Please contact 365Support via live chat, at (888) 365-6282 or support@365rm.com to have this feature enabled.
 

Process

Creating the Remote Price Change in VMS

  1. Log into the VMS.
     
  2. Navigate to Vending > Tools > Selection Manager.
     
  3. Use the column filters to specify products, assets, or locations.

    Parlevel - VMS Filter Products
  4. Check the boxes on the left side of the row to select products. Checking the top box selects all products.

    Parlevel - VMS Select Products
  5. Click Update to open the Bulk Edit Selections modal.

    Parlevel - VMS Bulk Edit Modal
    1. Set the pricing type. This sets how prices will change.
      1. Update price - sets one new price across the board for all selected products.
         
      2. Increase or Decrease the price - adjusts the price of each product based on its original price.

        Parlevel - VMS Price Increase Decrease Flat Rate or Percentage
        Flat Rate - by the exact amount of the set value.

        Percentage - by a percentage based on the set value.
         
    2. Set the update method. This sets how the price change will be delivered. The number in parentheses shows how many devices will use the specified method based on the current product selection.

      Parlevel - VMS Remote Price Change PayPlus Force
      Mobile - devices without a PayPlus reader that need prices updated via DEX and not remote price change.

      PayPlus - devices that have a PayPlus reader installed.
       
  6. Select PayPlus (since a PayPlus is a requirement for a remote price change) and then select Force.
     
  7. Click Submit.
     
  8. Click Ok to confirm.
     

Track Progress

Navigate to Vending > Tools > Selection Tracker.

The Status column shows the update progress for each product.

  • Pending - initial status after submitting a remote price change.
  • Dispatched - update in progress.
  • Success - update successfully applied to machine.
  • Error - update not successfully applied to machine.

Parlevel - VMS Remote Price Change Status Tracker

Devices that are Password Protected

When a remote price change is attempted on a vending machine with a DEX password-protected card reader, the remote price change fails due to an unknown or incorrect DEX password. 

The system will evaluate whether the DEX Password Bypass feature is enabled in Company Settings. If the feature is enabled, the system converts the failed remote price change into a Service type price change, and schedules the service-type price change for the next regular service visit.
 

Selection Tracker

The service-type price change is displayed in the Selection Tracker with the message Created due to password bypass. The Message column is visible by default in the Selection Tracker for these entries.

Parlevel - Remote Price Change DEX Password Fail

Operator Service

  1. When a driver opens the machine door during a service visit, the system updates the DEX password.
     
  2. The system applies all pending service-type price changes in order.
     
  3. On successful application, the system sends a notification.
     
  4. If the update fails, the price change is marked as Error in the Selection Tracker.
     
  5. If a pending service-type price change exists due to password bypass, a red alert is displayed on the machine detail screen in the Stock app.
     
  6. The alert remains visible until the required service action is completed.
     

Error Messages

Should an error occur, the Messages column provides some info.

Error Message Description
Change overwritten by newer update A newer remote price change request was submitted for the same slot while a previous request was still pending. The previous request is marked as error, and replaced by the new request.
Change id not found on the server (lost or was never sent) Server send issue - The Request ID was not found when the server requested a status update. Investigation is required to determine the root cause; this may be resolved server-side.
error: Price Mismatch DEX Write succeeded and validation DEX Read succeeded, but the price did not update on the machine.
Missing in Dex Cannot change price, because the selection does not exist in the DEX file.
The machine’s planogram is likely incorrect. Originates from the Stock app.
noConnectionDeviceToMachine No response from the device. The system attempted to write DEX but failed.
A vend may have been in progress at the time of the request.
Read Error DEX Write succeeded, but the validation DEX Read failed.
Remote device provider system is not able to find device The provided DeviceID was not found by the remote device provider system.
The device was likely offline for an extended period prior to the request.
Server not able to connect with device The server was unable to establish communication with the device within the allotted retry window. The vendor server will not attempt additional retries. No DEX response was received.
Selection does not exist in machine or invalid Cannot change price, because the selection does not exist in the DEX file.
The machine’s planogram is likely incorrect. Originates from PayPlus.
Unknown error occurred A remote price change was submitted for a slot with an existing pending price change.
The existing request is marked as error and a new request is created.