What is the Current status of the Skyvisitor and Biostar Air Integration Testing
- Objective
The purpose of this session was to test the integration between Skyvisitor and Biostar Air in preparation for deployment at Avery Dennison. The focus was on validating the end-to-end visitor journey, including pre-booking, data synchronisation, QR access, and automated check-in.
- Required Visitor Journey (Target Workflow)
The intended workflow for Avery Dennison is as follows:
- Pre-booking in Skyvisitor
- A visitor is pre-registered within the Skyvisitor web portal.
- Upon creation, the following data must be passed to Biostar Air via API:
- Visitor Full Name
- Email Address
- Unique Identifier (Skyvisitor User ID – GUID)
- Assigned Access Level
- This is to be tested for new and existing users
- Automatic User Creation in Biostar Air
- The visitor record is automatically created in Biostar Air.
- The system triggers:
- A Skyvisitor pre-booking email notification
- A Biostar Air email containing:
- Web QR code
- Mobile access pass
- On-site Arrival & Access
- The visitor arrives on-site and:
- Scans their Web QR code at an external door Suprema XS2 QR reader to enter the site (entry point).
- Proceeds to the Skyvisitor kiosk (Skytouch web interface), also equipped with an XS2 QR reader.
- The visitor arrives on-site and:
- Automated Check-in
- A successful QR scan at the kiosk reader should:
- Generate an access event in Biostar Air
- Trigger an API event to Skyvisitor
- Automatically check the visitor in within Skyvisitor
- A successful QR scan at the kiosk reader should:
- Integration Progress & Successes
- Integration work between Brent (Safetynet) and Erik (MOCA / Suprema Korea) has enabled:
- Successful user provisioning from Skyvisitor to Biostar Air.
- Data transfer confirmed for:
- Name, email, GUID, and access level.
- Dual email notifications confirmed (Skyvisitor + Biostar Air).
A Suprema XS2 device with QR reader attachment has been installed at the Safetynet Office and connected to the Avery D Biostar Air database for testing.
4.Testing Results
We have been able to successfully test passing through a user from Skyvisitor to Biostar air. This was triggered by a prebooking created in Skyvisitor. The user passes over Visitor Full Name, email address, ID (Skyvisitor User ID GUID) and access level and also triggers an email to be sent to the visitor via both Skyvisitor (Prebooked Email Notification) and also Biostar air with their Web QR card and mobile pass.
4.1 QR Code Scanning Behaviour
- When scanning the QR code generated by Biostar Air:
- The XS2 reader emits a beep, indicating detection.
- However:
- No on-device confirmation (e.g. access granted/denied message).
- No access event is logged in Biostar Air.
- No event is passed to Skyvisitor → check-in is not triggered.
4.2 Initial False Positive
- Early testing suggested partial success due to:
- Correct event codes appearing.
- Upon further investigation:
- The reader was actually detecting the mobile access card (proximity-based) rather than the QR code.
- The QR scan itself was not triggering an event.
4.3 QR Code Failure (Consistent Issue as of 2904)
- Multiple test scenarios were attempted:
- QR codes generated via Skyvisitor → Biostar Air integration
- QR codes generated directly within Biostar Air
- Result:
- No successful QR scan event recorded in any scenario.
- Indicates the issue is not related to data provisioning, but likely:
- Device configuration
- QR reader setup
- Or hardware/firmware limitations
4.4. Summary / Final Outcome
The integration between Skyvisitor and Biostar Air is functioning correctly at the data and provisioning level, with the mandatory pre-booking and user creation step fully validated.
Following intervention from Erik (Suprema Korea), a QR scanner configuration code was provided and applied to the Suprema XS2 device. This configuration reduced the baud rate of the QR scanner, and the code was successfully scanned onto the device.
E200 QR Scanner Wiring and Configuration.pdf
✅ After applying this change:
- QR codes are now being correctly read by the XS2 QR reader
- Access events are being properly generated in Biostar Air
- Events are successfully passed back to Skyvisitor with correct code value
Further validation testing confirmed consistency across multiple scenarios:
- A Web QR card generated directly within Biostar Air was successfully scanned and returned an “access granted” response
- A user created in Skyvisitor and synced to Biostar Air via API was also successfully scanned using their QR code, returning an “access granted” response
Brent additionally confirmed that:
- Once the access events were received within the web browser (Skytouch interface),
- These events successfully triggered the automatic check-in of the visitor within Skyvisitor
Conclusion
The issue has been resolved and was determined to be related to QR scanner configuration (baud rate settings) rather than the integration itself.
The end-to-end visitor journey is now functional, including:
- Pre-booking and user provisioning (For new and Existing users)
- QR code generation and delivery via email - (email forward to a different device also works successfully)
- QR-based access via XS2 readers
- Event transmission from Biostar Air to Skyvisitor
- Automated visitor check-in via Skytouch web
Remaining Steps
Complete further testing of additional to confirm consistency in solution, there have been small occasions of no result from the XS2 when scanning the web QR Card - Erik (Suprema) believes this is likely to be a slightly lose wire within the RJ485 - Feedback to be provided to OLS.