OpenAPI / Swagger Gateway • Version RC29
Bộ API Chuẩn MISA Store (`/APIs/store/*`)
Tương thích 1:1 với cấu trúc 13 Controllers trên
https://store.misa.vn/APIs/store (Products, Companys, Locations, CartOrders, CheckOuts, Licenses, Accounts, FormLayouts, Validates, Quotes, Billings, Sockets, AutoDebitCharges).
1. Companys — Tra cứu Mã số thuế & Định danh Doanh nghiệp / HKD
Controller: /APIs/store/Companys (class tq extends Ka)
getCompanyInfoByTaxCode — Tra cứu thông tin doanh nghiệp & chi nhánh theo MST
getCompanyInfoByIdentityCode — Tra cứu theo CCCD chủ hộ / Mã định danh HKD
2. Locations — Danh mục Tỉnh/TP, Phường/Xã & Tách Địa chỉ tự động
Controller: /APIs/store/Locations (class bz extends Ka)
separationAddressV2 — Tự động bóc tách chuỗi địa chỉ thành Quốc gia, Tỉnh/TP, Phường/Xã, Số nhà
getLocationV2 (Kind=1) — Lấy toàn bộ 34 Tỉnh/Thành phố Việt Nam
Request JSON Payload:
getLocationV2 (Kind=3) — Lấy danh sách Phường/Xã theo mã Tỉnh/Thành phố (VD: VN01 - Hà Nội)
Request JSON Payload:
3. Products — Danh mục Sản phẩm, Báo giá Gói thuê bao & Mua kèm
Controller: /APIs/store/Products (class Hz extends Ka)
GetAllProductHomePage — Danh sách nhóm ngành hàng & sản phẩm trang chủ MISA Store
getAllProducts — Toàn bộ sản phẩm đang kinh doanh
getTemplateProduct — Chi tiết gói cước, chu kỳ & dịch vụ mua kèm theo ID/Code (679 hoặc SME)
getActiveProduct — Lấy thông tin sản phẩm theo ProductID & ApplicationCode
Request JSON Payload:
getProductIDAppCodeMappings — Ánh xạ ProductID và AppCode
Request JSON Payload:
getProductExchange — Tra cứu thông tin bản quyền SME & danh sách sản phẩm chuyển đổi theo MST
Request JSON Payload:
4. CartOrders — Giỏ hàng, Tính giá, Voucher & Lịch sử đơn hàng
Controller: /APIs/store/CartOrders (class mQ extends Ka)
init — Khởi tạo phiên giao dịch giỏ hàng (TransactionID)
Request JSON Payload:
getCartDetail — Lấy chi tiết giỏ hàng, dịch vụ mua kèm & ưu đãi hiện tại
searchVoucherV3 / applyVoucherV3 — Kiểm tra và áp dụng mã giảm giá (VD: MISA2026)
Request JSON Payload:
getPromotionCampaigns — Danh sách chương trình khuyến mại & mã quà tặng đang mở
getAllRelatedProducts — Danh sách sản phẩm/dịch vụ thường được mua cùng (Upsell Add-ons)
getHistoryOrder — Tra cứu danh sách đơn hàng có phân trang
Request JSON Payload:
searchHistoryOrderCode — Tra cứu chi tiết đơn hàng, VietQR & License theo mã đơn
5. CheckOuts — Đặt hàng, Thỏa thuận mua hàng & Thanh toán JetPay/VietQR
Controller: /APIs/store/CheckOuts (class Gz extends Ka)
validateCheckout — Kiểm tra hợp lệ thông tin đơn vị & người mua trước khi tạo đơn
Request JSON Payload:
checkouts — Tạo đơn đặt hàng mới và sinh mã thanh toán VietQR tự động
Request JSON Payload:
getLicenseFromTaxCode — Tra cứu danh sách Giấy phép sử dụng (License) theo MST
getPurchaseAgreement — Nội dung Thỏa thuận mua hàng & Nghị định 13/2023/NĐ-CP
6. Licenses, Accounts, FormLayouts, Validates, Quotes, Sockets, AutoDebit
Các Controllers phụ trợ trong hệ sinh thái /APIs/store/
Licenses/GetLicenseInfo (MISA Store v3) — Tra cứu License thực tế theo mảng [ { taxCode, productcode, ordertype } ]
Request JSON Payload:
Licenses/GetLicenseSMEInfo — Tương thích ngược v2 (tự động cầu nối sang POST Licenses/GetLicenseInfo + Products/GetProductExchangeInfo)
Licenses/CalculationLicense — Tính phí gia hạn / mua thêm tài nguyên bản quyền
Request JSON Payload:
Accounts/user-info — Thông tin tài khoản MISA ID đang đăng nhập
FormLayouts/ListJobTitleActive — Danh mục Chức danh người mua hàng chuẩn MISA Store
Validates/ValidateIdentifier — Xác thực định dạng & trạng thái hoạt động của MST/CCCD
Sockets/gettoken — Cấp Token kết nối WebSocket nhận thông báo thanh toán tức thì
Request JSON Payload:
7. OrderHistorys — Popup Tra cứu đơn hàng theo Mã số thuế hoặc Email mua hàng
Controller: /APIs/store/OrderHistorys (OrderHistoryAPI.cace841d.js trên store.misa.vn/home)
getOrderHistory (Theo MST) — Tra cứu danh sách đơn hàng theo Mã số thuế (VD: 0106145319)
Request JSON Payload:
getOrderHistory (Theo Email) — Tra cứu danh sách đơn hàng theo Email mua hàng (VD: [email protected])
Request JSON Payload:
confirmOrderEmail — Xác thực địa chỉ Email mua hàng để nhận mã OTP xem chi tiết đơn
Request JSON Payload:
confirmOrderOTP — Xác thực mã OTP để nhận hashCode mở chi tiết đơn hàng
Request JSON Payload: