url: {domamin}/HangHoaApi.php

1 ĐƠN VỊ

1.1 add Đơn Vị
input
{
    "action": "addDonVi", (*)
    "type": "hangHoa", (*)
    "ten_don_vi": "chai" (*)
}

output
{
    "status": "success",
    "data": "6911a7a88a7206508d0ca6e8"
}

1.2 update Đơn Vị

input
{
    "action": "updateDonVi", (*)
    "_id": "6911a7a88a7206508d0ca6e8", (*)
    "type": "hangHoa"
    "ten_don_vi": "lọ" (*)
}

output
{
    "status": "success",
    "data": 1
}

1.3 lấy tất cả Đơn Vị

input
{
    "action": "getAllDonVi", (*)
    "type": "hangHoa" (*)
}

output
{
    "status": "success",
    "data": [
        {
            "_id": "687db15f908d2a30b20c1d13",
            "ten_don_vi": "bịch"
        },
        {
            "_id": "6911a7a88a7206508d0ca6e8",
            "ten_don_vi": "lọ"
        }
    ]
}

2. CÁCH DÙNG

2.1 add Cách Dùng
input
{
    "action": "addCachDung", (*)
    "ten_cach_dung": "uống" (*)
}

output
{
    "status": "success",
    "data": "6911aa068a7206508d0ca6e9"
}

2.2 update Cách Dùng

input
{
    "action": "updateCachDung", (*)
    "_id": "6911aa068a7206508d0ca6e9", (*)
    "ten_cach_dung": "ăn" (*)
}

output
{
    "status": "success",
    "data": 1
}

2.3 Lấy tất cả cách dùng

input
{
    "action": "getAllCachDung" (*)
}

output 
{
    "status": "success",
    "data": [
        {
            "_id": "6878a68261333cb8c706e968",
            "ten_cach_dung": "Trộn vào thức ăn"
        },
        {
            "_id": "6878a6a161333cb8c706e969",
            "ten_cach_dung": "Trộn vào nước"
        }
    ]
}

3. Phân Loại (type có hai loại: "hangHoa" và "dichVu" và "combo", "dichVu" dùng tương tự cho API bên "DichVuAPI.php", "combo" dùng trong API bên "ComboAPI.php") 

3.1 Add PhanLoai
input
{
    "action": "addPhanLoai", (*)
    "type": "hangHoa", (*)
    "ten_phan_loai": "Thức Ăn" (*)
}

output
{
    "status": "success",
    "data": "6911aa068a7206508d0ca6e9"
}

3.2 update Cách Dùng

input
{
    "action": "updatePhanLoai", (*)
    "_id": "6911aa068a7206508d0ca6e9", (*)
    "type": "hangHoa", (*)
    "ten_phan_loai": "Thức Ăn" (*)
}

output
{
    "status": "success",
    "data": 1
}

3.3 Lấy tất cả cách dùng the type dichVu/hangHoa

input
{
    "action": "getAllPhanLoai", (*)
    "type": "hangHoa" (*)
}

output 
{
    "status": "success",
    "data": [
        {
            "_id": "6878a68261333cb8c706e968",
            "ten_phan_loai": "Thức ăn"
        },
        {
            "_id": "6878a6a161333cb8c706e969",
            "ten_phan_loai": "Dụng Cu Spa"
        }
    ]
}

4. NHÀ SẢN XUÁT 

4.1 addNhaSanXuat

input
{
    "action": "addNhaSanXuat", (*)
    "type": "nhaSanXuat", (*)
    "ten_nha_san_xuat": "Meo-O", (*)
    "lien_he": "35 Thống Nhất <br/> 0796983172" 
}

output
{
    "status": "success",
    "data": "69120b6fd1732932140367c4"
}

4.2 updateNhaSanXuat

input
{
    "action": "updateNhaSanXuat", (*)
    "_id": "69120b6fd1732932140367c4", (*)
    "type": "nhaSanXuat", (*)
    "ten_nha_san_xuat": "MeoW", (*)
    "lien_he": "35 Thống Nhất <br/> 0353353108" 
}

