Collegare l'NFC al gestionale: architettura e passaggi
· 6 min di lettura

Per collegare l'NFC al gestionale non si collega il chip direttamente all'ERP: il tag contiene un URL con un identificativo, uno strato software intermedio lo riconosce e dialoga con il gestionale tramite API REST, webhook, EDI o file CSV e XML. In questo articolo vediamo l'architettura passo per passo, come si mappa l'identificativo del tag su articoli, seriali e clienti, e come gestire sicurezza, sincronizzazione ed errori.
Collegare l'NFC al gestionale: il principio
Un chip NFC passivo non ha connessione di rete: quando lo smartphone lo avvicina, il chip restituisce il contenuto della propria memoria, quasi sempre un record NDEF con un URL. È lo smartphone ad aprire l'indirizzo e quindi a raggiungere un server. Per questo il collegamento con l'ERP avviene sempre lato server, mai sul chip.
Lo schema di base ha quattro elementi: il tag dentro l'oggetto, l'URL con l'identificativo, il backend che interpreta la richiesta e il gestionale che riceve o fornisce i dati. Tenere separati questi livelli permette di cambiare ERP, contenuti o regole senza riprogrammare i pezzi già in campo.
Se cerchi il servizio chiavi in mano più che la spiegazione tecnica, la pagina integrazione NFC con ERP e gestionale descrive cosa realizziamo.
Dal tag all'URL: identificativo semplice o SUN
La prima scelta riguarda cosa scrivere nel chip. Le opzioni principali sono due.
- URL con identificativo statico: per esempio un percorso che termina con il codice univoco del pezzo. È semplice e adatto a contenuti informativi, ordini, manutenzione e magazzino.
- URL con SUN (Secure Unique NFC) su NTAG 424 DNA: a ogni lettura il chip aggiunge un contatore e un codice firmato con AES-128. Il server verifica la firma e scarta i codici già usati, quindi una copia dell'URL non è valida.
Quale scegliere
Se il tocco registra un movimento o un intervento eseguito da personale interno autenticato, l'identificativo statico spesso basta, perché la sicurezza sta nel login. Se invece il tocco deve dimostrare che l'oggetto è fisicamente presente o autentico, serve SUN. Ne parliamo nell'articolo su NTAG 424 DNA e anticontraffazione.
Il backend TapLogic come strato intermedio
Il backend riceve la richiesta generata dal tocco, riconosce l'identificativo, applica le regole e decide cosa fare: mostrare una pagina, chiedere un login, registrare un evento, interrogare il gestionale. Il software NFC di TapLogic svolge questo ruolo e mantiene anche statistiche e log di ogni lettura.
Avere uno strato intermedio ha vantaggi pratici: il gestionale non viene esposto su internet, le chiamate verso l'ERP sono poche e controllate, le regole si modificano senza intervenire sui sistemi aziendali. Quando serve una logica specifica, il backend si estende con sviluppo su misura, come spiegato nell'articolo sul software NFC su misura.
Canali di integrazione con l'ERP
Il canale dipende da cosa offre il gestionale e da quanto deve essere immediato l'aggiornamento. SAP, Odoo, TeamSystem, Zucchetti, Microsoft Dynamics 365 e Danea sono solo esempi di sistemi con cui ci si può collegare: ogni installazione va verificata con chi la gestisce.
API REST
È il canale preferito quando disponibile: il backend chiama l'ERP per leggere un dato (giacenza, scheda articolo, storico) o per scriverne uno (movimento, intervento, registrazione). Le risposte sono immediate e strutturate.
Webhook
Il backend invia una notifica a un indirizzo del gestionale o di un middleware ogni volta che avviene un evento, per esempio una verifica di autenticità o una lettura in un punto preciso. Utile quando l'ERP deve reagire senza interrogare continuamente.
EDI e file CSV o XML su SFTP
Molti gestionali installati in azienda importano ed esportano file. Il backend può depositare a intervalli regolari un file CSV o XML su una cartella SFTP, oppure leggere i file prodotti dall'ERP. Per i flussi tra aziende si usa anche l'EDI. È meno immediato, ma robusto e semplice da validare.
Code di messaggi
Quando il volume di eventi è alto o l'ERP non è sempre raggiungibile, gli eventi vengono messi in coda e consegnati in ordine appena possibile. La coda evita perdite di dati durante fermi o manutenzioni del gestionale.
Mappatura tra identificativo del tag e dati aziendali
La mappatura è la tabella che lega l'identificativo scritto nel chip a un'entità del gestionale. È la parte più importante del progetto e va decisa prima della produzione.
- Tag ↔ articolo: tutti i pezzi di un modello puntano allo stesso codice articolo, utile per schede prodotto e riordini.
- Tag ↔ seriale o lotto: ogni pezzo è unico e collegato al proprio numero di serie, base della tracciabilità di lotti e seriali con NFC.
- Tag ↔ cliente o punto vendita: l'espositore di un negozio porta con sé il codice del cliente, così gli ordini arrivano già attribuiti.
- Tag ↔ asset o ubicazione: cartellini su macchinari, scaffali e contenitori.
Associazione in produzione o sul campo
L'associazione si può fare in produzione, quando programmiamo i pezzi e prepariamo il file di abbinamento, oppure sul campo, con una procedura di attivazione in cui l'operatore tocca il tag e sceglie a cosa collegarlo. La prima è più rapida, la seconda è utile quando i seriali nascono dopo la consegna.
Sicurezza dell'integrazione
Collegare il mondo esterno al gestionale richiede alcune regole precise, che applichiamo in ogni progetto.
- Token di accesso dedicati per il backend, conservati in modo sicuro e ruotabili.
- Permessi minimi: l'utenza tecnica può leggere e scrivere solo le entità previste, niente accessi amministrativi.
- Autenticazione degli operatori per le azioni che modificano dati, come movimenti o interventi.
- Log di ogni chiamata e di ogni lettura, con data, identificativo e esito, per ricostruire cosa è successo.
- Validazione dei dati in ingresso, così un URL manipolato non produce scritture nel gestionale.
Sincronizzazione e gestione degli errori
Un'integrazione affidabile si giudica da come si comporta quando qualcosa va storto. Il gestionale può essere fermo, la connessione dello smartphone può cadere, un articolo può essere stato cancellato.
Le regole tipiche sono: ripetere automaticamente le chiamate fallite con intervalli crescenti, rendere le operazioni idempotenti (lo stesso evento inviato due volte non crea due movimenti), segnalare all'operatore quando un dato non è stato registrato e avvisare l'amministratore dopo un numero definito di errori. Per i dati di lettura, come schede e storici, si può tenere una copia sincronizzata nel backend così la pagina si apre anche se l'ERP è momentaneamente lento.
Gli stessi principi valgono per i flussi verso e-commerce e CRM, descritti nell'articolo su NFC, e-commerce e CRM, e per il magazzino, dove ogni tocco aggiorna le giacenze come spiegato in NFC per magazzino e inventario.
Da dove partire
Il primo passo è descrivere il flusso in una frase: chi tocca, dove, e cosa deve succedere nel gestionale. Da lì si scelgono chip, canale di integrazione e mappatura. Ricorda che TapLogic non vende tag NFC sfusi: il chip arriva sempre dentro un oggetto 3D progettato da noi, progettato e prodotto in Italia, già programmato con l'identificativo concordato e collegato al software.
Per i casi di manutenzione, con cartellini sui macchinari che aprono lo storico interventi, puoi vedere anche la soluzione NFC per manutenzione e industria.
Come lo realizza TapLogic
TapLogic non vende tag NFC sfusi: ogni chip è integrato durante la stampa 3D in un oggetto progettato su misura per il tuo brand e programmato con il software che sviluppiamo internamente. Progettazione, stampa e programmazione avvengono in Italia, e il software si collega al tuo ERP, gestionale, e-commerce o CRM. Scopri le soluzioni NFC per aziende o raccontaci il tuo progetto.
Domande frequenti
Il chip NFC può scrivere direttamente nel gestionale?
No. Il chip è passivo e contiene un URL; è il backend raggiunto dallo smartphone a dialogare con il gestionale tramite API, webhook, EDI o file.
Il nostro ERP non ha API: si può collegare comunque?
Spesso sì, tramite import ed export di file CSV o XML su SFTP o tramite EDI. L'aggiornamento è a intervalli invece che immediato, ma resta affidabile.
Cosa succede se il gestionale è offline?
Gli eventi vengono messi in coda e inviati appena il sistema torna disponibile, senza duplicati grazie a operazioni idempotenti.
Serve un'app da installare?
Non necessariamente. Il tocco apre una pagina web; per le operazioni interne si usa un login, mentre un'app dedicata si valuta solo se servono funzioni particolari.
Vuoi un prodotto NFC su misura?
Progettiamo, stampiamo in 3D e programmiamo in Italia, e colleghiamo tutto al tuo gestionale. Solo per aziende.
Richiedi un progetto