Cloud Cybersoft · Integrasi PDAM · v1

Spesifikasi API PDAM

Kontrak API yang harus disediakan server PDAM agar bisa dihubungkan ke Cloud Cybersoft lewat menu Settings → PDAM. Setiap subscriber bisa menambahkan PDAM-nya sendiri dan memilih PDAM untuk tiap channel. Semua contoh respons diambil dari API Perumda Air Minum Tirta Amertha Jembrana yang aktif saat ini (9 Oktober 2026). Nama, alamat, koordinat, dan nomor sambungan sudah diganti dengan data fiktif. Angka tagihan dan strukturnya asli.

Endpoint: 5 URL (4 GET, 1 POST)
Format: JSON, UTF-8
Otentikasi: api_user + api_key
Batas waktu: 15 detik per panggilan

Ringkasan endpoint

Setiap PDAM mengisi lima URL di Cloud. Nama path bebas; Cloud hanya memakai URL lengkap yang diisi admin. Kolom "Dipakai di" menunjukkan tombol di halaman Chats yang memanggil endpoint tersebut.

Kolom di Cloud	Metode	Contoh URL (Jembrana)	Dipakai di
URL Tagihan	GET	`…/waba/check`	Cek Tagihan, email tagihan, tagihan ke chat Telegram/LINE/Messenger/Instagram/Live Chat
URL Customer	GET	`…/waba/customer`	Cek Pelanggan (cari nama/alamat)
URL History	GET	`…/waba/history`	Riwayat Pembayaran
URL Invoice	POST	`…/waba/invoice`	Kirim Tagihan ke WhatsApp pelanggan (khusus channel WhatsApp)
URL Resend Invoice	GET	`…/waba/resend`	Kirim ulang bukti bayar dari tabel riwayat (khusus channel WhatsApp)

Aturan umum

Balas dengan header Content-Type: application/json. Respons non-JSON ditampilkan ke agen sebagai teks mentah.
Kirim semua nilai sebagai string, termasuk angka: "113000", bukan 113000. Nilai uang di endpoint tagihan berupa digit polos tanpa titik ribuan. Cloud sendiri yang memformat Rupiah.
Gunakan HTTP 200 untuk semua jawaban yang valid, termasuk "data tidak ditemukan". Status hasil dibedakan lewat field code di dalam JSON.
Kirim pesan yang bisa dibaca manusia di field result. Cloud menampilkan isinya apa adanya ke agen saat terjadi error.
Kredensial dikirim sebagai query parameter (api_user, api_key) pada GET dan sebagai field JSON pada POST. Lihat catatan keamanan di bagian Checklist.

Nilai field `code`

code	Arti	Contoh `result` dari Jembrana
`"200"`	Berhasil. Untuk tagihan: masih ada rekening yang belum lunas.	REKENING YANG BELUM DILUNASI ADALAH BULAN OKTOBER 2026
`"300"`	Tagihan: semua rekening sudah lunas. Data rekening terakhir tetap dikirim lengkap dengan tanggal lunas.	SELURUH REKENING TAGIHAN AIR TELAH LUNAS !
`"350"`	Tagihan: nomor sambungan tidak dikenal atau tagihan bulan ini belum terbit.	Tagihan dengan No. Sambungan 99999999 Belum Muncul !
`"400"`	Pencarian pelanggan tidak menemukan data.	DATA BY (CAT = NAME, KEYWORD = …, AREA = ALL) NOT FOUND !

Rumus tagihan

Rumus ini diturunkan dari data asli Jembrana dan harus dipatuhi oleh PDAM lain agar rincian di email dan chat cocok sampai rupiah terakhir.

jumlah = air + b_adm + b_dmeter + ppn

total = jumlah + denda + adm_bank

total_xxx = penjumlahan field xxx dari semua rekening

total_jumlah = Σ jumlah

grand_total = Σ total

Contoh nyata, sambungan dengan 2 rekening menunggak (data lengkap di sampel 3):

