Skip to main content

Nhanh.vn

info

Phần hướng dẫn tạo source data từ Nhanh.vn này sẽ bao gồm hai phần:

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

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

note

Sau khi đã thao tác các bước nền là chọn source và vào được trang setup source chi tiết, bạn tiến hành thao tác điền các trường thông tin cần thiết như hướng dẫn dưới đây. Hướng dẫn các bước nền để tạo source trên Elton bạn có thể xem ở phần Getting Started - Mục Thiết lập Source.

Bước 1: Điền các trường thông tin cần thiết​

(1) Tại giao diện setup data source của Nhanh.vn, 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 Nhanh.vn của bạn.
  • Description: Mô tả của source nếu có

(2) Mục Connection - Business Name:

  • Trong một vài trường hợp, công ty của bạn có thể sở hữu nhiều hơn 1 tài khoản (account) trên Nhanh.vn. Trong các trường hợp đó, trường thông tin Business Name sẽ được dùng để khi lấy data từ source Nhanh.vn về sẽ phân biệt được data đến từ account nào.

  • Ví dụ, bạn khi điền Business Name = Maverick 1234, thì khi các bảng dữ liệu được lấy từ Nhanh.vn của account tương ứng được đánh dấu sẽ có thêm prefix maverick_1234 như hình.

(3) Sau khi hoàn tất điền các thông tin của source ở (1) và (2), bạn nhấn lưu => hệ thống sẽ đưa về trang thông tin chi tiết của source bạn vừa tạo.

Bước 2: Trao quyền từ source đã thiết lập​

  • Tại trang thông tin chi tiết của source bạn vừa tạo => Nhấn chọn nút Authorize để tiền hành trao quyền cho phép Elton truy cập vào dữ liệu của source.

  • Đối với trường hợp Source là Nhanh.vn thì hệ thống sẽ tự động đưa bạn qua trang đăng nhập của Nhanh.vn

  • Bạn tiến hành đăng nhập với account Nhanh.vn của mình

  • Tiếp theo, Nhanh.vn sẽ yêu cầu bạn thao tác chọn các dữ liệu cụ thể của account để tiến hành trao quyền cho Elton.

  • Trong một vài trường hợp, khi bạn nhấn Đồng ý, hệ thống sẽ báo lỗi về việc account công ty của bạn chưa mở quyền cho phép kết nối Open API - một dạng kết nối cho phép Elton kéo dữ liệu của bạn về (xem hình bên dưới).

  • Trong trường hợp đó, bạn theo hướng dẫn của Nhanh.vn để tiết hành bật chế độ cho phép kết nối Open API. HD kết nối bạn có thể xem thêm ở link này: https://apidocs.nhanh.vn/#dang-nhap-cap-quyen
warning

  • Tại màn hình trao quyền trên Nhanh.vn sẽ có phần phân quyền cho Elton truy cập dữ liệu của Customer của doanh nghiệp của bạn.

  • Mặc dù giao diện có hiển thị tick xanh và cho phép bạn thực hiện phân quyền, thực chất chỉ có account Nhanh.vn quyền giám đốc mới thực sự có thể phân quyền truy cập data customer.

  • Vì vậy, trong một vài trường hợp nếu account của bạn không phải quyền giám đốc, việc phân quyền truy cập data customer cho Elton sẽ không thành công khi bạn setup xong

  • Để trao quyền sử dụng customer data, bạn cần đảm bảo rằng account của mình là quyền giám đốc

  • Sau khi thực hiện trao quyền xong, hệ thống sẽ đưa bạn về tab "Data Sources", bạn sẽ thấy source mới tạo nằm ở trên đầu danh sách các source đã có, bạn thao tác nhấn chọn source và có thể xem được thông tin chi tiết của source đó.

  • Tại chi tiết của source, bạn có thể tao tác edit, delete, disable hoặc re-authorize account Nhanh.vn của mì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ừ Nhanh.vn​

Tại mục Source Config của màn hình setup chi tiết connection có source là Nhanh.vn, các trường thông tin bạn cần điền sẽ có ý nghĩa như sau:

1. Select a Nhanhvn Account​

  • Tại đây hệ thống sẽ đề xuất các source Nhanh.vn mà bạn đã tạo, bạn thao tác chọn source mà bạn mong muốn connect.

2. Select 1 or many type of data​

  • Hệ thống sẽ đề xuất danh sách các loại dữ liệu trong source Nhanh.vn mà bạn đã trao quyền, bạn thao tác chọn các loại dữ liệu mong muốn để tạo connection.
note

Trong trường hợp hệ thống không tự đề xuất danh sách các loại dữ liệu trong source, lý do có thể xuất phát từ việc bạn chưa trao quyền (authorize) source Nhanh.vn thành công. Truy cập và phần data source => chọn source Nhanh.vn đích để tiến hành trao quyền lại.

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 Nhanh.vn 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ừ ngày đầu tiên.

  • Vì vậy, Incremental load - Time range to scan Là số ngày tính từ ngày chạy mà hệ thống sẽ scan trở về trước

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

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