Note spese e Mago 4: integrazione per reparti IT e sviluppatori
Se la tua azienda usa Mago 4 come ERP e gestisce trasferte e note spese, il nodo critico è uno solo: portare le spese approvate in contabilità senza interventi manuali. L'integrazione tra fees e Mago 4 è già realizzata e viene calata sulla configurazione specifica dell'azienda durante l'onboarding.
Due strade tecniche, entrambe disponibili
Il reparto IT può scegliere tra due modalità operative. La prima è il tracciato di export contabile: fees genera un file CSV, XML o TXT con i campi che Mago 4 si aspetta in import, configurato sulle causali e codifiche già in uso nell'ERP. La seconda è l'API fees Can: le spese approvate vengono esposte in JSON e Mago 4 — o un processo interno sviluppato con TaskBuilder — le legge direttamente dall'endpoint, senza file intermedi. Chi ha già competenze di sviluppo interno e preferisce un flusso in push o pull verso l'ERP troverà più pulita la strada API; chi vuole un import schedulato con un tracciato fisso può partire dal file configurabile.
Mappatura dei dati verso Mago 4
Il punto più delicato non è il trasporto dei dati ma la loro mappatura. In fees ogni spesa può essere taggata con centro di costo, commessa o progetto; questi valori devono corrispondere alle codifiche già presenti in Mago 4 per atterrare correttamente in contabilità analitica. In onboarding si definisce questa corrispondenza: quali campi di fees alimentano quali campi dell'ERP, quali causali contabili vengono associate alle categorie di spesa, come vengono gestite le spese multi-valuta. Non si parte da un foglio bianco: l'integrazione esiste e viene adattata alla configurazione specifica, non costruita da zero.
Due strade tecniche, entrambe disponibili
Per avviare l'integrazione il reparto IT deve avere a disposizione le codifiche attive nell'ERP: piano dei conti, centri di costo, commesse, causali di prima nota e anagrafiche fornitori o dipendenti usate per le registrazioni. Se si sceglie la strada API, occorre predisporre lato Mago 4 un processo di ricezione o schedulazione della lettura — ad esempio tramite TaskBuilder — che consumi i dati JSON esposti da fees. Se si sceglie il tracciato file, serve conoscere il formato di import atteso da Mago 4 e l'ordine dei campi. Entrambe le informazioni vengono raccolte e allineate durante l'onboarding.
Q&A
Come si gestisce la mappatura tra le categorie di spesa di fees e le causali contabili di Mago 4?
Se usiamo TaskBuilder per personalizzare Mago 4, possiamo consumare direttamente l'API di fees?
fees gestisce le spese taggate per commessa o centro di costo in modo da renderle subito utilizzabili in Mago 4?
