Iza državnog API-ja: integracija fiskalizacije u softver

Integracija fiskalizacije u softver danas je standardni dio posla u jugoistočnoj Evropi. Poreske uprave traže podatke o računu u realnom vremenu. Traže ih i u svom formatu, potpisane svojim ključevima. Zbog toga platforma projektovana prije pet godina danas može pasti na kontroli.

Povezani vodič: Pročitajte i naš vodič o API-ju za fiskalizaciju za to šta takav interfejs radi, uz pravila po državama.

Šta pravila zaista traže

Fiskalizacija znači da svaka prodaja putuje do državne platforme dok se dešava. Albanija, Kosovo, Sjeverna Makedonija, Srbija, Hrvatska i Crna Gora vode takvu šemu. Svaka poreska uprava izabrala je drugačiji dizajn. Neke traže potpis na računu prije nego kupac plati. Druge puštaju kasu da radi van mreže, pa se sinhronizuje kasnije istog dana.

Gotovi proizvodi rijetko pokrivaju više od jednog takvog dizajna. Namjenski softver mora pokriti sve, i tu počinje pravi posao. Većini inženjera su pravila lakša od infrastrukture oko njih. Zato integracija fiskalizacije u softver rijetko stane u jedan sprint.

Zašto državni API nikad nije dovoljan

Državni API-ji rade jedan posao: primaju ispravan račun i vraćaju kod. Stižu sa tankom dokumentacijom i slabom podrškom za programere. Pošto se pravila stalno mijenjaju, krajnja tačka koju ste povezali prošlog proljeća seli se na jesen. Timovi onda gube dane na pogađanje umjesto na proizvod.

Sirov API zahtjev nema pamćenje. Ne može staviti neuspjelu prodaju u red, ponoviti je, niti vas upozoriti da ništa nije otišlo od ručka. Sve to mora dati vaša aplikacija. Zato integracija fiskalizacije u softver znači gradnju sloja, a ne puko povezivanje.

Detalji koji ruše timove

Brojevi računa moraju pratiti stroga nacionalna pravila. Rupa ili nulovanje na pogrešnom mjestu poništava cio dnevni promet. Certifikati takođe ističu, a jedan stari ključ gasi sve kase odjednom.

Brzina je jednako važna. Prodavnica u špicu ne može čekati četiri sekunde na račun. Zbog toga zahtjev ne pripada putanji naplate, već redu čekanja iza nje. Prodaja se tada završi brzo, a poziv državi stigne malo kasnije.

Slijedi dosadni dio koji vas štiti: revizorski zapis. Poreski službenici mogu tražiti cio trag transakcija i mnogo mjeseci kasnije. Ukratko, ako ne možete pokazati šta ste poslali i kada, imate pravi problem.

Svaka djelatnost ima drugi profil

Prodavnice guraju ogroman promet u vrlo kratkim naletima, pa brzina pobjeđuje. Hoteli dijele račune, drže depozite i mijenjaju cijene poslije dolaska. Klinike fakturišu i pacijentu i osiguranju za istu posjetu. Prevoznici izdaju račune na više tržišta i u više valuta.

Jedan šablon neće zadovoljiti sva četiri slučaja. Mapiranje vašeg modela podataka u državni format mora pratiti to kako djelatnost radi. To mapiranje je pravi proizvod i guta najviše razmišljanja.

Certifikati, pristup i privatnost

Fiskalni saobraćaj nosi imena ljudi, iznose i poreske brojeve. Zato zaslužuje istu pažnju kao podaci sa platnih kartica. Držite certifikate u trezoru, nikad u repozitorijumu. Rotirajte ih po rasporedu i dižite uzbunu mnogo prije isteka.

Do podešavanja fiskalizacije treba da stigne samo mali broj ljudi. Firme koje trguju unutar Evropske unije moraju ispuniti i GDPR pravila o tome koliko dugo drže ove podatke. Godišnja provjera ko šta smije čitati košta malo, a sprječava skupa iznenađenja.

Stavite jedan sloj integracije u sredinu

Čistiji dizajn je mali servis između vaših aplikacija i države. Svaka aplikacija priča sa tim jednim servisom. Servis onda priča sa svakom državom na njenom dijalektu. Tako integracija fiskalizacije u softver ostaje na jednom mjestu.