Periode	air	b_adm	b_dmeter	ppn	jumlah	denda	total
DESEMBER 2017	247.500	3.000	21.500	2.450	274.450	250.000	524.450
JANUARI 2018	47.400	3.000	21.500	2.450	74.350	35.000	109.350
Ringkasan	294.900	6.000	43.000	4.900	348.800	285.000	633.800

Komponen biaya tambahan boleh ditambahkan sebagai field angka baru di tiap rekening (misalnya b_limbah). Cloud otomatis menampilkannya dengan label dari nama field. Field total ringkasannya diberi awalan total_ (contoh total_b_limbah).

GET

Cek tagihan

URL Tagihan

Mengembalikan data pelanggan dan semua rekening yang belum lunas untuk satu nomor sambungan. Jika semua sudah lunas, kirim rekening terakhir beserta tanggal lunas dan "lunas": "true".

Request

Parameter	Status	Keterangan
`nosam`	WAJIB	Nomor sambungan pelanggan.
`api_user`	WAJIB	Diisi Cloud dari kolom API User.
`api_key`	WAJIB	Diisi Cloud dari kolom API Key.

Contoh request · shell

curl -s "https://pdam-anda.example/api/check?nosam=100140&api_user=ACC-XXXX&api_key=XXXX"

Field respons: pelanggan

Field	Status	Contoh	Keterangan
`code`	WAJIB	`"200"`	Lihat tabel nilai `code`.
`result`	WAJIB	REKENING YANG BELUM…	Kalimat status, tampil di email dan chat.
`nosam`	WAJIB	`"100140"`	Tanpa `nosam` dan `rekening`, Cloud menganggap tagihan tidak ditemukan.
`nama`	WAJIB	I MADE CONTOH	Nama pelanggan.
`rekening`	WAJIB	array	Daftar rekening. Boleh kosong hanya jika `code` bukan 200/300.
`lunas`	WAJIB	`"false"`	String `"true"` atau `"false"`. Menentukan label LUNAS / BELUM LUNAS.
`alamat`	DISARANKAN	Jl. Contoh No. 1
`kode_gol`, `gol`	DISARANKAN	RT3, RUMAH TANGGA 3	Digabung menjadi "RT3 - RUMAH TANGGA 3".
`kode_area`, `area`	DISARANKAN	101, NEGARA-01
`diameter`	DISARANKAN	`"0.50"`	Dalam inci. Cloud menambahkan tanda ".
`sts`	DISARANKAN	AKTIF, CABUT	Status sambungan.
`ta`	DISARANKAN	NORMAL	Kondisi meter.
`total_air`, `total_badm`, `total_bdmeter`, `total_ppn`, `total_denda`, `total_bank`	DISARANKAN	`"98000"`	Jika tidak dikirim, Cloud menjumlahkan sendiri dari rekening.
`total_jumlah`, `grand_total`	DISARANKAN	`"113000"`	`grand_total` adalah angka "Total yang harus dibayar".
`total_rekening`	DISARANKAN	`"1"`
`terbilang`	DISARANKAN	Seratus Tiga Belas Ribu	Cloud menambahkan kata "Rupiah".
`keterangan`	DISARANKAN	BULAN OKTOBER 2026
`lpd`, `lokasi`, `koordinat`, `latitude`, `longitude`	OPSIONAL	-8.3500,114.6100	Dikirim Jembrana, belum dipakai Cloud.

Field respons: tiap item `rekening[]`

