Integrare le note spese in un gestionale custom: export contabile e API
Collegare un modulo note spese a un gestionale custom non è un problema di connettori: è un problema di contratto di interfaccia. Chi riceve i dati ha bisogno di struttura stabile, valori validati e un flusso di approvazione già completato prima che i dati escano. fees è stato progettato per rispondere esattamente a questi requisiti.
Il problema reale: dati sporchi e flussi incompleti
Il punto di dolore più comune quando si integra un modulo note spese non è il formato del file, ma la qualità di ciò che arriva. Spese non approvate, categorie mancanti, importi in valuta estera non convertiti, documenti allegati assenti: ogni eccezione diventa gestione manuale sul gestionale ricevente. La soluzione non è scrivere più logica di pulizia sul lato destinatario, ma garantire che i dati escano già validati, categorizzati e approvati. Questo sposta la complessità dove appartiene: nel processo, non nell'integrazione.
Due modalità di integrazione: export configurabile e API JSON
fees supporta due approcci distinti. Il primo è l'export contabile a tracciato configurabile in CSV, XML o TXT: il tracciato viene definito in fase di onboarding in modo da corrispondere esattamente allo schema atteso dal gestionale ricevente, inclusi codici conto, centri di costo e campi di tagging per cliente, commessa o progetto. Il secondo approccio è tramite le API fees Can, che restituiscono dati in JSON: adatto quando il gestionale custom ha già una logica di ingestione API o quando si vuole un flusso event-driven senza dipendere da file schedulati. La scelta tra i due dipende dall'architettura del sistema ricevente, non da vincoli di fees.
Il problema reale: dati sporchi e flussi incompleti
Un aspetto spesso sottovalutato in fase di valutazione è la governance nel tempo. Quando il gestionale custom evolve, chi aggiorna il tracciato o il contratto JSON? Con l'export configurabile, una modifica al tracciato richiede un aggiornamento della configurazione su fees; con le API, il contratto JSON va versionato esplicitamente tra i due sistemi. In entrambi i casi è utile definire in anticipo chi possiede la specifica: il team IT del gestionale o il team che amministra fees. fees gestisce internamente approvazioni multilivello, tagging, multi-valuta e conservazione digitale dei documenti: tutto ciò che riguarda il processo di spesa rimane nel perimetro fees, alleggerendo il gestionale ricevente da logiche che non gli appartengono.
Q&A
I dati che escono da fees sono già approvati o devo gestire gli stati sul gestionale ricevente?
Come gestisco le spese in valuta estera nel gestionale custom?
Posso taggare le spese per centro di costo o commessa prima che i dati vengano esportati?
