Hướng dẫn này trình bày cách tạo Xero App trên Xero Developer Portal và chuẩn bị thông tin xác thực cần thiết để tạo Xero Connector trên HexaSync Automation Engine.
Sau khi hoàn tất, bạn sẽ có ba thông tin cần thiết để bắt đầu kết nối: Client ID, Client Secret và Webhooks Key.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để truy cập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Một tài khoản Xero có quyền truy cập Xero Organisation cần kết nối.
- Quyền truy cập Xero Developer Portal. Bạn có thể đăng nhập bằng tài khoản Xero hiện có.
Lưu ý: Theo yêu cầu kết nối của HexaSync, mỗi Xero Organisation phải dùng một Xero App riêng. Nếu muốn kết nối nhiều Xero Organisation, bạn cần tạo Xero App riêng cho từng Organisation.
Phần 1: Tạo Xero App và lấy thông tin xác thực
Bước 1: Tạo Xero App
- Truy cập Xero Developer Portal và đăng nhập bằng tài khoản Xero.
- Chọn New app.
- Điền thông tin theo bảng sau:
| Trường thông tin | Giá trị cần nhập hoặc lựa chọn |
|---|---|
| App name | HexaSync (tên gợi ý) |
| Integration type | Web app |
| Company or application URL | Website của doanh nghiệp hoặc ứng dụng |
| OAuth 2.0 redirect URI | Địa chỉ trong ô bên dưới |
- Tại OAuth 2.0 redirect URI, nhập chính xác địa chỉ sau:
https://app.hexasync.com/callback/install/third-party- Đánh dấu đồng ý với các điều khoản của Xero. Riêng mục Will you use Xero data to train, fine-tune, adapt, or enhance an AI model?, chọn No.
- Chọn Create app.
Lưu ý: OAuth 2.0 redirect URI phải khớp chính xác với địa chỉ trên. Nếu nhập sai, Xero có thể trả về lỗi Invalid redirect_uri khi cấp quyền kết nối.
Bước 2: Lấy Client ID và Client Secret
- Trong Xero App vừa tạo, mở Configuration.
- Tìm và sao chép Client ID.
- Chọn Generate a secret.
- Sao chép Client Secret vừa được tạo và lưu ở nơi an toàn.
| Thông tin cần lưu | Nơi lấy thông tin |
|---|---|
| Client ID | Configuration của Xero App |
| Client Secret | Giá trị hiển thị sau khi chọn Generate a secret |
Lưu ý: Sao chép Client Secret ngay khi được tạo. Không chia sẻ Client Secret công khai hoặc đưa vào ảnh chụp màn hình gửi cho người khác.
Bước 3: Thiết lập Webhooks và lấy Webhooks Key
HexaSync yêu cầu Webhooks Key trước khi bắt đầu cấp quyền kết nối với Xero. Vì Webhook URL chính thức chỉ được tạo sau khi Xero cấp quyền, bạn cần dùng URL tạm trong bước này.
- Trong Xero App, mở Webhooks.
- Tại Events, chọn Contacts và Invoices.
- Tại Delivery URL, nhập URL tạm sau:
https://app.hexasync.com/webhook- Chọn Save.
- Sao chép Webhooks Key do Xero cung cấp và lưu cùng Client ID, Client Secret.
Lưu ý: Delivery URL ở trên là URL tạm. Sau khi cấp quyền Xero thành công trên HexaSync, bạn phải thay URL này bằng Webhook URL chính thức do HexaSync cung cấp, theo Bước 5 của hướng dẫn bắt đầu với Xero.
Phần 2: Kiểm tra thông tin trước khi chuyển sang HexaSync
Bạn đã tạo Xero App và chuẩn bị được ba thông tin cần thiết:
- Client ID
- Client Secret
- Webhooks Key
Hãy lưu giữ các thông tin này an toàn để dùng khi kết nối Xero với HexaSync.
Tiếp tục với hướng dẫn bắt đầu với Xero trên HexaSync để cấp quyền truy cập Xero Organisation, cấu hình Webhook URL chính thức và tạo Xero Connector.
Phần 3: Câu hỏi thường gặp
Tôi có cần tạo tài khoản Xero Developer riêng để tạo Xero App không?
Không. Bạn có thể đăng nhập Xero Developer Portal bằng tài khoản Xero hiện có để tạo và quản lý Xero App.
Tôi có thể dùng một Xero App để kết nối nhiều Xero Organisation không?
Không. Theo yêu cầu kết nối của HexaSync, mỗi Xero Organisation phải dùng một Xero App riêng. Nếu cần kết nối nhiều Xero Organisation, hãy tạo Xero App tương ứng cho từng Organisation.
Tại sao phải dùng Delivery URL tạm khi tạo Xero App?
HexaSync cần Webhooks Key trước khi bắt đầu cấp quyền kết nối với Xero, trong khi Webhook URL chính thức chỉ được tạo sau khi Xero cấp quyền.
Vì vậy bạn nhập URL tạm https://app.hexasync.com/webhook ở Bước 3 để lấy Webhooks Key. Sau khi cấp quyền thành công, bạn thay URL tạm bằng Webhook URL chính thức do HexaSync cung cấp và xác minh Webhook.
Nhập sai OAuth 2.0 redirect URI thì sao?
Xero có thể trả về lỗi Invalid redirect_uri khi cấp quyền kết nối. Hãy mở Configuration của Xero App và sửa redirect URI cho khớp chính xác với địa chỉ ở Bước 1.