Koneksi Bank Langsung — Panduan ti Nol

Lamun anjeun boga perjangjian jeung bank, mutasi rekening bisa ditarima langsung ti bank tanpa ngundeur berkas rekening koran. Administrator sistem masang koneksi sakali di Setélan › Émbaran Pausahaan › Koneksi bank; sanggeus éta mutasi datang saluyu jeung interval anu dipilih (atawa ku Candak ayeuna) sarta ngaliwatan pencocokan anu sarua jeung berkas impor. Mutasi anu sarua moal ditulis dua kali, sanajan datang tina koneksi jeung tina berkas.

1. Naon gunana jeung naon anu henteu dipigawéna

Ngan maca ti bank: daptar rekening, saldo, jeung mutasi. Henteu ngirim paréntah pamayaran sarta henteu mindahkeun duit.
Mutasi anu asup némbongan dina jandéla Mutasi Bank sarta dicocogkeun di dinya; kuitansina tetep anjeun anu nyieun (atawa setélan kuitansi otomatis).
Layanan bank heubeul anu maca béwara surél (rekening koran surél/PDF) mangrupa jalur misah sarta tetep jalan.

2. Métode koneksi

Métode	Anu diperlukeun	Status
Open banking Turki (ÖHVPS · layanan émbaran rekening)	Pausahaan teu bisa nyambung langsung ka bank: perlu perantara YÖS (panyadia jasa pamayaran) anu boga lisénsi, persetujuan anu disatujuan dina aplikasi bank, jeung token aksés.	Ditulis saluyu jeung standar; aktip ku perjangjian YÖS.
Layanan wéb mutasi rekening korporat bank Turki (Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank, Kuveyt Türk)	Perjangjian integrasi ERP jeung cabang; ngaran pamaké/kecap konci layanan wéb, nomer nasabah, idin IP server (di Garanti BBVA: client id/secret jeung nomer persetujuan tina internet banking).	Némbongan dina katalog; driver dilengkepan nalika bank ngirim dokumén layananana. Nepi ka harita statusna "Peryogi perjanjian sareng bank".
SNAP Bank Indonesia (BCA, Bank Mandiri, BNI, BRI)	Pendaptaran dina portal pamekar bank jeung perjangjian korporat; X-CLIENT-KEY, client secret, konci publik tina pasangan konci RSA anu urang jieun dibikeun ka bank, X-PARTNER-ID, CHANNEL-ID, nomer rekening.	Tanda tangan jeung endpoint ditulis saluyu jeung standar; uji munggaran jeung bank nyata sanggeus perjangjian.
Simulasi (bank uji)	Ngaran pamaké `demo`, kecap konci naon waé. Henteu nyambung ka bank nyata; salawasna ngahasilkeun mutasi conto anu sarua pikeun unggal poé.	Pikeun latihan masang jeung pelatihan.

3. Konci énkripsi kredénsial

Kecap konci, client secret, jeung konci privat ti bank ditulis kana basis data dina kaayaan diénkripsi (AES-256-GCM). Konci énkripsina henteu aya dina basis data, tapi dina lingkungan server: HNR_BANKA_KIMLIK_ANAHTARI. Dina pamasangan ieu konci disimpen ku panyalindungan Windows per pamaké (java\gpt\tls\banka-kimlik.dpapi.xml) sarta dibikeun ku peluncur Node nalika ngamimitian. Tanpa konci, layar méré peringetan yén konci énkripsi kredénsial can ditetepkeun; kredénsial teu bisa disimpen sarta bank teu bisa dihubungan. Lamun konci robah, kredénsial anu disimpen teu bisa didékripsi — layar nyebutkeun konci énkripsi robah sarta kredénsial diasupkeun deui.

4. Masang koneksi — opat léngkah

