Managing Lark User Email Mapping in Xilnex for Lark

Managing Lark User Email Mapping in Xilnex for Lark

Overview


The Users card matches each Xilnex user to their Lark account by email. This is what lets features like Permission Approvals and Document Approvals deliver Lark cards to the right person. This article covers how to review the mapping and fix any users that couldn't be matched automatically.



Step 1: Open Users Card

1. Go to Xilnex Portal → Plugins → Xilnex for Lark → Users.

2. Xilnex users are automatically matched to this Lark workspace by email each time you open this page. The Last update timestamp in the top right shows when this last ran. Click Refresh to check again.



If any users need attention, a banner appears at the top of Portal: "X users need attention."



Step 2: Review the List


The table shows Username, Name, Lark email, Status, and an action menu.

Status is either:
  1. Verified: the Lark email was found and matched.
  2. Not found in Lark: no match found. This is what needs fixing.
  3. No email set: no email was set for this user, thus nothing was matched.
Use the Status filter to narrow the list down to just Verified or unmatched users. You can also switch between searching by Username or Name using the dropdown next to the search box.



Step 3: Set a Lark Email Manually


For users showing Not found in Lark/ No Email Set:

1. Click the ... action menu next to the user.
2. Select 'Set Email' to set their Lark email.
3. In the Set Lark email dialog, the Xilnex account is shown at the top (locked). Enter the correct Lark email below it.
4. Click Save.


Xilnex checks that the email actually exists in Lark before saving. If it can't be verified, the status stays as Not found in Lark.



InfoGood to know
  1. Matching runs automatically every time you open the page. You don't need to trigger it manually unless you want a fresh check, which you can do with Refresh.
  • Only users with a Verified Lark email can receive Lark approval cards and other Lark notifications. If someone isn't getting what they should, check their status here first.
    • Related Articles

    • Creating a Base in Xilnex for Lark

      Overview This article walks you through creating a base for a template, giving end users access to it in Lark, and verifying data is syncing correctly. Xilnex for Lark must already be connected before you start. If the Templates card isn't accessible ...
    • Introducing Xilnex for Lark

      Product Introduction Xilnex for Lark connects your Xilnex ClassicPOS system to Lark Suite. If your team is used to exporting reports, copying numbers into spreadsheets, or chasing approvals over chat, this replaces that manual work: your sales, ...
    • Xilnex-AutoCount - Account Code Mapping

      Account Code Mapping connects Xilnex transaction components (sales types, item categories, payment methods) to AutoCount GL accounts and payment codes. This ensures transactions post to the correct financial accounts. What Is Account Code Mapping? ...
    • Xilnex-AutoCount - Document Field Mapping

      Document Field Mapping specifies how Xilnex fields appear in AutoCount document fields. This includes header-level data (like Document Number and Customer) and detail-level data (like Item Description and Tax Code). What Is Document Field Mapping? ...
    • Disconnecting or Reconnecting Xilnex for Lark

      This article covers how to disable a template, fully disconnect the integration from Lark, and reconnect it again. Disable a Template Turning a base off only stops that one base, everything else keeps syncing, and none of your existing data in Lark ...
    • Recent Articles

    • Managing Lark User Email Mapping in Xilnex for Lark

      Overview The Users card matches each Xilnex user to their Lark account by email. This is what lets features like Permission Approvals and Document Approvals deliver Lark cards to the right person. This article covers how to review the mapping and fix ...
    • E-Wallet and Credit Card Payment - Recheck Status & Force Complete

      This guide walks you through what to do when a payment goes through on the terminal or e-wallet, but Classic POS fails to commit sales. When Does This Happen? During payment, Classic POS will show a "Connecting to Ewallet party..." or processing ...
    • E-Journal for BIR Compliance (Philippines)

      Overview The E-Journal feature generates a .txt file that complies with BIR (Bureau of Internal Revenue) requirements in the Philippines. This feature is available only for the Philippines COM. Users from other countries' COMs will not be able to ...
    • Disconnecting or Reconnecting Xilnex for Lark

      This article covers how to disable a template, fully disconnect the integration from Lark, and reconnect it again. Disable a Template Turning a base off only stops that one base, everything else keeps syncing, and none of your existing data in Lark ...
    • Creating a Base in Xilnex for Lark

      Overview This article walks you through creating a base for a template, giving end users access to it in Lark, and verifying data is syncing correctly. Xilnex for Lark must already be connected before you start. If the Templates card isn't accessible ...
    • Popular Articles

    • Basic - How to create a voucher-coupon

      Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...
    • Understanding DuitNow QR Payment in ClassicPOS

      Introduction This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard. The integration of DuitNowQR simplifies the ...
    • Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)

      1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...
    • Buy 2 for Special Price Promotion

      Use Case: Stock clearance, seasonal offers, or spotlight products. From the sample screenshot above, this promotion requires 2 items to trigger. If only 1 Milk Tea is added to the sales list, no discount will apply since the condition of 2 items is ...
    • Creating Delivery Type for Sales in Classic POS

      How to Create Delivery Type 1. Access to the [System Configuration] 2. Select the [Sales] section 3. In the [All Outlets] tab, look for the 'Delivery Type' 4. Click on the [Configure] In the Delivery Type Setup form: 1. Enter the Delivery Type. 2. ...