NCR Silver - 1 Way Interface
Last updated: 2/15/2024
Overview
The NCR Silver 1-Way Interface is a one way sales interface that uses NCRSilver’s API to pull sales into Yellow Dog. More information on our two way interface with NCR Silver can be found here.
Sync Approach
The NCR Silver 1 -Way Interface contains two elements:
Yellow Dog’s NCRSilverConsole to pull sales and locations from NCRSilver’s API.
Yellow Dog’s Balto application to assign locations from GoTab stores in Yellow Dog.
Sync Frequency
By default the console is scheduled to run hourly. Additional configuration options are available upon request.
Configuration
This integration supports multiple instances of NCRSilver connected to the same YD database.
This integration supports two methods to map sales for inventory depletion:
Menu Items and Recipes are mapped to the POS Item Sold using Yellow Dog’s POS Item Mapping
Sales can be matched to Yellow Dog Items based on SKUs or UPCs
Please confirm the preferred method with your Implementation Guide.
Requirements
Client
If the Yellow Dog database is not hosted by Yellow Dog Software, there may be additional firewall rules or port configurations necessary to facilitate communication. In order to exchange information with the NCR Silver API an internet connection will be needed.
The client will need to provide the Location to Store mapping, and inform Yellow Dog their preferred method of matching sales.
POS Partner
The POS partner will need to provide the ClientID and Client Secret.
Yellow Dog
Yellow Dog requires the following:
Yellow Dog database version 375 or higher
Location to Store mapping
Data Exchange and Mapping
Sales Data
This integration does not support tax or tender data for accounting exports.
Yellow Dog pulls the following sales information from NCRSilver’s API:
NCR Silver Field | Yellow Dog Field |
---|---|
TicketNumber | TransactionNumber |
TicketDate | CheckClosed |
ItemMasterId | ItemNumber |
ItemBarCode | SKU |
ItemName | Item |
UnitPrice | ItemRetail (always positive) |
Item Discounts / Ticket Discounts | ItemDiscount (always negative) |
DiscountName | DiscountDescription |
QuantitySold | Quantity |
UserId | EmployeeNumber |
UserName | EmployeeName |
"NCRSilver" | Source |
Station | RegisterName |
orderStatus | Order Status | ticketGuid | Order Number |
Additional Information
Yellow Dog Mobile Apps
None of the Yellow Dog Mobile applications are certified to work on NCR Terminals
Limitations
Voids do not update transactions in NCR Silver’s API, therefore they are not handled in Yellow Dog.
Split checks and shared items can have rounding issues when itemized discounts are calculated.
NCR Silver supports a single barcode per item.
NCR’s Item Name has a limitation of 50 characters max and does not allow duplicate names.
NCR has a limitation of UPC length of 20.