Lewati ke konten
HNROS Pusat Bantuan
Bahasa Indonesia
Mulai gratis
Daftar isi1. Apa gunanya dan apa yang tidak dilakukannya2. Metode koneksi3. Kunci enkripsi kredensial4. Memasang koneksi — empat langkah5. Penarikan, penjaga duplikat, dan pencocokan6. Penarikan otomatis dan notifikasi7. Status dan penyebab galat8. Tab Langsung dan log sinkronisasi9. Izin dan keamanan10. Di ponsel11. Pertanyaan yang sering diajukan

Bantuan › Keuangan › Mutasi Bank › Koneksi Bank Langsung

Koneksi Bank Langsung — Panduan dari Nol

Bila Anda memiliki perjanjian dengan bank, mutasi rekening dapat diterima langsung dari bank tanpa mengunduh berkas rekening koran. Administrator sistem memasang koneksi sekali di Pengaturan › Informasi Perusahaan › Koneksi bank; setelah itu mutasi datang sesuai interval yang dipilih (atau dengan Ambil sekarang) dan melewati pencocokan yang sama dengan berkas impor. Mutasi yang sama tidak pernah ditulis dua kali, walau datang dari koneksi dan dari berkas.

1. Apa gunanya dan apa yang tidak dilakukannya

2. Metode koneksi

Metode Yang diperlukan Status
Open banking Turki (ÖHVPS · layanan informasi rekening) Perusahaan tidak dapat terhubung langsung ke bank: perlu perantara YÖS (penyedia jasa pembayaran) berlisensi, persetujuan yang disetujui di aplikasi bank, dan token akses. Ditulis sesuai standar; aktif dengan perjanjian YÖS.
Layanan web mutasi rekening korporat bank Turki (Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank, Kuveyt Türk) Perjanjian integrasi ERP dengan cabang; nama pengguna/kata sandi layanan web, nomor nasabah, izin IP server (di Garanti BBVA: client id/secret dan nomor persetujuan dari internet banking). Tampil di katalog; driver dilengkapi saat bank mengirim dokumen layanannya. Sampai saat itu statusnya "Perlu perjanjian dengan bank".
SNAP Bank Indonesia (BCA, Bank Mandiri, BNI, BRI) Pendaftaran di portal pengembang bank dan perjanjian korporat; X-CLIENT-KEY, client secret, kunci publik dari pasangan kunci RSA yang kita buat diberikan ke bank, X-PARTNER-ID, CHANNEL-ID, nomor rekening. Tanda tangan dan endpoint ditulis sesuai standar; uji pertama dengan bank nyata setelah perjanjian.
Simulasi (bank uji) Nama pengguna demo, kata sandi apa saja. Tidak menghubungi bank nyata; selalu menghasilkan mutasi contoh yang sama untuk setiap hari. Untuk latihan pemasangan dan pelatihan.

3. Kunci enkripsi kredensial

Kata sandi, client secret, dan kunci privat dari bank ditulis ke basis data dalam keadaan terenkripsi (AES-256-GCM). Kunci enkripsinya tidak ada di basis data, melainkan di lingkungan server: HNR_BANKA_KIMLIK_ANAHTARI. Pada instalasi ini kunci disimpan dengan perlindungan Windows per pengguna (java\gpt\tls\banka-kimlik.dpapi.xml) dan diberikan peluncur Node saat mulai. Tanpa kunci, layar memperingatkan bahwa kunci enkripsi kredensial belum ditetapkan; kredensial tidak dapat disimpan dan bank tidak dapat dihubungi. Bila kunci berubah, kredensial tersimpan tidak dapat didekripsi — layar menyatakan kunci enkripsi berubah dan kredensial dimasukkan ulang.

4. Memasang koneksi — empat langkah

  1. Bank dan metode koneksi: Pengaturan › Informasi Perusahaan › Koneksi bank › Koneksi baru. Pilih bank/metode dari daftar; di bawahnya muncul sumber dokumen dan daftar Informasi yang perlu diminta dari bank — ajukan ke bank dengan daftar ini.
  2. Kredensial dan pengaturan koneksi: beri nama koneksi, isi kolom dari bank, lalu tekan Simpan dan lanjutkan. Kolom rahasia (kata sandi, secret, kunci privat) tidak pernah ditampilkan lagi setelah disimpan; kotaknya bertuliskan bahwa nilai sudah tersimpan dan nilai baru diketik untuk mengubahnya. Bila dibiarkan kosong, nilai lama tetap dipakai.
  3. Uji koneksi: Uji koneksi masuk ke bank, mengambil daftar rekening dan saldo. Bila berhasil, statusnya menjadi "Koneksi berfungsi"; bila tidak, alasannya ditampilkan (bagian 7).
  4. Pemetaan rekening dan penarikan: di samping tiap rekening bank pilih akun kas/bank di HNR (rekening yang tidak dipetakan tidak ditarik; satu akun HNR hanya untuk satu rekening bank). Interval penarikan 5-60 menit, jumlah hari mundur pada penarikan pertama 0-90. Bila Pengambilan otomatis aktif tidak dicentang, mutasi hanya datang dengan Ambil sekarang. Simpan dan tutup.