output
{
    "status": "success",
    "data": 1
}

4.3 Lấy tất cả Nhà Sản Xuát 

input
{
    "action": "getAllNhaSanXuat", (*)
    "type": "nhaSanXuat",
}

output
{
    "status": "success",
    "data": [
        {
            "_id": "69120b6fd1732932140367c4",
            "ten_nha_san_xuat": "MeoWZ",
            "lien_he": "35 Thống Nhất <br/> 0353353108"
        }
    ]
}

4.4 Xoá nhà sản xuất

input
{
    "action": "deleteNhaSanXuat", (*)
    "_id": "6878a12361333cb8c706e962" (*)
}

output
{
    "status": "success",
    "data": 1
}

5.1 Add Hàng Hoá

input

{
    "action": "addHangHoa", (*)
    "ten_hang_hoa": "Gói meoO", (*)
    "ma_vach": "ABCEAD",
    "gia_ban": 1000000, (*)
    "thue_VAT": "8%",
    "ten_don_vi": "bịch",
    "ten_cach_dung": "uống",
    "ten_nha_san_xuat": "Vet Pro",
    "ten_phan_loai": "thuốc trị bệnh",
    "ton_toi_thieu": 5
}

output

{
    "status": "success",
    "data": "6911aa068a7206508d0ca6e9"
}

5.2 Update Hàng Hoá 

input
{
    "action": "updateHangHoa", (*)
    "_id": "6911aa068a7206508d0ca6e9", (*)
    "ten_hang_hoa": "Gói meoO Plus", (*)
    "ma_vach": "ABCEAD",
    "gia_ban": 1500000, (*)
    "thue_VAT": "8%",
    "ten_don_vi": "bịch",
    "ten_cach_dung": "uống",
    "ten_nha_san_xuat": "Vet Pro",
    "ten_phan_loai": "thuốc trị bệnh",
    "ton_toi_thieu": 5   
}

output
{
    "status": "success",
    "data": 1
}

5.3 Get hàng hoá theo _id (Sử dụng cho bán sỉ và bán lẻ)

input
{
    "action": "getHangHoa", (*)
    "_id": "6911aa068a7206508d0ca6e9", (*)
    "weight": "1"
}

output
{
    "status": "success",
    "data": {
        "_id": "69149b3e35ddc2907308ee22",
        "ten_hang_hoa": "Gói wishCAT",
        "ma_vach": "ABCEAD",
        "gia_ban": 2500000,
        "thue_VAT": "8%",
        "ten_don_vi": "bịch",
        "ten_cach_dung": "uống",
        "ten_nha_san_xuat": "Vet Pro",
        "ten_phan_loai": "thuốc trị bệnh",
        "ton_toi_thieu": 5
    }
}

5.4 Xoá hàng hoá theo _id

input
{
    "action": "deleteHangHoa", (*)
    "_id": "69149b3e35ddc2907308ee22" (*)
}

output
{
    "status": "success",
    "data": 1
}

5.5 Get All Hàng vụ theo page (phân trang)

input

(version không có kw ) 
{
    "action": "getAllHangHoa", (*)
    "page": "1" (*)
}

(version có kw)
{
    "action": "getAllHangHoa", (*)
    "page": "1", (*)
    "kw": "meoO"
}

(version có 'ten_phan_loai')
{
    "action": "getAllHangHoa", (*)
    "page": "1", (*)
    "kw": "meoO", // có hay không cũng được 
    "ten_phan_loai": "thuốc trị bệnh"
}


output
{
    "status": "success",
    "data": {
        "list_hang_hoa": [
            {
                "_id": "69155c4204122799e2050624",
                "ten_hang_hoa": "Gói meoO++",
                "ma_vach": "ABCEAD",
                "gia_ban": 5200000,
                "thue_VAT": "8%",
                "ten_don_vi": "bịch",
                "ten_cach_dung": "uống",
                "ten_nha_san_xuat": "Vet Pro",
                "ten_phan_loai": "thuốc trị bệnh",
                "ton_toi_thieu": 5
            }
        ],
        "pagination": {
            "page": 1,
            "total_items": 1,
            "total_pages": 1
        }
    }
}

