Hướng dẫn API SIVIP Online

Xác thực (Authentication)

API sử dụng Bearer Token (JWT) cho xác thực.

Bearer Token (JWT)

POST /login
Content-Type: application/x-www-form-urlencoded
Body: username={user}&password={pass}&grant_type=password

Response: { "access_token": "...", "token_type": "bearer", "expires_in": 43199 }
Cách dùng: Authorization: Bearer {access_token}

Tài khoản (Account)

STT	Method	Route	Mô tả	Auth
1	POST	/api/taikhoan/xem	Xem tài khoản	Bearer
Click để xem chi tiết...

Báo cáo (Reports)

STT	Method	Route	Mô tả	Auth
1	POST	/api/baocao/RptBanhang	Báo cáo bán hàng	Bearer
Click để xem chi tiết...
2	POST	/api/bctcongno	BC tổng công nợ	Bearer
Click để xem chi tiết...
3	POST	/api/baocao/nhapxuatton	BC nhập xuất tồn	Bearer
Click để xem chi tiết...
4	POST	/api/bcdtcp	BC doanh thu chi phí	Bearer
Click để xem chi tiết...
5	POST	/api/baocao/soquy	BC sổ quỹ	Bearer
Click để xem chi tiết...
6	POST	/api/bctonkho	BC tồn kho	Bearer
Click để xem chi tiết...

Khách hàng (Customer)

STT	Method	Route	Mô tả	Auth
1	POST	/api/khachhang/taomoi	Tạo mới khách hàng	Bearer
Click để xem chi tiết...
2	POST	/api/khachhang/goiyma	Gợi ý mã khách hàng	Bearer
Click để xem chi tiết...
3	POST	/api/khachhang/sua	Sửa khách hàng	Bearer
Click để xem chi tiết...
4	POST	/api/khachhang/xoa	Xóa khách hàng	Bearer
Click để xem chi tiết...
5	POST	/api/khachhang/xem	Xem danh sách khách hàng	Bearer
Click để xem chi tiết...

Đơn hàng (Sales Order - DXA)

STT	Method	Route	Mô tả	Auth
1	POST	/api/donhang/tao	Tạo đơn hàng	Bearer
Click để xem chi tiết...
2	POST	/api/donhang/xem	Xem đơn hàng	Bearer
Click để xem chi tiết...

Chi phí (Expense)

STT	Method	Route	Mô tả	Auth
1	POST	/api/phi/xem	Xem danh sách chi phí	Bearer
Click để xem chi tiết...

Nhóm (Group)

STT	Method	Route	Mô tả	Auth
1	POST	/api/nhkh/xem	Xem nhóm khách hàng	Bearer
Click để xem chi tiết...
2	POST	/api/nhkh/moi	Thêm nhóm khách hàng	Bearer
Click để xem chi tiết...
3	POST	/api/nhphi/xem	Xem nhóm phí	Bearer
Click để xem chi tiết...
4	POST	/api/nhphi/moi	Thêm nhóm phí	Bearer
Click để xem chi tiết...
5	POST	/api/nhvt/xem	Xem nhóm vật tư	Bearer
Click để xem chi tiết...
6	POST	/api/nhvt/moi	Thêm nhóm vật tư	Bearer
Click để xem chi tiết...
7	POST	/api/nhvv/xem	Xem nhóm nhân viên	Bearer
Click để xem chi tiết...
8	POST	/api/nhvv/moi	Thêm nhóm nhân viên	Bearer
Click để xem chi tiết...

Hóa đơn (Invoice - HDA)

STT	Method	Route	Mô tả	Auth
1	POST	/api/hoadon/tao	Tạo hóa đơn	Bearer
Click để xem chi tiết...
2	POST	/api/hoadon/xem	Xem hóa đơn	Bearer
Click để xem chi tiết...
3	POST	/api/hoadon/in	In hóa đơn	Bearer
Click để xem chi tiết...
4	POST	/api/hoadon/inimg	In hóa đơn (hình ảnh)	Bearer
Click để xem chi tiết...
5	POST	/api/hdagct/tao	Tạo hóa đơn GCT	Bearer
Click để xem chi tiết...
6	POST	/api/hoadongct/xem	Xem hóa đơn GCT	Bearer
Click để xem chi tiết...
7	POST	/banle/capnhat	Cập nhật bán lẻ	None
Click để xem chi tiết...

