Skip to main content

KiotViet Retail & KiotViet F&B

info

Vì đặc thù cài đặt của hai dạng account trên KiotViet (KiotViet Retail & KiotViet F&B) là giống nhau, phần hướng dẫn thiết lập source và connection từ hai nguồn này - gọi chung là KiotViet - sẽ bao gồm hai phần:

  1. Hướng dẫn thiết lập Source từ KiotViet
  2. Hướng dẫn điền các trường thông tin khi setup Connection với Source là từ KiotViet

Phần 1: Hướng dẫn thiết lập Source từ KiotViet​

Tại giao diện setup data source của KiotViet -> bạn thao tác điền các thông tin định danh cho source chuẩn bị tạo:

  • Display name: Tên hiển thị của source. Elton khuyến khích bạn đặt tên có mối liên hệ với account KiotViet của bạn.

  • Description: Mô tả của source nếu có

  • Client ID và Client secret: Đây là hai trường thông tin bạn cần phải truy suất từ account Kiotviet của mình. Bạn truy cập vào đường link ở đây để thực hiện lấy hai thông tin này. Trong đó: Field Client ID sẽ tương ứng với Client ID; Client Secret sẽ tương ứng với Mã bảo mật.

  • Shop name: Bạn thao tác điền tên gian hàng của mình trên KiotViet

  • Sau khi điền xong các trường thông tin, bạn nhấn Save để hoàn thành.

Phần 2: Hướng dẫn điền các trường thông tin khi setup Connection với Source là từ KiotViet​

General info​

1. Name: Tên của cài đặt connection bạn sắp tạo.

2. Description: Mô tả của cài đặt connection bạn sắp tạo

3. Sync Frequency: Chọn khoản thời gian định kỳ mà bạn muốn dữ liệu của connection sắp tạo được cập nhật. Ví dụ: Nếu bạn chọn option là Every 1 hour, thì cứ mỗi 1 tiếng hệ thống sẽ tự chạy và sync dữ liệu một lần.

Source config​

1. Select KiotViet/KiotVietFnB Shop: Chọn gian hàng trên KiotViet mà bạn muốn tạo connection với.

2. Select 1 or many type of reports: Hệ thống sẽ đề xuất danh sách các bảng dữ liệu trong source KiotViet mà bạn trao quyền, bạn thao tác chọn các report mong muốn tạo connection.

3. First load - Load data since

  • Thể hiện mốc thời gian mà bạn mong muốn dữ liệu của bạn sẽ được tải lên từ lúc đó trở đi.

  • Ví dụ: Bạn chọn ngày load data là 15/10/2023 => Hệ thống sẽ sync toàn bộ dữ liệu của source KiotViet của bạn kể từ ngày 15/10/2023 đến hiện tại.

4. Incremental load - Time range to scan

  • Cách quét dữ liệu định kỳ của Elton đi theo hướng tịnh tiến (incremental) - có nghĩa là định kì hệ thống sẽ thực hiện quét dữ liệu cũ theo hướng tịnh tiến, theo một khoản thời gian được cài đặt trước, chứ không phải mỗi lần quét lại là sẽ quét lại toàn bộ dữ liệu phát sinh từ ngay đầu tiên.

  • Vì vậy, Incremental load - Time range to scan là số ngày mà hệ thống sẽ tiến hành scan dữ liệu từ ngày được cài đặt ở trường thông tin này tới hiện tại.

  • Ví dụ: User chọn option là last 1 day thì hôm nay hệ thống sẽ tiến hành scan data kể từ ngày hôm qua đến hôm nay. Nếu chọn last 7 days thì hôm nay sẽ scan dữ liệu của 7 ngày trước đó tới hiện tại.

Add-on: Cách tính Billable Pipeline cho source​

  • Khi sử dụng Elton, bạn sẽ được thông báo về cách mà hệ thống sẽ tính phí sử dụng dịch vụ. Cách tính hiện tại chủ yếu dựa trên số pipeline bạn tạo.

  • Tuỳ từng loại source mà cách tính số lượng pipeline giới hạn sẽ khác nhau. Để biết thêm chi tiết, bạn vui lòng tham khảo cách tính ở link ở đây.

Last updated on