How to Install and Set Up Xilnex for Lark
Overview
This article walks you through connecting your Lark workspace to your Xilnex account. This is a one-time setup step performed by an IT administrator, using the Configuration card in Xilnex Portal.
Before You Begin
Confirm you have the following:
- Active Xilnex ClassicPOS account and access to Xilnex Portal
- Permission to access the "Plugin: Xilnex for Lark" module in Xilnex Portal
- Active Lark Suite account (free tier is supported)
- Admin access in Lark to install marketplace apps
Step 1: Access Xilnex Portal Plugins
1. Log in to Xilnex Portal with your IT administrator credentials.
2. Click the [...] icon on the top right corner which displays a kebab menu, click on Plugin
3. Locate Xilnex for Lark in the available plugins list and click to open it.
4. Click the Configuration card (under Maintenance).
Step 2: Install Xilnex for Lark in the Lark App Directory
The Configuration page shows that the integration is in 'Not Connected' status, and a short onboarding guide alongside the connection panel. If Xilnex for Lark isn't installed in your Lark workspace yet:
1. Click Redirect to Lark to be redirected to Xilnex for Lark in Lark App Directory.
2. Or manually go to the Lark App Marketplace and search for "Xilnex for Lark." Click Get to install the app.
3. Once the app is successfully installed, you can start to configure users in Lark, however that isn't required to connect. You can skip straight to Step 3 to connect with Xilnex.
Step 3: Authorize the Connection
1. Return back to the Configuration page in Xilnex Portal, click Authorize.
2. This opens Lark's Authorization consent screen. Review and approve the authorization between Lark and Xilnex.
3. Status turns Active. You are now connected.
If you click Authorize before installing the app or your Lark account doesn't have permission, the Lark Authorization page will ask you to install the app first or switch accounts. Once you do, come back to the Configuration page and click Authorize again. It doesn't resume automatically.
Unlinking
If you have authorized the wrong Lark tenant or Xilnex account by mistake, for example if you have multiple Lark accounts and picked the wrong one, use the Unlink button to fix it.
1. On the Configuration page, under the Lark Connections details there is a Manage connection field, followed by the Unlink button.
2. Click on Unlink
3. A confirmation popup explains: 'This clears the connection on the Xilnex side only. The app stays installed and active in Lark, and you can relink anytime by clicking Authorize.'
4. Click Yes, Unlink to proceed.
The page returns to the same Not Connected screen from Step 3, the one you saw before you authorized. Nothing changes on the Lark side. The app is still installed and stays active in Lark. Simply click Authorize and go through the Lark Authorization consent screen again, this time with the correct account.
Unlink is different from disabling the app in Lark. To stop using Xilnex for Lark, see [Disconnecting or Reconnecting Xilnex for Lark].
Good to know
You can only Authorize while Xilnex for Lark is enabled in Lark. If it's been deactivated there, Authorize won't work until you re-enable it first.
Related Articles
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, ...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 ...Approval Hub Overview in Xilnex for Lark
Approval Overview Approvals matter, but they're easy to bottleneck. A cashier might need a permission override right now, with a customer waiting on counter, but the manager who can approve it isn't always available. On the back office side, a ...Permission Approvals in Xilnex for Lark
Overview Permission Approvals connect Xilnex POS to Lark Approval. When a cashier attempts an action they don't have permission for (like cancelling a sale), they can send a request straight to a manager's Lark app instead of needing a supervisor ...Document Approvals in Xilnex for Lark
Overview Document Approvals route back-office documents like Purchase Orders, Stock Requests, and Stock Adjustments to a Lark card for the right approver, before the document is committed or processed. This article covers both setup (for IT ...
Recent Articles
Xilnex for Lark — Closed Beta is Live!
Xilnex for Lark has officially been released on Xilnex Portal v0.0390.0826. The closed beta is now live for the closed beta registered companies How to Access Xilnex for Lark on Portal Step 1 — Find the Plugin section Click the ⋮ (three-dot menu) at ...How to import item in Xilnex Classic and Xilnex Portal?
KB: Item Import Guide (Classic + Portal) 1. Overview & Purpose Item Import lets you create and update item master data in bulk from a CSV file, instead of keying items in one by one. The function exists in two places — Classic and Portal — and both ...Transfer Note Lifecycle info
Transfer Note Lifecycle What Is This Concept? A Transfer Note (TN) is the document that records stock moving from one location to another — HQ to outlet, outlet to outlet, or inter-company. It is not a single event but a state machine spanning two ...Basic - How to Create a New Item Code
How to Create a New Item Code An Item Code is the master record for every product you sell or stock in Xilnex. Creating a complete item record ensures accurate sales, purchasing, inventory tracking, and reporting across all your locations. The system ...Portal: Store Ordering User Setup Guide
User Guide For Order Processing Covers twelve screens across four areas: Area Screens Primary audience Order & item setup · Part 2 · Part 3 Order Type Maintenance · Item Allowed by Order Type · Item Availability · Store Availability HQ / System Admin ...
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. ...