Field	Status	Contoh	Keterangan
`bulan`, `tahun`	WAJIB	OKTOBER, 2026	Periode rekening.
`air`	WAJIB	`"98000"`	Harga air.
`b_adm`	WAJIB	`"3000"`	Biaya administrasi.
`b_dmeter`	WAJIB	`"12000"`	Dana meter.
`ppn`, `denda`, `adm_bank`	WAJIB	`"0"`	Kirim `"0"` jika tidak ada, jangan dihilangkan.
`jumlah`	WAJIB	`"113000"`	Lihat rumus.
`total`	WAJIB	`"113000"`	Lihat rumus.
`jatuh_tempo`	WAJIB	20 Oktober 2026	Teks bebas, tampil apa adanya.
`no_rekening`	DISARANKAN	`"261000000"`
`mtr_lalu`, `mtr_skrng`, `kubikasi`	DISARANKAN	1462, 1483, 21	Stand meter dan pemakaian m³.
`tgl_lunas`, `jam_lunas`	JIKA LUNAS	05 OKT 2026, 11:15:12	Jika ada, rekening ditandai lunas.
`kode_transaksi`, `operator`	JIKA LUNAS	KOLEKTIF LPD	Tempat pembayaran.
`no`	OPSIONAL	`"1"`	Nomor urut.

Contoh respons

1 · Satu rekening belum lunas (code 200) · tagihan-belum-lunas.json

{
  "nosam": "100140",
  "kode_area": "101",
  "area": "NEGARA-01",
  "nama": "I MADE CONTOH",
  "alamat": "Jl. Contoh No. 1",
  "kode_gol": "RT3",
  "gol": "RUMAH TANGGA 3",
  "lpd": "LPD CONTOH",
  "diameter": "0.50",
  "lokasi": "-8.3500,114.6100",
  "koordinat": "-8.3500,114.6100",
  "latitude": "-8.3500",
  "longitude": "114.6100",
  "ta": "NORMAL",
  "sts": "AKTIF",
  "rekening": [
    {
      "no": "1",
      "no_rekening": "261000000",
      "bulan": "OKTOBER",
      "tahun": "2026",
      "mtr_lalu": "1462",
      "mtr_skrng": "1483",
      "kubikasi": "21",
      "b_adm": "3000",
      "b_dmeter": "12000",
      "ppn": "0",
      "air": "98000",
      "denda": "0",
      "adm_bank": "0",
      "jumlah": "113000",
      "jatuh_tempo": "20 Oktober 2026",
      "total": "113000"
    }
  ],
  "total_badm": "3000",
  "total_bdmeter": "12000",
  "total_ppn": "0",
  "total_air": "98000",
  "total_denda": "0",
  "total_bank": "0",
  "total_jumlah": "113000",
  "grand_total": "113000",
  "total_rekening": "1",
  "terbilang": "Seratus Tiga Belas Ribu ",
  "keterangan": "BULAN OKTOBER 2026",
  "result": "REKENING YANG BELUM DILUNASI ADALAH BULAN OKTOBER 2026",
  "lunas": "false",
  "code": "200"
}

2 · Sudah lunas, dibayar lewat LPD dengan admin bank (code 300) · tagihan-lunas.json

{
  "nosam": "100315",
  "kode_area": "101",
  "area": "NEGARA-01",
  "nama": "NI LUH SAMPEL",
  "alamat": "Jl. Sampel Gg. II No. 7",
  "kode_gol": "RT3",
  "gol": "RUMAH TANGGA 3",
  "lpd": "",
  "diameter": "0.50",
  "lokasi": "-8.3560,114.6200",
  "koordinat": "-8.3560,114.6200",
  "latitude": "-8.3560",
  "longitude": "114.6200",
  "ta": "NORMAL",
  "sts": "AKTIF",
  "rekening": [
    {
      "no": "1",
      "no_rekening": "261001000",
      "kode_transaksi": "00001/PDAM.TEL/X/2026",
      "bulan": "OKTOBER",
      "tahun": "2026",
      "mtr_lalu": "4804",
      "mtr_skrng": "4863",
      "kubikasi": "59",
      "b_adm": "3000",
      "b_dmeter": "12000",
      "ppn": "0",
      "air": "307000",
      "denda": "0",
      "adm_bank": "2500",
      "jumlah": "322000",
      "jatuh_tempo": "20 Oktober 2026",
      "total": "324500",
      "tgl_lunas": "05 OKT 2026",
      "jam_lunas": "11:15:12",
      "operator": "KOLEKTIF LPD"
    }
  ],
  "total_badm": "3000",
  "total_bdmeter": "12000",
  "total_ppn": "0",
  "total_air": "307000",
  "total_denda": "0",
  "total_bank": "2500",
  "total_jumlah": "322000",
  "grand_total": "324500",
  "total_rekening": "1",
  "terbilang": "Tiga Ratus Dua Puluh Empat Ribu Lima Ratus",
  "keterangan": "BULAN OKTOBER 2026",
  "lunas": "true",
  "result": "SELURUH REKENING TAGIHAN AIR TELAH LUNAS !",
  "code": "300"
}