6.1 Add Định lương hàng hoá (có hai dạng input theo kg và theo khoảng từ bao nhiêu đến bao nhiêu kg)

{
    "action": "addDinhLuongHangHoa", (*)
    "id_hang_hoa": "692adbc9081385957704ac72", (*)
    "type": "per_kg",(*)
    "dinh_luong": "2-3",
    "ten_don_vi": "chai"
}

{
    "action": "addDinhLuongHangHoa", (*)
    "id_hang_hoa": "", (*) //id hàng hoá là không thể thay đổi nên để enable
    "type": "range_kg", (*)
    "ten_don_vi": "lọ",
    "dinh_luong": [
        {
            "trong_luong": "Dưới 5kg",
            "dinh_luong": "2-3"
        },
        {
            "trong_luong": "Từ 5 - 10kg",
            "dinh_luong": "4"
        },
        {
            "trong_luong": "Trên 10kg",
            "dinh_luong": "5-6"
        }
    ]
}

output
{
    "status": "success",
    "data": "693cef1cd9d49b81ce0e6804"
}

6.2 Update Định Lượng
{
    "action":"updateDinhLuongHangHoa",(*)
    "_id": "", (*)
    //phần còn lại y chang ở trên
}

output
{
    "status": "success",
    "data": 1
}   

6.3 Get Object Định lượng hàng hoá 
{
    "action": "getDinhLuongHangHoa", (*)
    "_id": ""(*)
}

output
{
    "status": "success",
    "data": {
        "_id": "693cef1cd9d49b81ce0e6804",
        "id_hang_hoa": "692adbc9081385957704ac72",
        "type": "per_kg",
        "dinh_luong": "4-5"
    }
}

6.4 Get All Định lượng hàng hoá có phân trang 
{
    "action": "getAllDinhLuongHangHoa",(*)
    "page": 1(*)
}

output
{
    "status": "success",
    "data": {
        "list_dinh_luong": [
            {
                "_id": "693cef1cd9d49b81ce0e6804",
                "id_hang_hoa": "692adbc9081385957704ac72",
                "type": "per_kg",
                "dinh_luong": "4-5"
            }
        ],
        "pagination": {
            "page": 1,
            "total_items": 1,
            "total_pages": 1
        }
    }
}
6.5 Get định lượng bằng hoá bằng weight
{
    "action": "getDinhLuongByWeight", (*)
    "weight": 3.5, (*)
    "id_hang_hoa": "" (*)
}

6.6 Xoá định lượng hàng hoá 
{
    "action": "deleteDinhLuongHangHoa",(*)
    "_id": "" (*)
}

6.6 Import định lượng
{
    "action": "importHangHoa", (*)
    "filePath": "" (*)
}

output  //số dòng thêm mới lấy success - updated Ví dụ 9 - 3 = 6
{
    "status": "success",
    "data": {
        "success": 9,
        "failed": 1,
        "failed_stt": [
            {
                "stt": 5,
                "reason": "Thiếu dữ liệu bắt buộc"
            }
        ],
        "updated": 9,
        "updated_stt": [
            1,
            2,
            3,
            4,
            6,
            7,
            8,
            9,
            10
        ]
    }
}

7. Import Hàng hoá 

input
{
    "action": "importHangHoa", (*)
    "filePath": "" (*)
}

output //số dòng thêm mới lấy success - updated Ví dụ 9 - 3 = 6
{
    "status": "success",
    "data": {
        "success": 7,
        "failed": 3,
        "failed_stt": [
            {
                "stt": 5,
                "reason": "Thiếu tên hàng hoá hoặc giá bán "
            },
            {
                "stt": 7,
                "reason": "Thiếu tên hàng hoá hoặc giá bán "
            },
            {
                "stt": 9,
                "reason": "Thiếu tên hàng hoá hoặc giá bán "
            }
        ],
        "updated": 7,
        "updated_stt": [
            1,
            2,
            3,
            4,
            6,
            8,
            10
        ]
    }
}