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ā.
-
IBAN-bāzēta automātiska piemērošana — Maksājumu saskaņošanas žurnālā nepiemērotām rindām tiek piedāvāts Klients/Piegādātājs/Darbinieks pēc sūtītāja IBAN, izmantojot vēsturi un master-data datus. Match Confidence kolonna parāda piedāvājuma uzticamību.
-
Automātiska grāmatošana ar augstu ticamību — pēc izvēles, Gateway iegūtās paketes ar visām rindām augstā ticamībā tiek grāmatotas automātiski "Grāmatot tikai maksājumus" režīmā. Lietotāja iesaiste paliek nepieciešama tikai rindām ar zemāku ticamību.
Atbalstītās bankas
| Banka | Statuss | API | Iespējas |
|---|---|---|---|
| Swedbank | Pilnībā ieviests | Swedbank Gateway (SGW) | Izraksti, maksājumi, dienas pārskati |
| SEB | Pilnībā ieviests | SEB Baltic Gateway (BGW) | Izraksti, dienas pārskati, maksājumu imports ar statusa pārbaudi |
Abas bankas izmanto vienu un to pašu BC Bank Gateway integrāciju ar mTLS sertifikātu un ISO 20022 formātiem. Atšķiras tikai pieslēguma dati (Swedbank — Agreement ID + API atslēga; SEB — reģistrācijas numurs/OrgId) un dažas tehniskās nianses, kas lietotājam nav redzamas.
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
-
SEB pieslēgšana — Baltic Gateway līguma noslēgšana, CSR izveide, sertifikāta saņemšana un PFX konvertēšana, pakalpojumu aktivizā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, Job Queue plānošana
-
Automātiska piemērošana — IBAN un vēstures bāzēta nepiemēroto rindu piedāvājumu ģenerēšana Maksājumu saskaņošanas žurnālā
-
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
-
Saistīšanas ID tīrīšana — atskaite pamesto Applies-to ID notīrīšanai pēc dzēstām bankas saskaņošanām (drošs darbs zem Procesa rindas)
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 |
| BGW | SEB Baltic Gateway — SEB API tiešajam savienojumam ar BC |
| OrgId | Uzņēmuma reģistrācijas numurs; SEB to izmanto pieslēguma identificēšanai (ievada laukā Līguma ID) |
| Sandbox | Bankas testa vide, kas ļauj pārbaudīt API bez reāliem maksājumiem |