Skip to main content

VDI Integration

Connect VDI-compliant telemetry devices for real-time machine data.

VDI Integration

What is VDI?

VDI (Vending Data Interchange) is an industry-standard protocol for vending machine telemetry. VendVice supports VDI 2.0 for receiving:

  • Real-time sales events
  • Machine status updates
  • Inventory level changes
  • Error alerts

Setting Up

Prerequisites

  • VDI 2.0 compliant telemetry device
  • Device configured to send to VendVice endpoint

Configuration

  1. Go to Integrations > VDI
  2. Click Add Device
  3. Enter device information:
    • Device ID
    • Machine assignment
  4. Copy the webhook URL
  5. Configure your VDI device to send data to this URL

VDI Setup

Webhook Endpoint

Your VDI webhook URL:

https://api.vendvice.com/vdi/webhook/{your-tenant-id}

Configure your VDI device to POST events to this endpoint.

Supported Events

VendVice processes these VDI events:

Event TypeDescription
SALEProduct vended
STOCKInventory change
STATUSMachine status update
ERRORMachine error/alarm

Real-Time Dashboard

With VDI connected, your dashboard shows:

  • Live sales as they happen
  • Instant low-stock alerts
  • Machine offline notifications
  • Error alerts

Message Log

View all received VDI messages:

  1. Go to Integrations > VDI
  2. Click Message Log
  3. Filter by device, date, or event type

Troubleshooting

No Data Received

  • Verify webhook URL is correct
  • Check device network connectivity
  • Review device VDI configuration

Events Not Processing

  • Check message log for errors
  • Verify device is mapped to a machine
  • Contact support with message samples