Overview

Shiji consumes the Yellow Dog API for a 1-way integration with their Infrasys product.  This integration allows Shiji to post sales transactions to the Yellow Dog Inventory system.


Sync Approach

Shiji pushes transaction data to Yellow Dog.

The Integration consists of two elements:

  • Shiji’s process to post sales, including Online Sales, to Yellow Dog’s API

  • Yellow Dog’s Process Sales Application to process transactions provided by Shiji in order to deplete inventory

Sync Frequency 

Shiji’s service posts sales once per day after end of day processes have been completed in Infrasys.

Yellow Dog’s Process Sales Application will be scheduled to run hourly by default.

Requirements

POS Partner

Shiji is responsible for controlling and scheduling the integration.

Yellow Dog

The minimum version of Yellow Dog Inventory must be v375 or higher and must be hosted by Yellow Dog.

Yellow Dog will provide API Username, password and Client ID.

Yellow Dog Implementation Guide will need to set up and schedule the Process Sales Application

Responsibilities

Client

The client is responsible for

  1. Providing a list of Infrasys Outlet Codes with YD Store mappings to add as Store Codes in YD.

  2. Using the POS Item Map in YDInv to map POS Items to Yellow Dog Inventory items/recipes.

Data Exchange and Mapping

Sales Data

Shiji controls the push of all data transmission via Yellow Dog’s Fetch API v3. 

Below are the corresponding data fields and files:

Yellow Dog FieldShiji Field
ThirdPartyIDSHOP|CHECK.FOUTLET|CHECK.FCHECK|EXPORTDATE
TransactionNumberCHECKITEM - FCHECK
TransactionLineNumberCHECKITEM - FLINENO
CheckClosedCHECK - FTIMECLOSE
ItemNumberCHECKITEM - FITEM
SKUCHECKITEM - FITEM
ItemCHECKITEM - FDESC1
Item RetailCHECKITEM - FTOTAL/FQTY
ItemDiscountCHECKITEMDISCOUNT - FDISCROUNDAMOUNT
DiscountDescriptionCHECKITEMDISCOUNT - FDISCNAME
QuantityCHECKITEM - FCQTY
EmployeeNumberCHECKITEM - FEMPID
EmployeeNameCHECKITEM - FEMPNAME
TenderCHECKPAYMENT - FPAYID
ReferenceFPERIOD:{checkData.FPERIOD},FPERIODNAME:{checkData.FPERIODNAME},FTABLE:{checkData.FTABLE},FCOVER:{checkData.FCOVER}
RegisterNumberCHECK - FOPENSTATID
RegisterNameCHECK - FOPENSTATNAME

Additional Information

Limitations

  • Voids are excluded from the transactional data posted by Shiji (8/15/24)

  • Transactions are posted by Shiji once per day after their end of day processes (8/15/24)

  • POS Item Mapping is required for this one-way integration (8/15/24)