VMTech
Razgovarajmo
← Sve kompetencije
SISTEMI I INTEGRACIJE · 07

API integracije

Svaki sistem pojedinačno radi. Problemi počinju na spojevima: podaci se prenose ručno i niko ne zna koja je kopija tačna. Integracija uklanja spojeve.

Razgovarajmo
RAZMENA PODATAKA

Kako porudžbina stiže do svih sistema odjednom

Jedan događaj na sajtu — i podaci se razilaze po sistemima u potrebnom formatu, uz proveru i ponavljanje pri prekidu.

sync.vmtech.rs
Događaj: porudžbina plaćena
LIVE
svi sistemi sinhroni
Događaj zabeležen webhook primljen
Podaci svedeni na format polja mapirana
Poslato u CRM prilika #2184
Poslato u magacin stanje ažurirano
Provera odgovora ponovo za 30 s
Upisano u dnevnik svi sistemi sinhroni
RAZMENA PODATAKA
  1. Događaj zabeleženSajt šalje webhook: šta se desilo, sa kojom porudžbinom i kada tačno
  2. Podaci svedeni na formatPolja se mapiraju: šifra sa sajta — šifra magacina, valuta, jedinice, poreska stopa
  3. Poslato u CRMKreira se prilika sa zaduženim, izvorom i istorijom — ili se ažurira postojeća
  4. Poslato u magacinRoba se skida sa stanja, dokumenti se formiraju u sistemu evidencije
  5. Provera odgovoraAko je sistem odgovorio greškom, korak se ponavlja, a ne gubi se tiho
  6. Upisano u dnevnikVidi se šta je poslato, šta je vraćeno i koliko je trajala svaka razmena
POZNATA SLIKA

Šta se dešava kada sistemi ne razgovaraju

Ručna razmena

  • Ista porudžbina se unosi dvaput: na sajtu i u programu za evidenciju
  • Izvoz u tabelu jednom dnevno — znači da su zalihe pola dana netačne
  • Greška se otkriva nakon nedelju dana, kada se sabiraju brojevi
  • Niko ne zna koji sistem čuva ispravnu cenu
  • Kada zaposleni ode, proces staje: bio mu je „u glavi“

Razmena podešena

  • Podaci se unose jednom i stižu tamo gde treba, u potrebnom obliku
  • Zalihe i cene ažuriraju se po događaju, a ne jednom dnevno
  • Prekid se vidi odmah: zaduženi dobija obaveštenje sa tekstom greške
  • Za svako polje određen je izvor istine — nema oko čega da se raspravlja
  • Proces je opisan i radi bez obzira na to ko je danas u kancelariji
OBIM POSLA

Šta ulazi u projekat integracije

Analiza sistema i podataka

Koji sistemi učestvuju, koja polja imaju i šta se smatra izvorom istine za svaku vrednost.

Šema razmene

Šta se i kuda prenosi, u kom trenutku, kojom učestalošću i šta se dešava pri sukobu podataka.

Mapiranje polja

Šifre, jedinice mere, valute, poreske stope i statusi svode se na zajednički rečnik.

Razvoj veza

REST i SOAP API, webhooks, razmena fajlova preko FTP-a, direktna veza sa bazom — što sistem nudi.

Obrada grešaka

Ponovni pokušaji, red neisporučenog, obaveštenja zaduženom i ručno pokretanje razmene.

Dnevnik razmene

Istorija svakog zahteva i odgovora, da se sporni slučajevi rešavaju činjenicama, a ne sećanjem.

Test okruženje

Razmenu proveravamo na kopiji podataka, da se radne baze ne kvare tokom podešavanja.

Dokumentacija i predaja

Šema razmene, opis polja i uputstvo šta raditi ako se spoljni sistem promeni.

TEHNOLOŠKI OKVIR

Čime povezujemo

REST / JSONOsnovni način razmene sa savremenim servisima i cloud CRM-ovima
WebhooksDogađaji stižu odmah, bez ispitivanja sistema svakih nekoliko minuta
SOAP / XMLFormat u kom i dalje radi deo knjigovodstvenih i bankarskih sistema
Razmena fajlovaCSV i XML preko FTP-a ili SFTP-a tamo gde API ne postoji
Redovi zadatakaRazmena ne blokira sajt i preživljava nedostupnost spoljnog sistema
Nadzor razmeneObaveštenje ako se tok zaustavi ili udeo grešaka poraste

Pristupi spoljnim sistemima i licence ostaju kod Vas. Radimo u okviru onoga što njihov interfejs dozvoljava i unapred kažemo ako sistem ne nudi potrebnu mogućnost.

PITANJA

Šta se obično pita pre početka

Naš sistem nema API. Šta onda?

Mogućnosti je obično više nego što izgleda. Mnogi programi umeju da izvoze i primaju fajlove po rasporedu — to je dovoljno za zalihe i cene. Ponekad postoji pristup bazi za čitanje. Ako nema ni jednog ni drugog, ograničenje ćemo reći pre početka posla, a ne posle.

Koliko često će se podaci ažurirati?

Zavisi od toga šta sistem dozvoljava i šta poslu treba. Porudžbine i plaćanja obično odlaze odmah po događaju. Zalihe i cene — po događaju ako postoje webhooks, ili po rasporedu ako se sistem mora ispitivati. Učestalost biramo tako da ne udarimo u ograničenja broja zahteva.

Šta ako spoljni sistem promeni API?

To se dešava, pa je razmena napravljena tako da prekid bude vidljiv. Nadzor hvata porast grešaka, dnevnik pokazuje koji zahtev više ne prolazi, a red čuva podatke do popravke. Popravimo vezu i ponovimo nakupljeno — izgubljenih porudžbina ne ostaje.

Mogu li se povezati dva sistema koja istog klijenta vode različito?

Da, ali prvo treba dogovoriti pravilo uparivanja: po telefonu, mejlu ili PIB-u. Analiziramo stvarne duplikate u Vašim bazama i predlažemo pravilo sa najmanje grešaka, a sporne slučajeve izdvajamo u listu za ljudsku proveru.

Ko je vlasnik koda integracije?

Vi. Kod, šema razmene i dokumentacija predaju se uz projekat, pristupi serveru ostaju Vaši. Ne pravimo integraciju kao „crnu kutiju“ koja se bez nas ne može održavati.