Vật tư (Items)

STT	Method	Route	Mô tả	Auth
1	POST	/api/vattu/xem	Xem danh sách vật tư	Bearer
Click để xem chi tiết...
2	POST	/api/vattu/taomoi	Tạo mới vật tư	Bearer
Click để xem chi tiết...
3	POST	/api/vattu/taomoitt88	Tạo mới vật tư TT88	Bearer
Click để xem chi tiết...
4	POST	/api/vattu/sua	Sửa vật tư	Bearer
Click để xem chi tiết...
5	POST	/api/vattu/suatt88	Sửa vật tư TT88	Bearer
Click để xem chi tiết...
6	POST	/api/vattu/xoa	Xóa vật tư	Bearer
Click để xem chi tiết...
7	POST	/api/vattu/chitiet	Xem chi tiết vật tư	Bearer
Click để xem chi tiết...
8	POST	/api/loaivt/xem	Xem loại vật tư	Bearer
Click để xem chi tiết...
9	POST	/api/nhomvt1/xem	Xem nhóm vật tư 1	Bearer
Click để xem chi tiết...
10	POST	/api/nhomvt2/xem	Xem nhóm vật tư 2	Bearer
Click để xem chi tiết...
11	POST	/api/nhomvt3/xem	Xem nhóm vật tư 3	Bearer
Click để xem chi tiết...

Công việc (Job)

STT	Method	Route	Mô tả	Auth
1	POST	/api/vuviec/xem	Xem danh sách công việc	Bearer
Click để xem chi tiết...

Nhập xuất kho (Warehouse)

STT	Method	Route	Mô tả	Auth
1	POST	/api/nhapkho/tao	Tạo phiếu nhập kho	Bearer
Click để xem chi tiết...
2	POST	/api/nhapkho/xem	Xem phiếu nhập kho	Bearer
Click để xem chi tiết...
3	POST	/api/xuatkho/tao	Tạo phiếu xuất kho	Bearer
Click để xem chi tiết...
4	POST	/api/xuatkho/xem	Xem phiếu xuất kho	Bearer
Click để xem chi tiết...

Mua hàng (PNA)

STT	Method	Route	Mô tả	Auth
1	POST	/api/pna/tao	Tạo hóa đơn mua hàng	Bearer
Click để xem chi tiết...
2	POST	/api/hoadonmua/xem	Xem hóa đơn mua hàng	Bearer
Click để xem chi tiết...

Nhân viên bán hàng (Sales Employee)

STT	Method	Route	Mô tả	Auth
1	POST	/api/dmnvbh/xem	Xem danh mục NV bán hàng	Bearer
Click để xem chi tiết...

Kho (Site)

STT	Method	Route	Mô tả	Auth
1	POST	/api/kho/xem	Xem danh sách kho	Bearer
Click để xem chi tiết...

Thu chi (Payment)

STT	Method	Route	Mô tả	Auth
1	POST	/api/thu/tao	Tạo phiếu thu	Bearer
Click để xem chi tiết...
2	POST	/api/thu/xoa	Xóa phiếu thu	Bearer
Click để xem chi tiết...
3	POST	/api/chi/tao	Tạo phiếu chi	Bearer
Click để xem chi tiết...
4	POST	/api/chi/xoa	Xóa phiếu chi	Bearer
Click để xem chi tiết...
5	POST	/api/bcthuchi	Báo cáo thu chi	Bearer
Click để xem chi tiết...
6	POST	/api/bctthuchi	BC tổng thu chi	Bearer
Click để xem chi tiết...

Định dạng phản hồi (Response Format)

{
  "thanhcong": "1",        // "1" = thành công, "0" = thất bại
  "thongbao": "Xử lý thành công",
  "dulieu": []             // Dữ liệu chi tiết (mảng các đối tượng)
}

Hướng dẫn sử dụng API SIVIP Online

Xác thực (Authentication)

Tài khoản (Account)

Báo cáo (Reports)

Khách hàng (Customer)

Đơn hàng (Sales Order - DXA)

Chi phí (Expense)

Nhóm (Group)

Hóa đơn (Invoice - HDA)

Vật tư (Items)

Công việc (Job)

Nhập xuất kho (Warehouse)

Mua hàng (PNA)

Nhân viên bán hàng (Sales Employee)

Kho (Site)

Thu chi (Payment)

Định dạng phản hồi (Response Format)