Bỏ qua tới nội dung

Ứng dụng khác

Kết nối REST API tùy biến với DataxLand

Connector REST API tùy biến của DataxLand đọc dữ liệu JSON từ API của phần mềm bất kỳ - POS, phần mềm bán hàng, kho, CRM hay ERP nội bộ - khi chưa có connector dựng sẵn. Ví dụ, nếu phần mềm quản lý bán hàng bạn đang dùng (Haravan, Sapo, KiotViet, Nhanh.vn hay phần mềm khác) có REST API, bạn khai địa chỉ gốc, cách xác thực và từng endpoint cần đọc; mỗi endpoint thành một bảng trong kho của workspace. Connector chỉ gọi GET và chỉ gọi đúng máy chủ của địa chỉ gốc, nên không thể ghi hay xóa gì trên hệ thống của bạn.

Gói Miễn phí không thời hạn · Không cần thẻ thanh toán · Workspace mẫu mở trong vài phút

Làm được gì với REST API tùy biến

  • Đưa đơn hàng, sản phẩm và tồn kho từ phần mềm bán hàng có API vào dashboard lãi lỗ đa kênh.
  • Ghép dữ liệu phần mềm nội bộ với sàn, quảng cáo và bảng giá vốn trên Google Sheets.
  • Thử nghiệm nhanh một nguồn mới trước khi có connector riêng cho nó.

Dữ liệu bạn nhận được

Mỗi luồng thành một bảng riêng trong kho của workspace, giữ nguyên trạng; cột thông tin cá nhân được băm khi nạp.

Luồng (bảng)Nội dung
<tên endpoint>Mỗi endpoint bạn khai (tên bảng, đường dẫn, tham số) thành một bảng raw.<tên nguồn>__<tên endpoint>.
đường dẫn bản ghiChỉ ra danh sách bản ghi trong phản hồi, ví dụ data.items; để trống nếu phản hồi là danh sách.
phân trangTheo số trang, theo limit/offset, theo con trỏ hoặc theo link trang sau (kể cả header Link).

Thông tin kết nối

Cách đăng nhậpĐiền thông tin kết nối (khóa API, tài khoản); được mã hóa khi lưu
Cách đồng bộToàn bộ (nạp lại mỗi lần)
Thông tin cần điềnĐịa chỉ gốc API, Endpoint
Nhà phát triểnDataxLand
Giấy phépMIT

Mật khẩu và khóa được mã hóa khi lưu. Cột thông tin cá nhân được băm khi nạp.

Chỉ số tính từ nguồn này

Định nghĩa thật trong gói phân tích; dashboard và Si dùng chung.

Chỉ sốĐịnh nghĩaĐơn vị
Doanh thu thuầnGiá trị dòng sau giảm giá dòng và voucher đơn đã phân bổ, trừ tiền hoàn cho người mua. Tiền hoàn chỉ trừ ở đây.Tiền (₫)
Số đơn hợp lệSố đơn không bị hủy (trạng thái chuẩn khác cancelled).Số lượng
Giá trị đơn trung bìnhDoanh thu dòng sau giảm giá chia số đơn hợp lệ.= line_net_total / Số đơn hợp lệTiền (₫)
Số sản phẩm bán raTổng số lượng sản phẩm trong các dòng đơn thuộc đơn hợp lệ.Số lượng
Tỷ lệ hủySố đơn hủy chia tổng số đơn.= cancelled_orders / all_ordersTỷ lệ (%)
Giá trị tồn kho bình quânBình quân giá trị tồn kho cuối ngày trong kỳ = tổng giá trị các ảnh chụp chia số ngày có ảnh chụp.= ops_inventory_value_total / ops_snapshot_daysTiền (₫)

Kết nối REST API tùy biến trong 3 bước

  1. 1

    Khai địa chỉ và xác thực

    Trong workspace chọn Thêm nguồn → REST API tùy biến, dán địa chỉ gốc (https://…), chọn xác thực - không có, API key, Bearer token, Basic hoặc OAuth2 client credentials.

  2. 2

    Khai endpoint

    Thêm tối đa 20 endpoint, mỗi cái có tên bảng, đường dẫn, tham số (dùng được {{ start_date }}), đường dẫn tới danh sách bản ghi, khóa chính và kiểu phân trang.

  3. 3

    Kiểm tra và duyệt

    Bấm Kiểm tra kết nối, xem mẫu dữ liệu; Si đề xuất mỗi bảng là gì trong mô hình chuẩn, bạn duyệt rồi build.

Lưu ý và giới hạn

  • Mỗi lần làm mới đọc lại toàn bộ các endpoint; dùng tham số ngày với {{ start_date }} để giới hạn khoảng dữ liệu.
  • Mỗi endpoint tối đa 1.000 trang; thời gian chờ mỗi lần gọi mặc định 30 giây, tối đa 300 giây.
  • Bí mật chỉ nhập ở mục Xác thực (được mã hóa, không hiển thị lại); không đặt khóa vào header hay tham số.
  • DataxLand chưa có connector riêng cho Haravan, Sapo, KiotViet hay Nhanh.vn; cách này phụ thuộc vào API mà nhà cung cấp phần mềm mở cho bạn.

Câu hỏi thường gặp

Connector có ghi dữ liệu lên hệ thống của tôi không?

Không. Connector chỉ gọi GET và chỉ tới đúng máy chủ của địa chỉ gốc; địa chỉ trong mạng nội bộ bị chặn.

API trả XML hoặc CSV thì sao?

Connector đọc JSON. Với CSV, dùng Excel, Google Sheets hoặc nạp vào Postgres trước.

Cần biết lập trình không?

Cần hiểu tài liệu API của phần mềm (endpoint, xác thực, phân trang); không cần viết code.

Mẫu dashboard dùng nguồn này

Hỏi Si về dữ liệu REST API tùy biến →Mọi nguồn dữ liệu →

Kết nối REST API tùy biến và có dashboard đã kiểm số

Gói Miễn phí không thời hạn · Không cần thẻ thanh toán · Workspace mẫu mở trong vài phút