VisioLab 1-Way Integration

Last Updated: 8/21/2026

Overview

With Yellow Dog's 1-way interface with VisioLab, VisioLab provides sales data to Yellow Dog’s webhook.

Sync Approach

This integration contains three elements:

  • Yellow Dog sync application:

    • Pulls locations & items from the VisioLab API for the purpose of mapping

    • Pulls sales data from AWS S3 to match transactions and update on hands

  • VisioLab process to posts sales to Yellow Dog’s webhook

  • Yellow Dog’s Process Sales application to update sales reporting

Sync Frequency

The Yellow Dog Inventory sync can be run at any customized frequency. By default, this will be set up to run hourly.

Configuration

This integration allows for the following transaction states to be pulled into Yellow Dog:

  • Complete

  • Cancelled

  • Refund

Requirements

POS Partner

The POS Partner will need to provide the following:

  • API Key

Yellow Dog

Will provide the webhook URL to VisioLab

Responsibilities

Client

  • Add the YDSKU Label for items in VisioLab

    • This is how sales will be matched to items in YD.

  • Populate the SKU from YD as the YDSKU in VisioLab for each item

    • VisioLab may introduce an import feature in the future to streamline this process

  • Confirm Location mapping

Data Exchange and Mapping

Code Pull

Yellow Dog’s sync application pulls the following data from VisioLab’s API:

  • Stores for mapping to Yellow Dog Stores

  • Menu Item Ids, Names, and first YDSKU (Label) for mapping sales to items

Sales Data

AUTOMATIC MATCHING TO YD SKU: The Yellow Dog Item SKU must be populated to the VisoLab Label YDSKU.

Sales - TPTransaction VisioLab Field
Revenue Center Transaction.Store.Id
TransactionNumber transaction.CheckoutId
TransactionLineNumber item.Id
CheckClosed transaction.CheckoutEnd
ItemNumber item.Id
SKU YDSKU
Item item.Name
ItemRetail (always positive) item.UnitPrice
ItemDiscount (always negative) item.discounts.value / quantity
DiscountDescription n/a
Quantity Quantity
EmployeeNumber n/a
EmployeeName n/a
Tender n/a
Reference "REVERSAL" if reversal
RegisterNumber n/a
RegisterName n/a

Modifiers are not supported with this integration

Limitations

  • Sales are received via webhook. Only sales created in VisioLab after the lookupKey was generated and after VisioLab began posting to the webhook can be pulled. Historical sales are not supported.

  • To match sales to Yellow Dog items, each VisioLab item must have a “YDSKU” Label whose value is the item's SKU.

    • If there are multiple items in the same store with the same YDSKU these items will NOT be pulled in to YD for matching.

    • If an item has more than one YDSKU label assigned to it, our sync will only look at the first one.

  • Yellow Dog's sync ignores reversals from VisioLab and uses only the original sale.

  • VisioLab has no concept of voids.

  • Unsold POS Item Mapping is not supported in this integration at this time.