Pasang dulu koneksi latihan dengan driver Simulasi (nama pengguna demo): Anda melihat empat langkah, penarikan, dan pencocokan tanpa menunggu bank nyata. Dengan menulis baris giris|nilai|keterangan|pihak lawan|NPWP di kotak "Mutasi contoh", Anda dapat mencoba pencocokan dengan faktur terbuka Anda sendiri. Hapus koneksi setelah latihan.

5. Penarikan, penjaga duplikat, dan pencocokan

6. Penarikan otomatis dan notifikasi

Penarikan otomatis nonaktif secara bawaan di server; administrator sistem mengaktifkannya dengan BANKA_CANLI_GOREV=1. Saat aktif, setiap koneksi disinkronkan dengan intervalnya sendiri. Setelah galat, waktu tunggu berlipat dua setiap percobaan (paling lama 6 jam); pada galat permanen seperti kredensial ditolak, perjanjian belum ada, atau pengaturan tidak lengkap, percobaan otomatis berhenti dan menunggu administrator. Saat mutasi baru diterima, administrator yang memasang koneksi mendapat pesan di Pesan bahwa mutasi bank baru diterima dan sejumlah mutasi menunggu pencocokan; pada galat ketiga berturut-turut, peringatan dikirim sekali. Koneksi yang galat juga tercantum di bagian Antrean layar Nadi.

7. Status dan penyebab galat

Di layar Arti dan yang perlu dilakukan
Sudah dikonfigurasi, menunggu ujiTersimpan; tekan Uji koneksi.
Koneksi berfungsiUji atau penarikan terakhir berhasil.
Perlu perjanjian dengan bankDokumen layanan untuk bank ini belum ada, atau bank belum membuka layanannya. Ajukan ke bank dengan daftar di bagian 2.
Kredensial ditolakKata sandi/secret/persetujuan kedaluwarsa atau salah. Masukkan nilai baru lalu uji lagi. Percobaan otomatis berhenti pada galat ini.
Bank tidak dapat dihubungi · Layanan bank untuk sementara tidak meresponsMasalah sementara di jaringan atau di bank; penarikan otomatis mencoba lagi dengan interval yang makin panjang.
Pengaturan koneksi belum lengkapKolom wajib kosong, alamat bukan https, atau belum ada pemetaan rekening. Lengkapi formulir.

8. Tab Langsung dan log sinkronisasi

Tab Mutasi Bank › Langsung menampilkan status setiap koneksi, sinkronisasi terakhir, penarikan berhasil terakhir, jumlah rekening yang dipetakan, dan interval penarikan; angka merah pada nama tab adalah jumlah koneksi yang galat. Di sini administrator dapat menekan Ambil sekarang dan membuka Log sinkronisasi: setiap baris memuat waktu, alasan (manual / penjadwal / saat jendela dibuka / uji koneksi), status, jumlah diterima, baru, duplikat, pasti, dan saran, serta pesan galat bila ada. Kredensial tidak pernah ditulis ke log.

9. Izin dan keamanan

10. Di ponsel

11. Pertanyaan yang sering diajukan

Pertanyaan Jawaban
Bisakah saya memasukkan kata sandi internet banking saya sendiri? Tidak. Koneksi bekerja dengan pengguna layanan web yang diterbitkan bank khusus untuk integrasi ERP, atau dengan persetujuan open banking. Jangan pernah memberikan kata sandi internet banking Anda ke sistem mana pun.
Bank saya ada di daftar tetapi statusnya "Perlu perjanjian dengan bank". Dokumen layanan bank belum dimasukkan ke pengandar. Hubungi cabang dengan daftar "Informasi yang perlu diminta dari bank" di bagian 2; setelah dokumen diterima, pengandar diselesaikan dan uji koneksi tersedia.
Mengapa mutasi tidak datang dengan sendirinya? Entah Pengambilan otomatis aktif tidak dicentang untuk koneksi itu, atau tugas penarikan otomatis di server nonaktif (bukan BANKA_CANLI_GOREV=1). Bagian atas tab Langsung menyebutkan mana yang berlaku; sementara itu Ambil sekarang dapat dipakai.
Apa yang terjadi pada mutasi yang sudah ditarik bila koneksi dihapus? Tetap ada. Yang dihapus hanya koneksi dan kredensial tersimpannya; mutasi, pencocokan, dan kuitansi yang sudah dibuat tetap ada.

Panduan terkait: Mutasi Bank · Keuangan · Pengaturan · Seluler.