Bank jeung métode koneksi: Setélan › Émbaran Pausahaan › Koneksi bank › Koneksi énggal. Pilih bank/métode tina daptar; di handapeunana muncul sumber dokumén jeung daptar Inpormasi anu kedah dipénta ti bank — ajukeun ka bank ku daptar ieu.
Kredénsial jeung setélan koneksi: béré ngaran koneksi, eusian kolom ti bank, tuluy pencét Simpen teras teraskeun. Kolom rusiah (kecap konci, secret, konci privat) moal dipintonkeun deui sanggeus disimpen; kotakna nuliskeun yén nilai geus disimpen sarta nilai anyar diketik pikeun ngarobahna. Lamun dikosongkeun, nilai heubeul tetep dipaké.
Uji koneksi: Uji koneksi asup ka bank, nyokot daptar rekening jeung saldo. Lamun hasil, statusna jadi "Koneksi jalan"; lamun henteu, alesanana dipintonkeun (bagian 7).
Pemetaan rekening jeung narik: di gigireun unggal rekening bank pilih akun kas/bank di HNR (rekening anu teu dipetakeun teu ditarik; hiji akun HNR ngan pikeun hiji rekening bank). Interval narik 5-60 menit, jumlah poé mundur dina narik munggaran 0-90. Lamun Nyandak otomatis hurung teu dicentang, mutasi ngan datang ku Candak ayeuna. Simpen teras tutup.

Pasang heula koneksi latihan ku driver Simulasi (ngaran pamaké demo): anjeun ningali opat léngkah, narik, jeung pencocokan tanpa ngadagoan bank nyata. Ku nulis baris giris|nilai|katerangan|pihak lawan|NPWP dina kotak "Mutasi conto", anjeun bisa nyobaan pencocokan jeung faktur kabuka anjeun sorangan. Hapus koneksi sanggeus latihan.

5. Narik, panjaga duplikat, jeung pencocokan

Unggal narik ménta mutasi mimiti hiji poé saméméh narik suksés panungtung nepi ka poé ieu (dina narik munggaran saloba "poé mundur"; pangloba 31 poé sakaligus). Poé anu tumpang tindih dihaja: mutasi anu sarua dipikawanoh tina rujukan bank, tanggal, nilai, jeung arah, diitung duplikat, sarta teu ditulis.
Mutasi anyar asup ka jandéla Mutasi Bank kalayan sumber "Langsung" sarta langsung dicocogkeun (pasti / saran / teu acan cocog). Kuitansi otomatis henteu jalan dina narik langsung: kuitansi pikeun cocog pasti dijieun tina jandéla.
Lamun engké anjeun ogé ngunggah rekening koran poé anu sarua minangka berkas MT940, baris kalayan rujukan bank anu sarua némbongan salaku duplikat.

6. Narik otomatis jeung béwara

Narik otomatis pareum sacara bawaan di server; administrator sistem ngaktifkeunana ku BANKA_CANLI_GOREV=1. Nalika hurung, unggal koneksi disinkronkeun ku intervalna sorangan. Sanggeus aya kasalahan, waktu ngadagoan jadi dua kali lipet unggal nyobaan (pangpanjangna 6 jam); dina kasalahan permanén saperti kredénsial ditolak, perjangjian tacan aya, atawa setélan teu lengkep, nyobaan otomatis eureun sarta ngadagoan administrator. Nalika mutasi anyar ditarima, administrator anu masang koneksi meunang talatah dina Talatah yén mutasi bank anyar ditarima sarta sababaraha mutasi ngantosan pencocokan; dina kasalahan katilu padeukeut, peringetan dikirim sakali. Koneksi anu salah ogé didaptarkeun dina bagian Antrian layar Nadi.

7. Status jeung sabab kasalahan

