Seller SOS — Seller Operation Score
Module đánh giá chất lượng hoạt động của Seller trong hệ thống Boxme Fulfillment.
SOS (Seller Operation Score) là một hệ thống chấm điểm toàn diện, đánh giá hiệu suất hoạt động của Seller dựa trên 5 thành phần điểm chính, giúp Boxme phân loại Seller theo tier (hạng), áp dụng chính sách phí/thưởng phù hợp, và hỗ trợ Account Manager (AM) quản lý portfolio hiệu quả.
5 Thành Phần Điểm SOS
| Component | Tên | Mô tả | Default Weight |
|---|---|---|---|
| P-Score | Planning & Forecast | Chất lượng dự báo đơn hàng trước campaign | 25% |
| O-Score | Order Operations | Thời gian push đơn hàng lên WMS (% trễ) | 20% |
| T-Score | Ticket SLA | Thời gian phản hồi ticket hỗ trợ (avg hours) | 20% |
| F-Score | Finance & Payment | Thanh toán đúng hạn (worst days late) | 20% |
| I-Score | Inventory Health | Tỷ lệ tồn kho lâu (aging > 90 ngày) | 15% |
Công thức: Total SOS = Σ (Component_Raw × Weight%)
Nhóm API
| Nhóm | Base Path | Mô tả |
|---|---|---|
| Auth | /api/auth | Đăng nhập Supabase, verify session, đổi mật khẩu |
| Sellers | /api/sellers | CRUD seller, exceptions, account managers |
| Campaigns | /api/campaigns | CRUD campaigns, forecasts, actual results |
| Scores | /api/sos | Xem/tính điểm SOS, finalize, monthly scoring |
| Appeals | /api/appeals | Khiếu nại điểm SOS, quy trình review 2 cấp |
| Webhooks | /api/webhooks | Đăng ký/quản lý webhook subscriptions |
| Dashboard | /api/dashboard | Thống kê tổng quan SOS |
| Surcharges | /api/surcharges | Phụ phí do vi phạm SOS |
| Sync | /api/sync | Push dữ liệu từ OMS/WMS/Accounting/Helpdesk |
| Config | /api/config | 11 bảng cấu hình scoring (CRUD) |
| AM | /api/am | AM Portfolio scores & history |
Base URLs
SOS Production: https://boxme-sos.pages.dev/api
SOS Local Dev: http://localhost:5174/api
Health Check: GET /api/health
Quick Links
- 🏗️ Architecture & Data Model — Kiến trúc hệ thống
- 📊 Scoring Engine — Chi tiết tính điểm P/O/T/F/I
- 🔗 API Reference — Tất cả ~60 endpoints
- 🔔 Webhook Integration — Đăng ký webhook & HMAC verification
- 🔄 Data Sync — Tích hợp OMS/WMS/Accounting
- 📋 Appeals & Surcharges — Quy trình khiếu nại & phụ phí
- ⚙️ Configuration — 11 bảng cấu hình