# Kiotviet

<div align="left"><img src="https://help.bluecore.vn/assets/imgs/img-connector/image29.gif" alt=""> <figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/oHNpu2fMkFzZtzBdDw1w/image29.gif" alt=""><figcaption></figcaption></figure></div>

Chuyển dữ liệu từ KiotViet đến Data Warehouse (BigQuery) trong vài phút. Dữ liệu sẽ được cập nhật vào lúc 0h mỗi ngày.

**Hướng dẫn kết nối KiotViet**

Bước 1: Chọn biểu tương **“Add connection”** ở bên phải logo KiotViet để kết nối với cửa hàng KiotViet của bạn

Xuất hiện bảng Connect to KiotViet. Bắt đầu kết nối bằng cách sau đây

<div><img src="https://help.bluecore.vn/assets/imgs/img-connector/image30.png" alt=""> <figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/MudMZWv9QWrNRVhCJe53/image30.png" alt=""><figcaption></figcaption></figure></div>

Bước 2: Mở 1 tab mới để truy cập vào trang quản lý bán hàng của Kiotviet. **Chọn “Thiết lập cửa hàng”**

<div><img src="https://help.bluecore.vn/assets/imgs/img-connector/image31.png" alt=""> <figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/ecLJvQtAOFUwcWwAsrE0/image31.png" alt=""><figcaption></figcaption></figure></div>

Bước 3: Ở cột bên trái, **kéo chọn “Thiết lập kết nối API”**

<div><img src="https://help.bluecore.vn/assets/imgs/img-connector/image32.png" alt=""> <figure><img src="https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/DSaZpuVHfi7rk2jD3Ha3/image32.png" alt=""><figcaption></figcaption></figure></div>

Bước 4: Xuất hiện bảng **“Thiết lập kết nối API”**. **Sao chép “Client ID” và “Mã bảo mật”.** Nếu **chưa có**Mã bảo mật, bạn hãy chọn **“Tạo mã”** để lấy Mã bảo mật mới.

![img-description](https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/ZeWGrOyLYl7TT0S1VwDV/image33.png) ![img-description](https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/H1hHtRToC6joxZQSOgqg/image34.png)

Bước 5: Trở lại website admin và **dán “Client ID”** và **“Mã bảo mật”** vào hai ô tương ứng ![img-description](https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/BxAYdY9S3KpPMxnhetgt/image35.png)

Bước 6: Chọn **Connect** để hoàn tất việc kết nối với cửa hàng KiotViet của bạn

Bước 7: Kết nối thành công vào Bluecore. Đợi một vài phút để tải dữ liệu từ cửa hàng KiotViet của bạn đổ về Bluecore

![img-description](https://content.gitbook.com/content/QAQ4hFJypvowstD5XZfm/blobs/lafzw4kiua8ylXSASbnz/image37.png)

**Lưu ý:**

* Dữ liệu sẽ được cập nhật vào lúc 0h mỗi ngày
* n Active Connections: n là số tài khoản được kết nối với Bluecore

**Những dữ liệu được chia sẻ với Bluecore:**

* Nhóm hàng: lấy danh sách nhóm hàng hóa với các thông tin về tên nhóm hàng và quan hệ giữa các nhóm hàng
* Hàng hóa: lấy thông tin sản phẩm, tạo mới, sửa, xóa sản phẩm, thuộc tính của sản phẩm
* Đặt hàng: lấy thông tin đơn hàng, tạo đơn hàng, cập nhật và hủy đơn hàng
* Hóa đơn: lấy thông tin hóa đơn, tạo hóa đơn, cập nhật và hủy hóa đơn
* Khách hàng: lấy danh sách khách hàng và thao tác trên thông tin khách hàng
* Phiếu nhập hàng: thông tin phiếu nhập
* Các API phụ trợ:
  * Danh sách chi nhánh
  * Danh sách người dùng
  * Danh sách tài khoản ngân hàng
  * Danh sách thu khác
  * Webhook
  * Nhóm khách hàng
  * Sổ quỹ

<br>