Oltre l'API statale: integrare la fiscalizzazione nel software su misura

Integrare la fiscalizzazione nel software su misura ormai fa parte del mestiere in tutto il Sud-Est Europa. Il fisco vuole i dati delle vendite in tempo reale. Inoltre li chiede nel proprio formato, firmati con le proprie chiavi. Per questo motivo un gestionale nato cinque anni fa oggi rischia un rilievo in sede di controllo.

Guida correlata: leggi anche la nostra guida all'API di fiscalizzazione, cioè che cosa fa quella interfaccia e quali regole valgono paese per paese.

Che cosa chiedono davvero le regole

Fiscalizzazione vuol dire che ogni vendita viaggia verso una piattaforma statale mentre accade. Albania, Kosovo, Macedonia del Nord, Serbia, Croazia e Montenegro seguono tutti questa strada. Ogni fisco però ha scelto un disegno diverso. Alcuni chiedono la firma sulla fattura prima del pagamento. Altri invece lasciano lavorare la cassa offline, con allineamento più tardi.

I prodotti pronti a scaffale coprono di rado più di un disegno. Il software su misura invece deve coprirli tutti. Qui comincia il lavoro vero. Infatti quasi tutti gli sviluppatori trovano le regole più semplici degli impianti che stanno intorno.

Perché un'API statale non basta mai

Le API statali fanno una cosa sola: accettano una fattura valida e restituiscono un codice. Arrivano con poca documentazione e con scarso supporto. Poiché le regole cambiano spesso, l'endpoint integrato in primavera si sposta in autunno. I team quindi perdono giornate a indovinare invece che a costruire prodotto.

Una chiamata grezza non ha memoria. Non sa mettere in coda una vendita fallita, non la ripete e non avvisa nessuno. Tutto questo tocca alla tua applicazione. Perciò integrare la fiscalizzazione nel software su misura vuol dire costruire uno strato, non solo una connessione.

I dettagli che mettono in crisi i team

La numerazione delle fatture segue regole nazionali rigide. Un salto o un azzeramento fuori posto può annullare un'intera giornata di incassi. Anche i certificati scadono. Una sola chiave vecchia blocca tutte le casse insieme.

Pesa allo stesso modo la velocità. Un negozio in ora di punta non aspetta quattro secondi per uno scontrino. Per questo la chiamata sta fuori dal percorso di cassa, con una coda dietro. Così la vendita si chiude subito e il messaggio al fisco arriva poco dopo.

Poi arriva la parte noiosa che ti salva: il registro di audit. Gli ispettori possono chiedere l'intera traccia delle transazioni molti mesi dopo. In breve, se non mostri che cosa hai inviato e quando, hai un problema serio.

Ogni settore ha un profilo diverso

I negozi spingono grandi volumi in pochi minuti, quindi vince la velocità. Gli alberghi dividono i conti, tengono le caparre e correggono le tariffe dopo l'arrivo. Le cliniche fatturano al paziente e all'assicurazione per una sola visita. I trasportatori emettono fatture in più mercati e in più valute.

Un modello unico non basta per tutti e quattro. Piuttosto, la mappatura fra i tuoi dati e il tracciato statale deve seguire il modo in cui lavora il settore. Quella mappatura è il prodotto vero. Inoltre assorbe quasi tutto il ragionamento.

Certificati, accessi e privacy

Il traffico fiscale porta nomi, importi e codici fiscali. Merita quindi la stessa cura dei dati delle carte di pagamento. Tieni i certificati dentro un vault, mai dentro un repository. Ruotali a calendario e fai scattare gli avvisi molto prima della scadenza.

Solo poche persone dovrebbero toccare le impostazioni di fiscalizzazione. Chi lavora dentro l'Unione Europea deve anche rispettare le regole del GDPR sui tempi di conservazione. Una revisione annuale di chi legge che cosa costa poco ed evita sorprese care.

Un solo strato di integrazione al centro

Il disegno più pulito è un servizio compatto fra le tue applicazioni e il fisco. Ogni applicazione parla con quel servizio. Poi il servizio parla con ogni paese nel suo dialetto.