Takva postavka donosi dosta. Prvo, državnu logiku pišete tačno jednom. Drugo, možete je testirati odvojeno od kase. Treće, dogodine dodajete novu aplikaciju bez diranja koda usklađenosti. Taj sloj daje i jedno mjesto za praćenje dubine reda, broja ponovnih pokušaja i odbijenih slanja.

Spremite se za težak dan

Pravila u realnom vremenu pretvaraju dostupnost u prodajno, a ne u tehničko pitanje. Ako veza padne, prodavnica i dalje mora primiti plaćanje. Otuda red čekanja, lokalna baza i jasna putanja sinhronizacije kad se veza vrati.

Dvije mašine su bolje od jedne. Isto tako, noćni izvoz reda u hladno skladište košta gotovo ništa. Testirajte prelazak na rezervu prije lansiranja, nikad poslije.

Rast preko granice donosi posao

Mnoge firme ovdje rade na tri ili četiri tržišta odjednom. Svaka poreska uprava drži svoj identifikator, svoj raspored polja i svoju šemu potpisa. Umjesto da granate kod po državi, držite jedan servis sa adapterom po tržištu.

Tako promjena pravila u Skoplju nikad ne kasni izdanje u Tirani. To snižava i cijenu sljedeće granice koju pređete. Pošto je adapter prilično mali, novo tržište postaje pitanje sedmica umjesto mjeseci.

Prepustite provjeru automatizaciji

Većina odbijenih slanja nastaje iz sitnih grešaka u formatu. Izlazni provjeravač ih hvata prije nego ih državna platforma uopšte vidi. Stopa odbijanja onda pada, a ljudi prestaju da prekucavaju isti račun.

Upozorenja su jednako važna. Poruka kad red pređe pedeset stavki bolja je od ružnog otkrića na kraju mjeseca. Finansije tada troše vrijeme na analizu, a ne na jurnjavu za dokumentima.

Kako Square Software pristupa problemu

Square Software razvija namjenski softver i povezuje ga sa sistemima trećih strana i države. Radimo po modelu utrošenog vremena i materijala, po cijeni od 35-55 EUR na sat. Kakav posao isporučujemo možete vidjeti na našoj stranici proizvoda. Ili pročitajte kako sastavljamo tim na stranici o autsorsingu.

Ako prvo želite grubu cifru, naš procjenjivač projekta daje je u nekoliko klikova. Ako radije razgovarate direktno, kontakt stranica ostaje najkraći put.

Greške koje viđamo iznova

Prvo, timovi vide posao kao jedan poziv API-ja i preskoče red čekanja. Drugo, testiraju samo srećni put, pa prvo odbijanje u petak uveče prođe nezapaženo. Treće, niko ne drži ključeve za potpis, pa jedan propust obori cijelu radnju.

Evo još jedne. Izbor krutog proizvoda koji se ne mijenja kad se pravila pomjere izgleda jeftino prve godine. Onda traži potpunu prepravku u trećoj godini.

Kuda ovo ide

Državne poreske platforme rastu širom Evrope. Evropska unija je postavila zajednički format elektronskog računa za javna tijela kroz Direktivu 2014/55/EU. Nacionalne šeme idu istim putem. Albanija svoja pravila i uputstva objavljuje na sajtu poreske uprave.

Očekujte čvršće veze između fiskalnih platformi, bankarskih sistema i računovodstvenog softvera. Očekujte i više provjera prije nego se prodaja završi, a ne poslije. Ukratko, integracija fiskalizacije u softver ličiće na osnovnu infrastrukturu koju crtate od prvog dana.

Ukratko

Fiskalna pravila ne nestaju i ne postaju jednostavnija. Tanak omotač oko državnog API-ja preživjeće demonstraciju i pasti u prometnu subotu.

Napravite red čekanja, validaciju, upozorenja i raspored ključeva unaprijed. Državnu logiku držite na jednom mjestu, pa još jedno pravilo ili još jedna granica ostaje skroman posao. Uradite to, i integracija fiskalizacije u softver prestaje da bude rizik. Postaje funkcija koju možete prodati.

Više o strani API-ja stoji u našem vodiču o API-jima za fiskalizaciju.