Bot Bán Hàng — Developer Docs
Tài liệu kỹ thuật dành cho developer của nền tảng Bot Bán Hàng — hệ thống quản lý bán hàng, thanh toán và vận hành đơn hàng cho Merchant Việt Nam.
Giới thiệu dự án
Bot Bán Hàng là trung tâm điều phối và lưu trữ tất cả các hoạt động bán hàng của doanh nghiệp (Merchant). Hệ thống hỗ trợ đồng bộ dữ liệu đa kênh (từ các sàn thương mại điện tử, Facebook, POS) và cung cấp các dịch vụ tối ưu hóa vận hành, quản lý kho bãi, thanh toán.
Tài liệu được cấu trúc theo dạng module hóa, giúp các nhà phát triển dễ dàng tích hợp và phát triển thêm các ứng dụng vệ tinh cho hệ sinh thái Merchant Apps.
Hệ thống gồm những gì?
| Service | Mô tả | Tech Stack |
|---|---|---|
| api_oms | Quản lý đơn hàng — sản phẩm, tồn kho, giao vận, billing, loyalty | NestJS · Prisma · PostgreSQL |
| api_payment | Cổng thanh toán đa nền tảng | NestJS |
| web_payment | Giao diện thanh toán cho khách hàng | Next.js · React |
Bắt đầu
- Kiến trúc hệ thống — Tổng quan kiến trúc và cách các service kết nối
- Thiết lập môi trường — Cài đặt và chạy project local
- Quy tắc code — Coding standards và quy trình làm việc của team
API Modules
Order Management (api_oms)
- Quản lý Sản phẩm (Product) — CRUD sản phẩm, đồng bộ biến thể, bảng giá, import hàng loạt
- Quản lý Addon — Addon và nhóm addon dùng kèm sản phẩm/đơn hàng
- Quản lý Billing — Phiếu nhập kho và trạng thái billing
- Quản lý Danh mục (Category) — Thiết lập và cập nhật danh mục
- Quản lý Tích hợp (Integration) — Cấu hình, ủy quyền và đồng bộ nền tảng
- Quản lý Tồn kho (Inventory) — Lịch sử nhập/xuất kho, đồng bộ số lượng
- Kiểm kê kho (Inventory Auditing) — Lịch sử kiểm kê kho hàng
- Quản lý Nhãn (Label) — Nhãn phân loại dữ liệu
- Địa chỉ (Locations) — Tra cứu tỉnh, huyện, xã
- Khách hàng thân thiết (Loyalty) — Hạng thành viên loyalty
- Quản lý Đơn hàng (Order) — Tạo, cập nhật, thống kê, export, thanh toán đơn hàng
- Quản lý Package — Gói dịch vụ
- Webhook Đối tác — Đăng ký webhook cho đối tác
- Thanh toán (Payment) — Cập nhật và gửi sự kiện thanh toán
- API Công khai (Public) — API cho selling page, app nhúng
- Báo cáo (Report) — Báo cáo tổng hợp
- Thiết lập (Setting) — Thiết lập hệ thống
- Vận chuyển (Shipping) — Tài khoản vận chuyển, dịch vụ, phí, đơn giao
- Theo dõi vận đơn (Tracking) — Hành trình đơn hàng
- Biến thể (Variant) — Biến thể sản phẩm
- Nhà cung cấp (Vendor) — Quản lý nhà cung cấp
- Webhook — Webhook từ đơn vị vận chuyển và nền tảng tích hợp
Payment Gateway (api_payment)
- Tổng quan Payment — Cổng thanh toán đa nền tảng