3 · Dua rekening menunggak dengan denda (code 200) · tagihan-dua-bulan-denda.json

{
  "nosam": "100393",
  "kode_area": "101",
  "area": "NEGARA-01",
  "nama": "KETUT PERCOBAAN",
  "alamat": "Jl. Percobaan No. 12",
  "kode_gol": "RT",
  "gol": "RUMAH TANGGA 1",
  "lpd": "LPD CONTOH",
  "diameter": "0.75",
  "lokasi": "-8.3600,114.6170",
  "koordinat": "-8.3600,114.6170",
  "latitude": "",
  "longitude": "",
  "ta": "NORMAL",
  "sts": "CABUT",
  "rekening": [
    {
      "no": "1",
      "no_rekening": "462199",
      "bulan": "DESEMBER",
      "tahun": "2017",
      "mtr_lalu": "2528",
      "mtr_skrng": "2589",
      "kubikasi": "61",
      "b_adm": "3000",
      "b_dmeter": "21500",
      "ppn": "2450",
      "air": "247500",
      "denda": "250000",
      "adm_bank": "0",
      "jumlah": "274450",
      "jatuh_tempo": "20 Desember 2017",
      "total": "524450"
    },
    {
      "no": "2",
      "no_rekening": "484686",
      "bulan": "JANUARI",
      "tahun": "2018",
      "mtr_lalu": "2589",
      "mtr_skrng": "2605",
      "kubikasi": "16",
      "b_adm": "3000",
      "b_dmeter": "21500",
      "ppn": "2450",
      "air": "47400",
      "denda": "35000",
      "adm_bank": "0",
      "jumlah": "74350",
      "jatuh_tempo": "22 Januari 2018",
      "total": "109350"
    }
  ],
  "total_badm": "6000",
  "total_bdmeter": "43000",
  "total_ppn": "4900",
  "total_air": "294900",
  "total_denda": "285000",
  "total_bank": "0",
  "total_jumlah": "348800",
  "grand_total": "633800",
  "total_rekening": "2",
  "terbilang": "Enam Ratus Tiga Puluh Tiga Ribu Delapan Ratus",
  "keterangan": "BULAN DESEMBER 2017 DAN BULAN JANUARI 2018",
  "result": "REKENING YANG BELUM DILUNASI ADALAH BULAN DESEMBER 2017 DAN BULAN JANUARI 2018",
  "lunas": "false",
  "code": "200"
}

4 · Nomor sambungan tidak dikenal (code 350) · tagihan-tidak-ditemukan.json

{
  "result": "Tagihan dengan No. Sambungan 99999999 Belum Muncul !",
  "code": "350"
}

GET

Cari pelanggan

URL Customer

Agen mencari nomor sambungan berdasarkan nama atau alamat. Hasil ditampilkan sebagai tabel dengan tombol salin nomor sambungan.

Request

Parameter	Status	Keterangan
`cat`	WAJIB	`name` atau `address`.
`keyword`	WAJIB	Kata kunci, dicocokkan sebagian (LIKE).
`area`	WAJIB	Kode area (misalnya `101`) atau `all`.
`api_user`, `api_key`	BELUM DIKIRIM	Saat ini Cloud tidak mengirim kredensial untuk endpoint ini. Lihat catatan di bawah.

Contoh request · shell

