Business Central 365 (BC365) integrācija nosūta neapstrādātus darba laika sākuma un beigu reģistrācijas notikumus (clock-in / clock-out) no Begin tieši uz Microsoft Dynamics 365 Business Central, izmantojot REST API. Pēc tam BC365 veic savu darba samaksas aprēķinu, balstoties uz šiem notikumiem.
BC365 ir pielāgota integrācija, kas tiek aktivizēta katram kontam individuāli. Tā nav redzama partneru integrāciju sarakstā, kamēr Begin komanda nav piešķīrusi piekļuvi jūsu kontam, tādēļ tā nav pieejama standarta demonstrācijas kontā. Integrācija ir pieejama klientiem Igaunijā.
Kā tas darbojas
Begin pieslēdzas Business Central darbinieku eksporta periodu galapunktam (employee export periods endpoint) un nosūta reģistrācijas intervālus (darbinieka kods, sākuma laiks, beigu laiks) izvēlētajam periodam.
Integrācija atbalsta divus autentifikācijas veidus:
Azure AD OAuth (ieteicams) — Begin autentificējas, izmantojot Azure AD ģenerētu Tenant ID, Client ID un Client Secret.
Mantotā Basic autentifikācija — vecākām Business Central versijām, kas joprojām atbalsta statisku
Authorizationgalveni ar Base64 kodētuusername:webServiceAccessKey.
Izmantojiet tikai vienu autentifikācijas veidu, otru atstājot tukšu. Ja ir aizpildīti abi, Begin prioritāri izmantos OAuth.
Piekļuves dati
Integrācijas konfigurācijas forma ietver:
API URL (obligāts) — pilna resursa adrese, kas beidzas ar BC365 eksporta galapunktu, piemēram:
https://{host}/{environment}/api/v2.0/companies({companyId})/employeeExportPeriodsTenant ID (OAuth) — Azure AD direktorijas identifikators.
Client ID (OAuth) — Azure AD lietotnes identifikators.
Client Secret (OAuth) — Azure AD klienta slepenā atslēga.
Authorization Header (mantotā autentifikācija) — pilna statiskā Authorization galvenes vērtība, ieskaitot
Basicprefiksu un Base64 kodēto saturu.
Begin glabā visus piekļuves datus šifrētā veidā. Pēc saglabāšanas Client Secret un Authorization Header tiek paslēpti, un tie būs jāievada atkārtoti tikai tad, ja izvēlēsieties tos nomainīt.
Kādi dati tiek eksportēti
Katram ierakstam tiek nosūtīti lauki, kurus nosaka BC365 importa formāts. Begin sistēmā tie ir redzami tikai lasīšanas režīmā:
Darbinieka eksporta kods
Ieraksta sākums — darba laika sākuma (clock-in) laiks
Ieraksta beigas — darba laika beigu (clock-out) laiks
Tā kā BC365 sagaida neapstrādātus notikumus, Begin nosūta sākotnējos darba laika sākuma un beigu pārus (sadalītus ap pārtraukumiem), nevis apkopotu nostrādāto stundu kopsummu. Virsstundu, darba brīvdienās un svētku dienās aprēķinus veic pats BC365 algu aprēķina modulis.
Filtrēšana pēc atrašanās vietas
BC365 atbalsta izvēles atrašanās vietas filtru. Varat ierobežot katru sinhronizāciju vienai vai vairākām Begin struktūrvienībām vai filiālēm. Tas ir noderīgi, ja viena BC365 uzņēmuma datubāze saņem datus no vairākām Begin darba vietām.
Iestatīšana
Sazinieties ar Begin atbalsta komandu, lai aktivizētu BC365 integrāciju jūsu kontam.
Business Central vai Azure AD vidē sagatavojiet autentifikāciju. Ja izmantojat OAuth, reģistrējiet lietotni, piešķiriet tai piekļuvi BC365 tīmekļa servisam un izveidojiet Client Secret.
Begin sistēmā atveriet Integrācijas → Business Central 365 un ievadiet API URL, kā arī OAuth vai mantotās autentifikācijas datus.
Saglabājiet iestatījumus. Begin pārbaudīs piekļuves datus, veicot piekļuves marķiera (OAuth) vai autentificētu testa pieprasījumu (mantotā autentifikācija).
Izvēlieties automātiskās sinhronizācijas grafiku (cron) vai izmantojiet Run Sync, lai veiktu tūlītēju datu nosūtīšanu.
Sinhronizācijas vēsture
Katrs sinhronizācijas mēģinājums tiek reģistrēts integrācijas Sinhronizācijas vēsturē, kur redzams:
sinhronizētais periods;
nosūtīto un pieņemto ierakstu skaits;
BC365 API atbilde.
Autentifikācijas kļūdas (piemēram, beidzies Client Secret derīguma termiņš, nepareizs Tenant ID vai kļūdains API URL) tiek attēlotas kopā ar attiecīgo HTTP statusa kodu.
Problēmu novēršana
401 Unauthorized
OAuth gadījumā izveidojiet jaunu Client Secret Azure AD un ievadiet to Begin sistēmā. Mantotās autentifikācijas gadījumā pārbaudiet, vai Base64 kodējums satur gan lietotājvārdu, gan Web Service Access Key.
404 Not Found
API URL jābeidzas ar BC365 eksporta resursu (employeeExportPeriods vai tam ekvivalentu). Ja trūkst pēdējās URL daļas, tiks saņemta 404 kļūda.
Darbinieki netiek eksportēti — nav eksporta koda
Norādiet darbiniekam eksporta kodu, kas atbilst BC365 darbinieka identifikatoram.
Sinhronizācijas grafiks apturēts
Atkārtotu kļūdu gadījumā automātiskā sinhronizācija tiek apturēta. Novērsiet kļūdas cēloni un pēc tam atkārtoti aktivizējiet grafiku.
Nepieciešama papildu palīdzība?
OAuth konfigurēšanai var būt nepieciešama sadarbība ar jūsu Azure AD administratoru. Ja sinhronizācijas kļūdas saglabājas, sazinieties ar Begin atbalsta komandu, izmantojot lietotnē pieejamo tērzēšanu vai rakstot uz info@begin.lv. Norādiet attiecīgā sinhronizācijas ieraksta ID — mēs palīdzēsim analizēt BC365 kļūdas atbildi.