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.

GETPOSThttps://apibox.io.vn/v1/vn-water-bill
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
providerquery|bodystringkhônghanoi, hcm, binh_duong, da_nang, da_nang_rural, quang_nam, hai_phong, hai_phong_rural, can_tho_rural (hoặc tên tỉnh).
m3query|bodynumberkhôngSố m³ tiêu thụ (hoặc start_reading + end_reading).
customerquery|bodystringkhônghouseholdhousehold (hộ gia đình), poor (hộ nghèo), admin (hành chính sự nghiệp), production, business.
personsquery|bodynumberkhôngSố người đăng ký (TP.HCM: định mức theo người; nơi khác 4 người = 1 hộ).
householdsquery|bodynumberkhông1Số hộ dùng chung đồng hồ.
wastewater_percentquery|bodynumberkhôngĐặt lại tỷ lệ phí nước thải / giá thoát nước (0 = miễn).
vat_percentquery|bodynumberkhông5Đặt lại thuế suất GTGT tiền nước.
custom_tiersbodyarraykhôngBiểu giá tự nhập: [{"up_to":10,"price":8500},{"price":27000}] kèm tier_basis (household/person) và prices_include_vat.
actionquery|bodystringkhôngtariffs: 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →