url: {domamin}/HangHoaApi.php

1. Nhà phân phối

Thêm, get ALl, Sửa, Xoá "nhà phân phối" tương tư mục 4 của api-hang-hoa.json. "type" đổi "nhaSanXuat" thành "nhaPhanPhoi" 

url: {domain}/InventoryAPI.php

Note: Không có hàm thêm mới, update inventory vì khi update và create hàng hoá hệ thống đã âm thầm tạo invetorty cho mỗi chi nhánh rồi 

2. Get ALL inventory theo chi nhánh và kewyword
input
{
    "action":"getAllInventory", (*)
    "id_chi_nhanh": "6877202a3ead70d79008bb82", (*)
    "page": 1, (*)
    "type": "normal", (*)  // type ="normal" lấy all inventory
                           // type="het_hang" lấy all những inventory ton_kho = 0 
                           // type="gan_het_hang" lấy all những inventory  có ton_kho <= ton_kho_toi_thieu
    "kw": "meo", // tuỳ chọn có thì tìm không thì thôi
    "all_chi_nhanh": true (*) // giá trị true khi muốn lấy toàn bộ chị nhánh, false chỉ lấy chi nhánh theo id
}

output
{
    "status": "success",
    "data": {
        "data": [
            {
                "_id": "6929919d2301cd9cd90d1b5f",
                "id_hang_hoa": "692991912301cd9cd90d1b56",
                "id_chi_nhanh": "6877202a3ead70d79008bb82",
                "ton_kho": 0,
                "ton_toi_thieu": 5,
                "ten_hang_hoa": "Gói meoO Plus ++--",
                "ten_don_vi": "bịch"
            },
            {
                "_id": "69296e242301cd9cd90d1a53",
                "id_hang_hoa": "69296e232301cd9cd90d1a52",
                "id_chi_nhanh": "6877202a3ead70d79008bb82",
                "ton_kho": 0,
                "ton_toi_thieu": 10,
                "ten_hang_hoa": "Gói pate meoO",
                "ten_don_vi": "bịch"
            }
        ],
        "pagination": {
            "page": 1,
            "total_items": 2,
            "total_pages": 1
        }
    }
}

3 Xuất kho

input
{
    "action": "addXuatKho", (*)
    "id_chi_nhanh": "6877202a3ead70d79008bb82",(*)
    "created_time": "29/11/2025 15:35", // thời gian hiện tại dạng text để xem 
    "list_hang_hoa": [
        {
            "id_hang_hoa":"692991912301cd9cd90d1b56",
            "so_luong" : 5
        }
    ],
    "ly_do": "Chuột cắn"
}

output
{
    "status": "success",
    "data": "692ade57081385957704ac7f"
}

4. Chuyển kho từ chi nhánh này qua chi nhánh khác

input
{
    "action": "addChuyenKho",(*)
    "id_chi_nhanh": "6877202a3ead70d79008bb82",(*)
    "id_chi_nhanh_chuyen": "6877202a3ead70d79008bb83",(*)
    "created_time": "29/11/2025 15:35", // thời gian hiện tại dạng text để xem
    "list_hang_hoa": [
        {
            "id_hang_hoa":"692991912301cd9cd90d1b56",
            "so_luong": 10
        }
    ],
    "ly_do": "Chi nhánh mới thiếu hàng"
}

output
{
    "status": "success",
    "data": "692ade57081385957704ac7f"
}



6. Add nhập hàng và kho 

input
{
    "action": "addNhapHangKho", (*)
    "id_chi_nhanh": "687757453ead70d79008bb8a",(*)
    "ten_nha_san_xuat": "ABC", //chỉ lấy text tên của nhà cung cấp
    "list_hang_hoa": [
        {
            "id_hang_hoa":"692adbc9081385957704ac72",
            "so_luong" : 6,
            "gia_nhap_hang": 200000
        }
    ],
    "chiet_khau":25000,
    "VAT":"8%",
    "tong_tien":1700000,
    "du_no": 30000
}

output
{
    "status": "success",
    "data": "692abd1b081385957704ac04"
}

7 Add Kiểm toán kho

input
{
    "action": "addKiemToanKho",
    "id_chi_nhanh": "687757453ead70d79008bb8a",
    "ngay_kiem_toan": "2025-11-30 21:25",  // thời gian hiện tại dạng text để xem
    "ghi_chu": "Kiểm kê cuối tháng",
    "list_hang_hoa": [
        {
            "id_hang_hoa": "692adbc9081385957704ac72",
            "ton_thuc_te": 15
        }
    ]
}

output
{
    "status": "success",
    "data": "692abd1b081385957704ac04"
}


8+9+10 Get all record kiểm toán, nhập hàng, chuyển xuất kho chỉ khác nhau action

input
{
    "action": "getAllNhapHangKho",(*) //"action": "addKiemToanKho" ---- "action":"getAllChuyenXuatKho"
    "id_chi_nhanh": "687757453ead70d79008bb8a",(*)
    "page":1, (*)
    "all_chi_nhanh": true
}

11 get Inventory 

input
{
    "action": "getInventory" (*),
    "id_hang_hoa": "692adbc9081385957704ac72", (*)
    "id_chi_nhanh": "687757453ead70d79008bb8a" (*)
}

output
{
    "status": "success",
    "data": {
        "_id": "692adbc9081385957704ac79",
        "id_hang_hoa": "692adbc9081385957704ac72",
        "id_chi_nhanh": "687757453ead70d79008bb8a",
        "ton_kho": 41,
        "ton_toi_thieu": 5,
        "ten_hang_hoa": "Gói Sóc-O",
        "ten_don_vi": "bịch"
    }
}