Tính tiền nước API
Tính tiền nước sinh hoạt theo bậc thang của từng tỉnh, định mức theo hộ hoặc nhân khẩu, VAT 5% và phí bảo vệ môi trường hoặc giá dịch vụ thoát nước.
Gửi số m³ (hoặc chỉ số đồng hồ đầu, cuối kỳ) và provider, API tính hoá đơn tiền nước: từng bậc với số m³ và đơn giá, tiền trước thuế, thuế GTGT 5% (nước sạch, Luật Thuế GTGT 48/2024), tiền nước thải và tổng cộng. Đang hỗ trợ (coverage): Hà Nội (QĐ 3541/QĐ-UBND), địa bàn TP.HCM cũ do SAWACO cấp nước (QĐ 25/2019/QĐ-UBND, định mức 4 m³/người, giá dịch vụ thoát nước 30% + VAT), Bình Dương cũ (Biwase), Đà Nẵng đô thị và nông thôn (QĐ 2967/QĐ-UBND, giá đã gồm VAT), Quảng Nam cũ, Hải Phòng đô thị và nông thôn (QĐ 05/2024/QĐ-UBND) và nông thôn Cần Thơ (QĐ 5260/QĐ-UBND, từ 1/11/2026).
Định mức các bậc tính theo đồng hồ và nhân với số hộ dùng chung (households); nếu chỉ gửi persons, cứ 4 người đăng ký tính là một hộ (TT 145/2025/TT-BTC). customer chọn giá hộ gia đình, hộ nghèo, cơ quan hành chính sự nghiệp, sản xuất hoặc kinh doanh dịch vụ. Phí bảo vệ môi trường đối với nước thải sinh hoạt bằng 10% giá nước chưa VAT (NĐ 346/2025/NĐ-CP, từ 1/1/2026); đặt lại bằng wastewater_percent nếu tỉnh quy định mức khác hoặc xã được miễn.
Với công ty cấp nước khác, gửi custom_tiers ([{"up_to":10,"price":8500},{"price":27000}]) kèm tier_basis và prices_include_vat. action=tariffs trả về toàn bộ biểu giá, số quyết định và nguồn. Số liệu chỉ có một nguồn được đánh dấu trong tariff.verified và notes.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
provider | query|body | string | không | hanoi, hcm, binh_duong, da_nang, da_nang_rural, quang_nam, hai_phong, hai_phong_rural, can_tho_rural (hoặc tên tỉnh). | |
m3 | query|body | number | không | Số m³ tiêu thụ (hoặc start_reading + end_reading). | |
customer | query|body | string | không | household | household (hộ gia đình), poor (hộ nghèo), admin (hành chính sự nghiệp), production, business. |
persons | query|body | number | không | Số người đăng ký (TP.HCM: định mức theo người; nơi khác 4 người = 1 hộ). | |
households | query|body | number | không | 1 | Số hộ dùng chung đồng hồ. |
wastewater_percent | query|body | number | không | Đặt lại tỷ lệ phí nước thải / giá thoát nước (0 = miễn). | |
vat_percent | query|body | number | không | 5 | Đặt lại thuế suất GTGT tiền nước. |
custom_tiers | body | array | không | Biểu giá tự nhập: [{"up_to":10,"price":8500},{"price":27000}] kèm tier_basis (household/person) và prices_include_vat. | |
action | query|body | string | không | tariffs: liệt kê toàn bộ biểu giá và nguồn. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-water-bill?provider=hanoi&m3=25');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"provider": "hanoi",
"name": "Hà Nội",
"name_vi": "Hà Nội",
"customer": "household",
"m3": 25,
"quota": {
"basis": "household",
"households": 1
},
"tiers": [
{
"tier": 1,
"m3": 10,
"price": 8500,
"amount": 85000,
"limit": 10
},
{
"tier": 2,
"m3": 10,
"price": 9900,
"amount": 99000,
"limit": 10
},
{
"tier": 3,
"m3": 5,
"price": 16000,
"amount": 80000,
"limit": 10
}
],
"water_amount": 264000,
"prices_include_vat": false,
"amount_before_vat": 264000,
"vat_percent": 5,
"vat": 13200,
"wastewater": {
"kind": "env_fee",
"kind_vi": "Phí bảo vệ môi trường đối với nước thải sinh hoạt",
"percent": 10,
"amount": 26400,
"vat_percent": 0,
"vat": 0,
"ref": "NĐ 346/2025/NĐ-CP (phí bảo vệ môi trường đối với nước thải sinh hoạt, 10%)"
},
"total": 303600,
"legal": [
{
"text": "QĐ 3541/QĐ-UBND (7/7/2023), stage 2",
"effective_from": "2024-01-01"
},
{
"text": "Luật Thuế GTGT 48/2024/QH15 (nước sạch 5%)",
"effective_from": "2025-07-01"
},
{
"text": "NĐ 346/2025/NĐ-CP (phí bảo vệ môi trường đối với nước thải)",
"effective_from": "2026-01-01"
}
],
"coverage": [
"hanoi",
"hcm",
"binh_duong",
"da_nang",
"da_nang_rural",
"quang_nam",
"hai_phong",
"hai_phong_rural",
"can_tho_rural"
],
"disclaimer": "Reference calculation, not legal advice; check the official text and your invoice.",
"reviewed": "2026-11-11"
}
Ứng dụng
- Hiển thị tiền nước hằng tháng trong app quản lý nhà trọ, chung cư
- Chia tiền điện nước cho người thuê
- Kiểm tra hoá đơn nước SAWACO, Hà Nội, Hải Phòng
- Ước tính chi phí sinh hoạt trên tin đăng bất động sản
Hỏi đáp
API hỗ trợ những tỉnh nào?
Hà Nội, TP.HCM cũ (SAWACO), Bình Dương cũ (Biwase), Đà Nẵng và Quảng Nam cũ, Hải Phòng và nông thôn Cần Thơ. Nơi khác: gửi custom_tiers theo giá của công ty cấp nước.
Đã tính tiền nước thải chưa?
Có: phí bảo vệ môi trường 10% (NĐ 346/2025/NĐ-CP) trên giá nước chưa VAT, riêng TP.HCM thay bằng giá dịch vụ thoát nước và xử lý nước thải 30% cộng VAT 8% (10% từ 2027).
Nhiều hộ hoặc người thuê dùng chung đồng hồ thì sao?
Định mức các bậc nhân với households; với người thuê nhà, cứ 4 người đăng ký tính là một hộ. Ở TP.HCM bậc đầu là 4 m³ cho mỗi người đăng ký.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.