# Danh mục sản phẩm

Thêm sản phẩm bằng tay hoặc nhập từ file CSV, Google Sheet hay website của bạn, để nhân viên gửi trong chat và trợ lý AI báo giá đúng.

Danh mục là danh sách những gì bạn bán, nằm ngay trong Hạ Tầng. Khi đã có danh mục, nhân viên gửi sản phẩm cho khách dưới dạng thẻ trong bất kỳ cuộc chat nào, lên đơn chỉ với vài cú bấm, và trợ lý AI trả lời câu hỏi về giá, tồn kho dựa trên danh mục thay vì đoán.

Danh mục nằm trong ứng dụng **Sản phẩm**, ở **Sản phẩm → Danh mục**. Bạn cần quyền **Xem** với module Sản phẩm để xem và quyền **Làm việc** để thêm hoặc sửa sản phẩm.

## Nhập danh mục

Bạn hiếm khi phải gõ từng sản phẩm. Khung nhập ở đầu trang **Sản phẩm → Danh mục** có ba thẻ:

![Danh mục sản phẩm với khung nhập và danh sách sản phẩm](https://hatang.dev/help/img/vi/products/catalog.webp)

### CSV / xuất từ Excel

1. Trong Excel, lưu danh sách sản phẩm dưới dạng **CSV UTF-8**. Dòng đầu phải là tên cột.
2. Bấm **CSV / xuất từ Excel**, rồi chọn file, hoặc dán các dòng vào ô.
3. Bấm **Nhập**.

Các cột được nhận, tiếng Việt hay tiếng Anh đều được: **Tên sản phẩm** (bắt buộc), **SKU**, **Giá**, **Giá gốc**, **Ảnh** (link ảnh), **Link** (trang sản phẩm), **Danh mục**, **Tồn kho**, **Mô tả**. Cột khác bị bỏ qua. Giá viết `199000`, `199.000` hay `199,000 đ` đều được.

Dòng có SKU đã tồn tại sẽ cập nhật sản phẩm đó chứ không thêm sản phẩm thứ hai.

### Link Google Sheet

1. Trong Google Sheets, bấm **Chia sẻ** và đặt quyền "Bất kỳ ai có đường liên kết đều xem được".
2. Bấm **Link Google Sheet**, dán link rồi bấm **Nhập**.

Sheet dùng các cột giống file CSV. Muốn cập nhật thay đổi, nhập lại đúng link đó: sản phẩm được cập nhật, sản phẩm bạn đã xoá khỏi sheet bị ẩn trong Hạ Tầng (không bị xoá).

### Quét website của tôi

Nếu cửa hàng chạy trên Haravan, Sapo, Shopify hay WooCommerce, hoặc bất kỳ website nào có dữ liệu sản phẩm theo chuẩn schema.org (dữ liệu Google Shopping đọc), Hạ Tầng đọc sản phẩm thẳng từ các trang của bạn.

1. Bấm **Quét website của tôi** và gõ địa chỉ cửa hàng.
2. Để bật **Website lớn: quét trong nền** với cửa hàng nhiều trang.
3. Bấm **Nhập**.

Hạ Tầng đọc tối đa 60 trang. Khi quét trong nền, sản phẩm xuất hiện dần khi từng trang được đọc. Quét lại sẽ cập nhật sản phẩm và ẩn những sản phẩm không còn trên website.

Sau mỗi lần nhập, Hạ Tầng báo bao nhiêu sản phẩm được thêm mới, cập nhật và bị ẩn.

## Thêm hoặc sửa sản phẩm bằng tay

Bấm **Thêm sản phẩm**, hoặc bấm tên một sản phẩm để sửa.

![Một sản phẩm với giá, tồn kho, phiên bản và mô tả](https://hatang.dev/help/img/vi/products/product.webp)

| Trường | Tác dụng |
|---|---|
| **Tên** và **SKU** | Cách nhân viên tìm sản phẩm. SKU không bắt buộc nhưng giúp lần nhập sau cập nhật đúng sản phẩm |
| **Giá (₫)** | Số tiền khách trả, đã gồm VAT |
| **Giá gốc (₫)** | Giá cũ, hiện gạch ngang trên thẻ |
| **Tồn kho (để trống = không theo dõi)** | Khi về 0, sản phẩm hiện **Hết** trong danh sách và "hết hàng" khi chọn sản phẩm |
| **Danh mục** | Để lọc danh sách; nhân viên cũng tìm được theo danh mục |
| **URL ảnh** | Ảnh trên thẻ. Zalo chỉ hiện danh sách sản phẩm khi mọi sản phẩm đều có ảnh |
| **URL trang sản phẩm** | Nút **Xem** trên thẻ mở trang này |
| **Mô tả (trợ lý sẽ trích dẫn phần này)** | Điều trợ lý AI nói với khách về sản phẩm |
| **Phiên bản, mỗi dòng một: tên \| giá \| tồn kho** | Ví dụ `500g \| 720000 \| 10` |
| **Hiện với nhân viên và trợ lý** | Bỏ đánh dấu để ẩn sản phẩm mà không xoá |

Bấm **Lưu**. **Xoá** xoá hẳn sản phẩm; các đơn hàng cũ vẫn giữ nguyên dòng hàng.

### Bán trong ứng dụng di động

Nếu bạn bán nội dung số trong ứng dụng của mình, App Store và Google Play bắt buộc thanh toán qua in-app purchase. Mở **Giá trên App Store và Google Play** và điền mã sản phẩm, giá và tiền tệ bạn đã đặt trong App Store Connect và Play Console. Khách trong ứng dụng thấy giá của cửa hàng đó; xem [Bán phần mềm, gói thuê bao và mua trong ứng dụng](https://hatang.dev/vi/help/products/software-subscriptions). Khi khách bấm **Mua** trên thẻ trong ứng dụng của bạn, ứng dụng nhận các mã này để mở giao dịch của cửa hàng. Lập trình viên thiết lập phần này bằng SDK của Hạ Tầng: xem [hướng dẫn SDK](https://hatang.dev/vi/docs/guides/sdks/compatibility).

## Ẩn hoặc hiện sản phẩm

Trong danh sách, **Ẩn** và **Hiện** đổi trạng thái hiển thị của sản phẩm. Sản phẩm ẩn vẫn nằm trong danh sách, màu nhạt, nhưng nhân viên không chọn được và trợ lý AI không giới thiệu. Lọc danh sách bằng **Hiện & ẩn**, **Mọi danh mục** và ô tìm kiếm.

## Mẹo

- Viết mô tả cho khách đọc, không phải cho kho: xuất xứ, hương vị, quy cách, hợp với ai. Trợ lý AI trả lời bằng những câu đó.
- Cập nhật tồn kho thường xuyên, hoặc để trống. Tồn kho sai còn tệ hơn không có.
- Dùng cùng SKU với phần mềm bán hàng, để mỗi lần nhập lại từ file xuất của phần mềm là cập nhật được toàn bộ.