Order Management

Dự án OMS (Order Management System) 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). OMS 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, nhân sự.

Cấu trúc Headers bắt buộc

Tất cả các API được bảo vệ bởi middleware xác thực doanh nghiệp. Mọi request bắt buộc đính kèm:

Header Key	Kiểu	Yêu cầu	Mô tả
Token-Business	string	BẮT BUỘC	Token định danh và xác thực doanh nghiệp
Content-Type	string	BẮT BUỘC	Luôn truyền application/json

POST /product/get_product HTTP/1.1
Host: api-product.merchant.vn
Content-Type: application/json
Token-Business: your_secret_business_access_token

Danh sách API Modules

Đơn hàng & Sản phẩm

• Quản lý Sản phẩm (Product) — CRUD sản phẩm, đồng bộ biến thể, bảng giá nâng cao, import hàng loạt
• Biến thể (Variant) — Quản lý biến thể sản phẩm
• Quản lý Addon — Addon và nhóm addon dùng kèm sản phẩm/đơn hàng
• Quản lý Danh mục (Category) — Thiết lập, lấy danh sách và cập nhật danh mục
• Quản lý Đơn hàng (Order) — Tạo, cập nhật, thao tác nhanh, thống kê, export, thanh toán
• Quản lý Package — Gói dịch vụ

Kho & Vận hành

• Quản lý Tồn kho (Inventory) — Lịch sử nhập/xuất kho, đồng bộ số lượng tồn kho
• 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ã và chuẩn hóa địa chỉ
• Vận chuyển (Shipping) — Tài khoản vận chuyển, dịch vụ, phí, đơn giao hàng
• Theo dõi vận đơn (Tracking) — Hành trình đơn hàng

Tài chính & Đối tác

• Quản lý Billing — Phiếu nhập kho và trạng thái billing
• Thanh toán (Payment) — Cập nhật thanh toán và gửi sự kiện qua webhook
• Khách hàng thân thiết (Loyalty) — Hạng thành viên loyalty
• Nhà cung cấp (Vendor) — Quản lý nhà cung cấp

Tích hợp & Hệ thống

• Quản lý Tích hợp (Integration) — Cấu hình, ủy quyền và đồng bộ nền tảng
• Webhook Đối tác — Đăng ký và quản lý webhook cho đối tác
• Webhook — Webhook nhận sự kiện từ đơn vị vận chuyển và nền tảng tích hợp
• API Công khai (Public) — API cho selling page, app nhúng và khách hà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à lịch sử

Database

Sử dụng PostgreSQL qua Prisma ORM. Schema định nghĩa tại prisma/schema.prisma.

pnpm prisma:dev    # Migration môi trường dev