curl -s "https://pdam-anda.example/api/customer?cat=name&keyword=contoh&area=all"

Field respons

Field	Status	Keterangan
`code`	WAJIB	Hanya `"200"` yang dianggap berhasil. Selain itu isi `result` tampil sebagai error.
`pelanggan[]`	WAJIB	Array hasil pencarian.
`pelanggan[].nosam`, `.nama`	WAJIB
`pelanggan[].alamat`, `.golongan`, `.area`, `.status`	DISARANKAN	Teks siap tampil, misalnya "RUMAH TANGGA 3 (RT3)" dan "NEGARA-01 (101)".
`pelanggan[].no`	OPSIONAL	Cloud membuat nomor urut sendiri.

Catatan kode area. Pilihan area di Chats saat ini masih tertulis tetap untuk wilayah Jembrana (Negara 101–110, Melaya 201–213, Pekutatan 301–307, Mendoyo 401–407). PDAM lain tetap bisa memakai all. Jika PDAM baru butuh daftar areanya sendiri, daftar itu perlu dibuat bisa diatur per PDAM di Cloud.

Contoh respons

Ditemukan (dipotong menjadi 3 dari 56 baris) · customer-search.json

{
  "pelanggan": [
    {
      "no": "1",
      "nosam": "100140",
      "nama": "I MADE CONTOH",
      "alamat": "Jl. Contoh No. 1",
      "golongan": "RUMAH TANGGA 3 (RT3)",
      "area": "NEGARA-01 (101)",
      "status": "Normal"
    },
    {
      "no": "2",
      "nosam": "100315",
      "nama": "NI LUH SAMPEL",
      "alamat": "Jl. Sampel Gg. II No. 7",
      "golongan": "RUMAH TANGGA 3 (RT3)",
      "area": "NEGARA-01 (101)",
      "status": "Normal"
    },
    {
      "no": "3",
      "nosam": "100393",
      "nama": "KETUT PERCOBAAN",
      "alamat": "Jl. Percobaan No. 12",
      "golongan": "RUMAH TANGGA 3 (RT3)",
      "area": "NEGARA-01 (101)",
      "status": "Cabut"
    }
  ],
  "code": "200"
}

Tidak ditemukan (code 400) · customer-search-tidak-ditemukan.json

{
  "result": "DATA BY (CAT = NAME, KEYWORD = CONTOH, AREA = ALL) NOT FOUND !",
  "code": "400"
}

GET

Riwayat pembayaran

URL History

Daftar pembayaran yang sudah lunas untuk satu nomor sambungan, terbaru lebih dulu. Format Jembrana memakai objek dengan kunci angka ("0", "1", …) ditambah code dan result. Cloud mengurutkan baris menurut kunci angka itu.

Request

Parameter	Status	Keterangan
`nosam`	WAJIB	Nomor sambungan.
`api_user`, `api_key`	WAJIB

Contoh request · shell

curl -s "https://pdam-anda.example/api/history?nosam=100140&api_user=ACC-XXXX&api_key=XXXX"

Field tiap baris

Field	Status	Contoh	Keterangan
`bulan`, `tahun`	WAJIB	Sep, 2026	Periode, tampil di tabel.
`tagihan`	WAJIB	`"113.000"`	Teks siap tampil (dengan titik ribuan).
`tgl_lunas`	WAJIB	20 SEP 2026
`bln_rek`, `thn_rek`, `bln_dt`, `thn_dt`	WAJIB	9, 2026, 09, 2026	Dikirim balik apa adanya ke endpoint Resend. Bulan/tahun rekening dan bulan/tahun data.
`tipe`	WAJIB	vendor, kasir	Kanal pembayaran. Juga dikirim balik ke Resend.
`kode_transaksi`	DISARANKAN	00001/PDAM.BRI/IX/2026
`gol`, `stand`, `kubikasi`	DISARANKAN	RT3, 1.441 - 1.462, 21

Contoh respons

Ada riwayat (dipotong menjadi 3 dari 92 baris) · history.json

