Skip to main content

How to interpret access control log messages and QR code scans

Introduction

In Perfect Gym, understanding the access control logs is essential for smoothly managing member entries and troubleshooting gate issues. This feature allows you to see the exact details of every member scan, helping you easily identify why access was granted or denied.

  • In this article, you will learn how to check scan records, differentiate an actual entrance scan from a simple QR code generation, and understand the meaning of various access control messages.

  • This article will be helpful for a Receptionist, Support Agent, or PG Champion.

Before you start

To view a member's access history, ensure you are logged into the Perfect Gym Manager and have the necessary permissions to access member profiles and view their activity logs.

Fast lane

Please note that this is a brief overview. The following sections contain more detailed information.

  • Go to member's profile / Click on the Activity tab / Select Access Control / Click More Info next to a specific scan record to read the comments.

Instruction

When reviewing a member's access history, you might need to know whether the log shows an actual gate entry or just the generation of a new QR code in the Mobile App. You can easily differentiate these two actions by checking the comments inside the More Info option next to a scan record.

Actual Entrance Scan vs. QR Code Generation:

  • Regular Scan: Will include a message in the comments section like AccessLogic:Enter gate; Action on confirmation executed.

  • QR Code Generation: The comments will include AccessLogic:QrCodeAccess. While the Access Logic name might differ slightly depending on your setup, a QR code generation usually includes the "QrCodeAccess" wording.

Important details about QR Code Generation:

  • Generating a QR code will never mark the user's presence in the club.

  • Because of this, the card swipe record will be placed directly underneath the visit count time (if the visit has already ended).

  • If the user is still physically in the facility, the visit time will not be displayed in their Activity history at all.

Access Control Messages Explained

When checking the More Info section of a scan, you may encounter different error or status messages. Here is a clear breakdown of what each message means:

  • No Active Contract: AccessLogic:Enter gate; Membership error: NoActiveContract; Message key: MembershipStatusError The user has no active contract. If a contract does exist, its start date is either in the future or the associated debt has not been covered.

  • Outdated QR Code: AccessLogic:QrCodeAccess; QR code is outdated; Message key: QrCodeIsExpired; Action on confirmation executed The scanned QR code is old and no longer valid. The member needs to generate a new QR code to be granted access.

  • Offline QR Code: AccessLogic:Enter gate; Offline QR code The QR code was generated by the member's app without an active internet connection.

  • Debt Lasts Too Long: AccessLogic:QrCodeAccess; Contract debt lasts too long: Y days > X* days; Message key: ContractInDebtTooLong Access is denied because the member has an unpaid debt that is too old. The system checks this against the allowed number of days in debt set up in your Access Logic settings.

  • Double Enter Error: AccessLogic:Enter gate; Double enter; Message key: DoubleEnterError; Action on confirmation executed The member tried to scan again before the specified block time passed. To enter, the time between scans must be greater than the value set in the "Double Entry time" settings.

  • Emergency Mode: AccessLogic:Enter gate; Emergency mode The scanner is currently offline and operating in emergency mode. In this mode, the system accepts every scan without checking the member's contract validity, debt, etc.

  • Unknown User: AccessLogic:Enter gate; Unknown user; Message key: UnknownUser The system does not recognize the QR code, fingerprint, or access card being used.

  • Club Not Allowed: AccessLogic:Enter gate; Membership error: ClubNotAllowed; Message key: MembershipStatusError The member's product or Access Rule does not grant them access to this specific club location.

  • Zone Not Allowed: AccessLogic:Entrance; Membership not allow to enter to club zone; Message key: MembershipNotAllowThisClubZone; Action on confirmation executed The member is trying to enter a specific zone inside the club that is not allowed by their Access Rule or product. (Note for the two points above: Information about possible reconfiguration can be found in our articles on Access Rules Overview or How to create a Product that allows entering the club).

  • No Active Service (Drinking Station): AccessLogic:Drinking Station; User don't have active service; Message key: UserDontHaveActiveService The member is trying to use a drinking station or similar service but does not have the necessary additional product or contract extra to grant access.

Hints

  • Keep in mind: The specific "Access Logic" name shown in the logs might differ slightly depending on how your club's specific Access Logic is named and configured in the system settings.

Related articles