Bank Gateway for Microsoft Dynamics 365 Business Central
Nosūtiet maksājumus un saņemiet izrakstus tieši no Business Central — bez failu lejupielādes un augšupielādes internetbankā.
Bank Gateway nodrošina tiešu API savienojumu starp Business Central un Latvijas bankām. Maksājumu uzdevumi tiek nosūtīti no Maksājumu žurnāla ar vienu klikšķi, bankas izraksti tiek importēti automātiski, un katrs API zvans tiek ierakstīts audita žurnālā ar pilnu pieprasījuma/atbildes XML.
Kas padara Bank Gateway atšķirīgu
-
Tiešs API savienojums — nav nepieciešama starpniekprogrammatūra vai failu apmaiņa. Business Central sazinās ar banku tieši caur mTLS sertifikātu.
-
Reāllaika maksājumu statuss — pēc nosūtīšanas redziet maksājuma statusu tieši BC: Pieņemts (ACTC), Apstiprināts (ACSC) vai Noraidīts (RJCT).
-
Validācija pirms nosūtīšanas — SEPA pain.001 validācija pārbauda uzņēmuma datus, bankas SWIFT kodu, saņēmēja IBAN un summu. Kļūdas parādās Maksājumu faila kļūdu panelī.
-
Pilns audita žurnāls — katrs API zvans (POST, GET, DELETE) tiek ierakstīts ar HTTP statusu, pieprasījuma/atbildes XML un laika zīmogu. Iebūvēts XML skatītājs.
-
Automātisks izrakstu imports — camt.053 bankas izraksti un camt.052 dienas pārskati tiek importēti tieši Bankas konta saskaņošanā vai Virsgrāmatas žurnālā.
Atbalstītās bankas
| Banka | Statuss | API | Iespējas |
|---|---|---|---|
| Swedbank | Pilnībā ieviests | Swedbank Gateway (SGW) | Izraksti, maksājumi, dienas pārskati |
| SEB | Plānots | SEB Baltic Gateway (BGW) | Izraksti, maksājumi |
Galvenās funkcijas
Maksājumu nosūtīšana
-
SEPA Credit Transfer (pain.001.001.09) eksports un nosūtīšana
-
Validācija pirms nosūtīšanas ar kļūdu attēlošanu FactBox panelī
-
Maksājuma statusa pārbaude (pain.002 atbilde)
-
Automātiska žurnāla rindu atzīmēšana ar statusu un ziņojuma ID
Bankas izrakstu imports
-
camt.053 izrakstu imports Bankas konta saskaņošanā
-
camt.053 imports Virsgrāmatas žurnālā
-
camt.052 dienas pārskatu imports
-
Datumu diapazona izvēle ar pēdējā izraksta datuma noteikšanu
Gateway žurnāls
-
Pilns API zvanu audits (pieprasījums/atbilde)
-
HTTP statusa kods un izpildes laiks
-
Iebūvēts XML skatītājs ar formatētu attēlojumu
-
Kļūdu ziņojumu saglabāšana diagnostikai
Drošība un sertifikāti
-
mTLS autentifikācija ar PFX/P12 transporta sertifikātu
-
Sertifikāta Subject un derīguma termiņš redzams tieši Bankas konta kartiņā — brīdinājums, ja termiņš beidzas tuvākajās 30 dienās
-
Akreditācijas dati glabājas IsolatedStorage (šifrēti, per-uzņēmums)
-
Sandbox režīms testēšanai bez ietekmes uz ražošanas vidi
Priekšrocības salīdzinājumā ar failu apmaiņu
| Failu apmaiņa (iepriekš) | Bank Gateway (tagad) |
|---|---|
| Manuāli lejupielādēt failu no internetbankas | Automātiski saņemt izrakstu no BC |
| Manuāli augšupielādēt maksājumu failu | Nosūtīt maksājumu tieši no Maksājumu žurnāla |
| Nav reāllaika statusa | Redzēt maksājuma statusu BC — Pieņemts / Noraidīts / Gaida |
| Nav audita ierakstu | Pilns API zvanu žurnāls ar pieprasījuma/atbildes XML |
| Manuāla kļūdu pārbaude | Automātiska validācija ar kļūdu paneli |
Darba sākšana
-
Instalējiet Bank Gateway paplašinājumu no Microsoft AppSource
-
Noslēdziet līgumu ar banku un saņemiet transporta sertifikātu
-
Bankas konta kartiņā cilnē Bank Gateway iestatiet Gateway tipu, augšupielādējiet sertifikātu un ievadiet API atslēgu
-
Pārbaudiet savienojumu ar Testēt savienojumu darbību
Skatiet sadaļu Swedbank pieslēgšana detalizētai soli-pa-solim instrukcijai.
Dokumentācijas struktūra
-
Swedbank pieslēgšana — līguma noslēgšana, sertifikāta saņemšana, Developer portāla reģistrācija
-
Iestatījumi Business Central — Gateway konfigurācija bankas konta kartiņā, sertifikāta augšupielāde, sandbox režīms
-
Izrakstu saņemšana — automātiska camt.053/camt.052 izrakstu un dienas pārskatu iegūšana
-
Maksājumu nosūtīšana — SEPA CT maksājumu sagatavošana, validācija, nosūtīšana un statusa pārbaude
-
Gateway žurnāls — API zvanu audita ieraksti, XML skatītājs, kļūdu diagnostika
Galvenie termini
| Termins | Nozīme |
|---|---|
| Gateway | API savienojums starp Business Central un bankas sistēmu |
| mTLS | Mutual TLS — abpusēja sertifikātu autentifikācija starp BC un banku |
| pain.001 | ISO 20022 SEPA Credit Transfer maksājuma uzdevuma formāts |
| pain.002 | ISO 20022 maksājuma statusa atbilde no bankas |
| camt.053 | ISO 20022 bankas konta izraksta formāts (end-of-day) |
| camt.052 | ISO 20022 dienas pārskata formāts (intraday) |
| ACTC | Accepted Technical — banka pieņēmusi maksājumu apstrādei |
| ACSC | Accepted Settlement Completed — maksājums izpildīts |
| RJCT | Rejected — maksājums noraidīts |
| Sandbox | Bankas testa vide, kas ļauj pārbaudīt API bez reāliem maksājumiem |