{
  "0": {
    "kode_transaksi": "00001/PDAM.BRI/IX/2026",
    "bulan": "Sep",
    "tahun": "2026",
    "gol": "RT3",
    "stand": "1.441 - 1.462",
    "kubikasi": "21",
    "tagihan": "113.000",
    "tgl_lunas": "20 SEP 2026",
    "tipe": "vendor",
    "bln_rek": "9",
    "thn_rek": "2026",
    "bln_dt": "09",
    "thn_dt": "2026"
  },
  "1": {
    "kode_transaksi": "00002/PDAM.BRI/VIII/2026",
    "bulan": "Agu",
    "tahun": "2026",
    "gol": "RT3",
    "stand": "1.420 - 1.441",
    "kubikasi": "21",
    "tagihan": "113.000",
    "tgl_lunas": "18 AUG 2026",
    "tipe": "vendor",
    "bln_rek": "8",
    "thn_rek": "2026",
    "bln_dt": "08",
    "thn_dt": "2026"
  },
  "2": {
    "kode_transaksi": "KSR002026",
    "bulan": "Apr",
    "tahun": "2026",
    "gol": "RT3",
    "stand": "1.312 - 1.350",
    "kubikasi": "38",
    "tagihan": "206.500",
    "tgl_lunas": "18 APR 2026",
    "tipe": "kasir",
    "bln_rek": "4",
    "thn_rek": "2026",
    "bln_dt": "04",
    "thn_dt": "2026"
  },
  "code": "200",
  "result": "success"
}

Tidak ada riwayat: array kosong · history-kosong.json

[]

POST

Kirim invoice

URL Invoice

Cloud meminta server PDAM mengirim tagihan ke nomor WhatsApp pelanggan. Hanya dipakai untuk channel WhatsApp. Channel Telegram, LINE, Messenger, Instagram, dan Live Chat menerima tagihan langsung dari Cloud lewat endpoint Cek Tagihan.

Bukan dari data asli. Endpoint ini mengirim WhatsApp sungguhan, jadi tidak dipanggil saat menyusun dokumen ini. Bentuk request di bawah sama persis dengan yang dikirim Cloud. Contoh respons adalah bentuk minimal yang diterima Cloud.

Request body (JSON)

Field	Status	Keterangan
`no_customer`	WAJIB	Nomor sambungan.
`phone_number`	WAJIB	Nomor WhatsApp pelanggan dari percakapan, format 62….
`name_instance`	DISARANKAN	Nama channel WhatsApp di Cloud, untuk memilih nomor pengirim.
`api_user`, `api_key`	WAJIB

Request body · invoice-request.json

{
  "no_customer": "100140",
  "phone_number": "6281234567890",
  "name_instance": "CS PDAM Contoh",
  "api_user": "ACC-XXXXXXXX-XXXX-XXXX",
  "api_key": "xxxxxxxxxxxxxxxxxxxxxx"
}

Respons berhasil: code harus "200" · invoice-response-sukses.json

{
  "code": "200",
  "result": "Invoice No. Sambungan 100140 berhasil dikirim ke 6281234567890"
}

Respons gagal: pesan diambil dari error, lalu message · invoice-response-gagal.json

{
  "code": "422",
  "error": "Nomor WhatsApp tidak valid"
}

GET

Kirim ulang bukti bayar

URL Resend Invoice

Dipanggil dari tombol kirim pada tabel Riwayat. Nilai periode dan tipe diambil dari baris riwayat yang dipilih. Sama seperti Kirim Invoice, endpoint ini mengirim WhatsApp sungguhan dan tidak dipanggil saat menyusun dokumen.

Parameter	Status	Sumber
`nosam`	WAJIB	Input agen.
`bln_rek`, `thn_rek`, `bln_dt`, `thn_dt`, `tipe`	WAJIB	Dari baris riwayat.
`no_wa`	WAJIB	Nomor WhatsApp dari percakapan.
`channel`	DISARANKAN	Nama channel WhatsApp di Cloud.
`api_user`, `api_key`	WAJIB

