VisioLab 1-Way Integration

Last Updated: 6/4/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 SKU Label for items in VisioLab

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

  • Populate the SKU from YD as the SKU 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

This integration pulls the following Codes:

  • LocationID

  • ItemNumbers (to support unsold items in POS Mapping in Yellow Dog)

Sales Data

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

Sales - TPTransaction VisioLab Field
Revenue Center Transaction.Store.Id
TransactionNumber transaction.CheckoutId
TransactionLineNumber item.Id
CheckClosed transaction.CheckoutEnd
ItemNumber item.Id
SKU sku
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 Label (typically "SKU") whose value is the item's SKU.

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

  • VisioLab has no concept of voids.