# Kiotviet

<div align="left"><img src="https://help.bluecore.vn/assets/imgs/img-connector/image29.gif" alt=""> <figure><img src="https://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FH5f2Ty06rkftc2BARtmB%2Fimage29.gif?alt=media&#x26;token=85d0bd4a-3be0-4ec7-b74a-1af282757cdf" 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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FBNMSxSKPTFQKfZResAQa%2Fimage30.png?alt=media&#x26;token=d5d08123-70a4-49e1-9834-b7d901744afe" 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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FavCSUC3BJi1xhfbIFVXE%2Fimage31.png?alt=media&#x26;token=08fd5459-8422-4178-a91b-128b8fe484f3" 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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FH9c4QfpGvZvKEu9SZUcd%2Fimage32.png?alt=media&#x26;token=0cf07247-0b2e-4224-b2ea-9ec7d5107327" 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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2Ffh8hivL6UbaVHFymNJij%2Fimage33.png?alt=media\&token=890025dd-88bf-46a7-aa87-534a13879936) ![img-description](https://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FbyTvhqKBJye6YBQdxn3O%2Fimage34.png?alt=media\&token=df8c6454-2461-4d30-b04b-2a55deab94d5)

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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2F3i1WlPOK4g7gySfvhWDS%2Fimage35.png?alt=media\&token=f2230b14-61a4-4c8b-9b0c-d78c126a1a73)

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://2953987133-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzlvhRjpaWG84FbkpbQ7S%2Fuploads%2FNoA5Htq3VGF6mmFAPx0Z%2Fimage37.png?alt=media\&token=262c8deb-dc47-4d39-96e2-9e4d0a63c016)

**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>
