Skip to main content
Mapping products to machines, also known as planogram setup, is a critical step in inventory management. This process involves assigning specific products to the bins or selections of a vending machine and defining the machine’s layout. A well-structured planogram ensures that the correct products are available in the right quantities, providing clear guidance for inventory tracking and restocking. You can create product maps in Nayax Core by following the steps below:
  1. Go to Administration > Product Maps.
  2. Click Add New Product Map
  3. Fill in the required fields for the product map.
    1. Operator Name: Specify under which operator the map will be located.
    2. Machine Model: Select which machine the map is for.
    3. Map Name
    4. Status: Whether the map is active or not.
  4. Click Save
Now, you can add products to this map. Follow the steps below to do so:
  1. Select the Map from the list.
  2. Click on the Map Items tab.
  3. Now you can add a product to this map by clicking:
    1. Add BIN: This will let you add one product directly to the list.
    2. Add Multiple BINS: This will bring a pop-up window that will let you select multiple products to add to the map.

​
Lynx API

With Lynx API, you can add one or multiple products to the Machine’s Product Map using the following endpoint:
Create Machine Products
POST
AuthenticationRefer to the Security & Token page of this documentation to learn how to access your tokens, and how to properly use it to authenticate your API requests.

​
Add Machine Product

the Create Machine Products endpoint allows you to create the product map for a machine and add products to it by providing the MachineID in the path param of the request. See the example request in the code block below: 
curl --request POST \
     --url https://qa-lynx.nayax.com/operational/v1/machines/{MachineID}/machineProducts \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
[
  {
    "NayaxProductID": 0,
    "MDBCode": 0,
    "PAR": 0,
    "CashPrice": 0,
    "CreditCardPrice": 0,
    "MachinePrice": 0,
    "RetailPrice": 0,
    "DEXProductName": "string",
    "PACode": "string",
    "PCCode": "string",
    "ProductMinimumPickQTY": 0,
    "VendOutAlertThreshold": 0,
    "PrePaidCardPrice": 0,
    "OperatorButtonCode": "string",
    "CommissionValue": 0,
    "ExternalPrepaidPrice": 0
  }
]
'
You can add more than one product object in the array. This way, you can add multiple products to the Map with juust one request.
Path ParamsChange the MachineID with the unique identifier of the machine to map its products.
In the body parameters, fill in the following:
ParameterDescription
NayaxProductIDA unique identifier for the product in the Nayax system.
MDBCodeThe MDB (Multi-Drop Bus) code associated with the product.
PARThe price adjustment ratio for the product.
CashPriceThe price of the product when purchased with cash.
CreditCardPriceThe price of the product when purchased with a credit card.
MachinePriceThe price of the product set directly on the vending machine.
RetailPriceThe suggested retail price of the product.
DEXProductNameThe product name as it appears in the DEX (Data Exchange) format.
PACodeThe PA (Price Adjustment) code associated with the product.
PCCodeThe PC (Product Category) code associated with the product.
ProductMinimumPickQTYThe minimum quantity of the product required for restocking or picking.
VendOutAlertThresholdThe stock level threshold that triggers a vend-out alert.
PrePaidCardPriceThe price of the product when purchased using a prepaid card.
OperatorButtonCodeThe code used by the operator to select the product manually.
CommissionValueThe commission value associated with the product.
ExternalPrepaidPriceThe price of the product when purchased with an external prepaid solution.