Questo assetto ti dà molto. Primo, scrivi la logica fiscale una volta sola. Secondo, la provi separata dalla cassa. Terzo, l'anno prossimo aggiungi un'altra applicazione senza toccare il codice di conformità. Inoltre hai un punto solo da guardare per code, tentativi e invii respinti.

Preparati al giorno difficile

Le regole in tempo reale rendono la continuità un tema commerciale, non tecnico. Se la linea cade, il negozio deve comunque incassare. Servono dunque la coda, l'archivio locale e una via di allineamento chiara al ritorno della rete.

Due macchine battono una macchina sola. Allo stesso modo, un export notturno della coda su un archivio freddo costa quasi nulla. Prova il failover prima del lancio, mai dopo.

Crescere oltre confine aggiunge lavoro

Molte aziende qui lavorano in tre o quattro mercati insieme. Ogni fisco tiene un proprio identificativo, un proprio tracciato e un proprio schema di firma. Anziché duplicare il codice per paese, tieni un servizio solo con un adattatore per mercato.

Così un cambio di regole a Skopje non rinvia un rilascio a Tirana. Inoltre abbassa il costo del confine successivo. Poiché un adattatore resta piccolo, un mercato nuovo diventa una questione di settimane e non di mesi.

Delega i controlli all'automazione

Quasi tutti gli invii respinti nascono da piccoli errori di formato. Un controllo in uscita li intercetta prima che la piattaforma statale li veda. Di conseguenza i rifiuti calano e nessuno ribatte a mano la stessa fattura.

Contano allo stesso modo gli avvisi. Un messaggio quando la coda supera cinquanta elementi batte una brutta scoperta a fine mese. L'amministrazione dedica poi il tempo all'analisi invece che alla caccia ai documenti.

Come affronta il problema Square Software

Square Software sviluppa software su misura e lo integra con sistemi statali e di terze parti. Lavoriamo a tempo e materiali, fra 35 e 55 EUR all'ora. Puoi vedere il tipo di lavoro che consegniamo sulla pagina dei prodotti. Oppure leggi come formiamo un team sulla pagina di outsourcing.

Se prima vuoi una cifra di massima, il nostro stimatore di progetto la produce in pochi clic. Se invece preferisci parlarne a voce, la pagina dei contatti resta la via più breve.

Errori che vediamo di continuo

Primo, si stima il lavoro come una chiamata sola e si salta la coda. Secondo, si prova solo il percorso felice, quindi il primo rifiuto del venerdì sera passa inosservato. Terzo, nessuno risponde delle chiavi di firma, e una dimenticanza ferma tutto il negozio.

Ce n'è un altro. Scegliere un prodotto rigido, che non si adatta quando le regole cambiano, sembra economico al primo anno. Poi al terzo anno chiede una riscrittura completa.

Dove sta andando tutto questo

Le piattaforme fiscali statali crescono in tutta Europa. L'Unione Europea ha fissato un formato comune di fattura elettronica per gli enti pubblici con la Direttiva 2014/55/UE. Anche gli schemi nazionali si muovono nella stessa direzione. L'Albania pubblica regole e guide sul sito dell'agenzia delle tasse.

Aspettati legami più stretti fra piattaforme fiscali, banche e contabilità. Aspettati più controlli prima della chiusura della vendita, e non dopo. In breve, integrare la fiscalizzazione nel software su misura somiglierà a un impianto di base, da progettare dal primo giorno.

In sintesi

Le regole fiscali non spariscono e non diventano più semplici. Un involucro sottile intorno a un'API statale supera la demo e crolla il sabato pieno.

Costruisci prima la coda, i controlli, gli avvisi e il calendario delle chiavi. Tieni la logica statale in un punto solo, così un'altra regola o un altro confine resta un lavoro modesto. Fai questo e integrare la fiscalizzazione nel software su misura smette di essere un rischio. Diventa una funzione che puoi vendere.

Trovi altro sul lato API nella nostra guida alle API di fiscalizzazione.