Daftar isi
1. 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 diajukanBantuan › 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
- Hanya membaca dari bank: daftar rekening, saldo, dan mutasi. Tidak mengirim perintah pembayaran dan tidak memindahkan uang.
- Mutasi yang masuk tampil di jendela Mutasi Bank dan dicocokkan di sana; kuitansinya tetap Anda buat (atau pengaturan kuitansi otomatis).
- Layanan bank lama yang membaca notifikasi surel (rekening koran surel/PDF) adalah jalur terpisah dan tetap berjalan.
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
- 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.
- 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.
- Uji koneksi: Uji koneksi masuk ke bank, mengambil daftar rekening dan saldo. Bila berhasil, statusnya menjadi "Koneksi berfungsi"; bila tidak, alasannya ditampilkan (bagian 7).
- 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
- Setiap penarikan meminta mutasi mulai satu hari sebelum penarikan berhasil terakhir sampai hari ini (pada penarikan pertama sebanyak "hari mundur"; paling banyak 31 hari sekaligus). Hari yang tumpang tindih disengaja: mutasi yang sama dikenali dari referensi bank, tanggal, nilai, dan arah, dihitung duplikat, dan tidak ditulis.
- Mutasi baru masuk ke jendela Mutasi Bank dengan sumber "Langsung" dan langsung dicocokkan (pasti / saran / belum cocok). Kuitansi otomatis tidak berjalan pada penarikan langsung: kuitansi untuk cocok pasti dibuat dari jendela.
- Bila kemudian Anda juga mengunggah rekening koran hari yang sama sebagai berkas MT940, baris dengan referensi bank yang sama tampil sebagai duplikat.
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 uji | Tersimpan; tekan Uji koneksi. |
| Koneksi berfungsi | Uji atau penarikan terakhir berhasil. |
| Perlu perjanjian dengan bank | Dokumen layanan untuk bank ini belum ada, atau bank belum membuka layanannya. Ajukan ke bank dengan daftar di bagian 2. |
| Kredensial ditolak | Kata 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 merespons | Masalah sementara di jaringan atau di bank; penarikan otomatis mencoba lagi dengan interval yang makin panjang. |
| Pengaturan koneksi belum lengkap | Kolom 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
- Membuat, mengubah, menghapus, dan menguji koneksi, Ambil sekarang, dan log: hanya administrator sistem. Pengguna lain dengan izin Bank hanya melihat status di tab Langsung.
- Kredensial tidak pernah dibaca kembali lewat API; layar hanya menampilkan lencana "tersimpan terenkripsi". Bila nilai terenkripsi disalin ke koneksi atau perusahaan lain, nilainya tidak dapat didekripsi.
- Alamat bank hanya boleh
https://; hanya panggilan baca yang dilakukan ke bank; setiap tindakan dicatat di jejak audit (siapa, kapan, IP mana).
10. Di ponsel
- Di jendela Mutasi Bank, tab ketiga adalah Langsung: kartu koneksi, status, sinkronisasi terakhir, dan tombol besar Ambil sekarang.
- Di ponsel, formulir koneksi di Pengaturan terbuka langkah demi langkah: Bank → Kredensial → Uji → Rekening.
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.