Contoh request · shell

curl -s "https://pdam-anda.example/api/resend?nosam=100140&bln_dt=09&thn_dt=2026&bln_rek=9&thn_rek=2026&tipe=vendor&no_wa=6281234567890&channel=CS%20PDAM%20Contoh&api_user=ACC-XXXX&api_key=XXXX"

Respons berhasil: code "200", result tampil ke agen · resend-response-sukses.json

{
  "code": "200",
  "result": "Bukti pembayaran Sep 2026 berhasil dikirim ulang"
}

Checklist PDAM baru

Kelima URL bisa diakses dari server Cloud lewat HTTPS dan menjawab dalam 15 detik.
Semua nilai berupa string, uang tanpa titik ribuan di endpoint tagihan.
jumlah dan total mengikuti rumus. Komponen yang nol tetap dikirim sebagai "0".
"Tidak ditemukan" dijawab HTTP 200 dengan code dan result, bukan HTTP 404/500.
Kredensial benar-benar divalidasi. Server PDAM harus menolak api_user/api_key yang salah dengan {"code": "401", "result": "API key tidak valid"}, karena data pelanggan adalah data pribadi.
Tambahkan PDAM di Settings → PDAM (URL Tagihan wajib, URL lain bisa menyusul), lalu klik tombol tes (ikon petir) dengan satu nomor sambungan asli. Hasil tes menampilkan status HTTP, waktu respons, dan nama pelanggan.
Pilih PDAM tersebut untuk channel yang dipakai di tabel "PDAM per channel", lalu coba Cek Tagihan dari Chats.

File sampel

Semua contoh di atas juga tersimpan sebagai file JSON di server Cloud, siap dipakai sebagai fixture saat membangun atau menguji API PDAM baru:

File	Isi	Sumber
`tagihan-belum-lunas.json`	1 · Satu rekening belum lunas (code 200)	API Jembrana (dianonimkan)
`tagihan-lunas.json`	2 · Sudah lunas, dibayar lewat LPD dengan admin bank (code 300)	API Jembrana (dianonimkan)
`tagihan-dua-bulan-denda.json`	3 · Dua rekening menunggak dengan denda (code 200)	API Jembrana (dianonimkan)
`tagihan-tidak-ditemukan.json`	4 · Nomor sambungan tidak dikenal (code 350)	API Jembrana (dianonimkan)
`customer-search.json`	Ditemukan (dipotong menjadi 3 dari 56 baris)	API Jembrana (dianonimkan)
`customer-search-tidak-ditemukan.json`	Tidak ditemukan (code 400)	API Jembrana (dianonimkan)
`history.json`	Ada riwayat (dipotong menjadi 3 dari 92 baris)	API Jembrana (dianonimkan)
`history-kosong.json`	Tidak ada riwayat: array kosong	API Jembrana (dianonimkan)
`invoice-request.json`	Request body	Contoh bentuk (bukan data live)
`invoice-response-sukses.json`	Respons berhasil: code harus "200"	Contoh bentuk (bukan data live)
`invoice-response-gagal.json`	Respons gagal: pesan diambil dari error, lalu message	Contoh bentuk (bukan data live)
`resend-response-sukses.json`	Respons berhasil: code "200", result tampil ke agen	Contoh bentuk (bukan data live)

Lokasi di server Cloud: docs/pdam-api/samples/ (minta ke tim Cybersoft)

Ringkasan endpoint

Aturan umum

Nilai field code

Rumus tagihan

Cek tagihan

Request

Field respons: pelanggan

Field respons: tiap item rekening[]

Contoh respons

Cari pelanggan

Request

Field respons

Contoh respons

Riwayat pembayaran

Request

Field tiap baris

Contoh respons

Kirim invoice

Request body (JSON)

Kirim ulang bukti bayar

Checklist PDAM baru

File sampel

Nilai field `code`

Field respons: tiap item `rekening[]`