Dina layar	Harti jeung anu kudu dipigawé
Parantos dikonfigurasi, ngantosan uji	Disimpen; pencét Uji koneksi.
Koneksi jalan	Uji atawa narik panungtung hasil.
Peryogi perjanjian sareng bank	Dokumén layanan pikeun bank ieu tacan aya, atawa bank tacan muka layananana. Ajukeun ka bank ku daptar dina bagian 2.
Kredénsial ditolak	Kecap konci/secret/persetujuan kadaluwarsa atawa salah. Asupkeun nilai anyar tuluy uji deui. Nyobaan otomatis eureun dina kasalahan ieu.
Bank teu tiasa dihubungi · Layanan bank samentawis teu ngabales	Masalah samentawis dina jaringan atawa di bank; narik otomatis nyobaan deui kalayan interval anu beuki panjang.
Pangaturan koneksi teu acan lengkep	Kolom wajib kosong, alamat lain https, atawa tacan aya pemetaan rekening. Lengkepan formulir.

8. Tab Langsung jeung log sinkronisasi

Tab Mutasi Bank › Langsung némbongkeun status unggal koneksi, sinkronisasi panungtung, narik suksés panungtung, jumlah rekening anu dipetakeun, jeung interval narik; angka beureum dina ngaran tab nyaéta jumlah koneksi anu salah. Di dieu administrator bisa mencét Candak ayeuna sarta muka Log sinkronisasi: unggal baris eusina waktu, alesan (manual / penjadwal / nalika jandéla dibuka / uji koneksi), status, jumlah ditarima, anyar, duplikat, pasti, jeung saran, ogé talatah kasalahan lamun aya. Kredénsial moal ditulis kana log.

9. Idin jeung kaamanan

Nyieun, ngarobah, mupus, jeung nguji koneksi, Candak ayeuna, jeung log: ngan administrator sistem. Pamaké séjén anu boga idin Bank ngan ningali status dina tab Langsung.
Kredénsial moal dibaca deui ngaliwatan API; layar ngan némbongkeun lencana "disimpen diénkripsi". Lamun nilai anu diénkripsi disalin ka koneksi atawa pausahaan séjén, nilaina teu bisa didékripsi.
Alamat bank ngan meunang https://; ngan panggilan maca anu dilakukeun ka bank; unggal lampah dicatet dina jejak audit (saha, iraha, IP mana).

10. Dina telepon

Dina jandéla Mutasi Bank, tab katilu nyaéta Langsung: kartu koneksi, status, sinkronisasi panungtung, jeung tombol badag Candak ayeuna.
Dina telepon, formulir koneksi di Setélan dibuka léngkah demi léngkah: Bank → Kredénsial → Uji → Rekening.

11. Patarosan anu sering ditaroskeun

Patarosan	Jawaban
Naha abdi tiasa ngasupkeun kecap konci internet banking abdi sorangan?	Henteu. Koneksi jalan ku pamaké layanan wéb anu dikaluarkeun bank husus pikeun integrasi ERP, atawa ku persetujuan open banking. Ulah pernah méré kecap konci internet banking anjeun ka sistem mana waé.
Bank abdi aya dina daptar tapi statusna "Peryogi perjanjian sareng bank".	Dokumèn layanan bank durung dilebokaké ing driver. Hubungana cabang nganggo dhaptar "Informasi sing kudu dijaluk saka bank" ing pérangan 2; sawisé dokumèn teka, driver dirampungaké lan uji sambungan dibukak.
Naha mutasi henteu datang sorangan?	Boh Nyandak otomatis hurung teu dicentang pikeun koneksi éta, boh tugas narik otomatis di server pareum (lain `BANKA_CANLI_GOREV=1`). Bagian luhur tab Langsung nyebutkeun mana anu lumaku; samentawis éta Candak ayeuna bisa dipaké.
Kumaha mutasi anu geus ditarik lamun koneksi dihapus?	Tetep aya. Anu dihapus ngan koneksi jeung kredénsial anu disimpen; mutasi, pencocokan, jeung kuitansi anu geus dijieun tetep aya.

Panduan patali: Mutasi Bank · Kauangan · Setélan · Sélulér.