Mexal/Passepartout: WebAPI, SPRIX, integrazioni
Lavoro come sviluppatore in-house su Mexal/Passepartout da diversi anni, in PMI manifatturiere italiane del Nordest. Le competenze le ho maturate sul campo, sotto la licenza del datore di lavoro — non sono partner certificato. Quello che faccio sta nello spazio tra il gestionale tradizionale e il web contemporaneo: chiamare WebAPI dal browser, scrivere SPRIX per report e automazioni, intercettare eventi del gestionale con SPRIX Collage, esporre flussi via CALLWEBSVC. Spesso il punto non è sostituire il gestionale ma costruirgli intorno strumenti che oggi mancano.
I progetti che seguono coprono diversi pattern: ecommerce B2B con sincronizzazione bidirezionale, knowledge base AI che risponde citando articoli reali del gestionale, ticket assistance che si integra con anagrafiche e ordini, generazione documenti dinamici via WebAPI, automazione SPRIX per accordi fornitore.
Case study correlati (10)
- E-commerce B2B/B2C con integrazione Mexal, blog AI-autopilot e schede PDF real-timeEcommerce multilingua in produzione per una PMI del settore ferramenta. Non solo catalogo e carrello: un bot AI che pubblica il blog in autonomia, schede tecniche generate in tempo reale da Mexal con merge degli allegati Docuvision, 180 listini PDF pre-generati in 9 lingue × 5 brand × 4 materiali.
- Knowledge base AI con regole di business live-editabili e double-pass ingestUn assistente AI che conosce 3.900 codici articolo e 15 regole di compatibilità tipizzate, risponde citando sempre la fonte, registra tutto in modo immutabile. Costruito con un'ingest pipeline a doppia passata che cattura le allucinazioni silenziose di Gemini, un editor admin live che fa scrivere al tecnico del cliente senza rebuild, e i webhook nativi Mexal per reattività in tempo reale. In produzione HTTPS da aprile 2026.
- Sistema di assistenza ticket con plugin Outlook VSTO, AI summary con Claude e integrazione Mexal via proxy PHPPiattaforma di gestione ticket per assistenza clienti B2B, in produzione interna su due istanze gemelle (stessa codebase, deploy separati). Plugin Outlook nativo VSTO .NET che allega email al ticket con un click, riassunti AI generati da Claude via tool calling, integrazione Mexal per anagrafiche e storico ordini, access-token pubblici per condivisione sicura con riparatori esterni.
- Consuntivazione automatica dei rebate fornitore: dalle fatture elettroniche in ingresso al rendiconto delle note di credito da chiedereUn sistema che chiude il ciclo annuale degli accordi con i fornitori di un'azienda di distribuzione B2B multi-marchio: carica le fatture elettroniche ricevute via SDI, le incrocia con gli accordi in essere (sconti a volume, rebate a scaglioni, premi di categoria, pack a categoria combinata), calcola quanto accredito è effettivamente maturato, e produce il rendiconto con il delta di note di credito ancora da richiedere ai fornitori. Quello che prima si faceva a fine esercizio in Excel, con errori e accrediti dimenticati, ora si legge in un singolo report. Versione corrente 2.1.
- PowerApps operative con integrazione Mexal, Power Automate come orchestratore e migrazione selettiva a Next.jsSei PowerApps multi-screen e oltre venti flow Power Automate costruiti per una PMI manifatturiera italiana del settore distribuzione tecnica: integrazione nativa con Mexal WebAPI, validazione dati real-time, routing SQL multi-backup, generazione preventivi on-demand, dashboard Power BI embedded. Oggi in migrazione selettiva verso Next.js dove la complessità lo giustifica.
- Porting PowerApps → web con sql-proxy Node.js: middleware singleton veloce e affidabile sulla intranet aziendaleSei PowerApps operative già in pensione, cinque in pipeline di migrazione. Un servizio Node.js di circa 5.700 righe che gira come Windows Service sulla intranet e funge da middleware unico verso SQL Server del gestionale, Dataverse, Mexal WebAPI, Brevo email/SMS e MySQL. Frontend in HTML vanilla single-page, deploy versioning dentro il proxy stesso con rollback istantaneo, dual-write SQL+Dataverse per coesistere con le PowerApps ancora vive.
- DDT digitale web chiamabile dal gestionale Mexal: documento dinamico via WebAPI, con bypass DNS e debug liveUn bridge PHP di circa 3.300 righe che rende in tempo reale la versione web di un documento di trasporto, richiamabile con un click dal gestionale Mexal. Integra sette endpoint WebAPI per ricomporre il documento da fonti multiple, bypassa il DNS intranet con IP hardcoded quando serve, e ha un sistema di debug live HTML+file che ho costruito ad hoc per troubleshooting in produzione. Piccolo in righe, distintivo nel pattern.
- Gestionale interno Scriptcase con 336 applicazioni, SGI ISO integrato e accesso diretto al database MexalUna piattaforma gestionale interna costruita in Scriptcase con 336 applicazioni in produzione, stratificata negli anni su un unico database SQL Server condiviso con il gestionale Mexal. Copre Sistema di Gestione Integrato Qualità-Ambiente ISO 9001+14001, valutazione fornitori, approvvigionamento con controllo sottoscorta ed esplosione produzione, configuratori di prodotto verticali, indagini statistiche (storici vendite/acquisti, analisi tempi produzione per operatore, forecast), HR/timbrature, ticket assistenza, portale B2B admin. Security Module Scriptcase con 2FA, dashboard Power BI embedded, integrazione Docuvision, perfino moduli AI. Non una web app: un ecosistema.
- Guida SPRIX e skill Claude Code auto-aggiornata per sviluppo su Mexal/PassepartoutUn sistema di conoscenza vivo sul linguaggio SPRIX e sulle WebAPI Mexal/Passepartout: guida markdown pragmatica + skill Claude Code richiamabile che si carica d'autorità su ogni progetto Mexal + due comandi custom (/mexal-discover e /mexal-changelog) che mantengono il catalogo endpoint e campi sincronizzato interrogando le API live e processando i PDF di changelog ufficiali. Non documentazione statica: un asset che invecchia più lentamente del manuale del vendor.
- Mestiere SPRIX: competenza tradizionale ma rara per integrare Mexal/Passepartout nel mondo modernoIl lato pratico della mia competenza SPRIX — cosa significa davvero essere uno sviluppatore SPRIX sul gestionale Mexal/Passepartout, perché questa competenza è rara in Italia, a quali problemi reali risponde nelle PMI manifatturiere, e perché il mix con le competenze moderne (Next.js, Python, AI) è quello che rende possibili integrazioni serie tra gestionale tradizionale e web contemporaneo. Competenza maturata come sviluppatore interno, non come partner certificato.
Domande ricorrenti
Cos'è Mexal/Passepartout?
Mexal è il software gestionale ERP di Passepartout S.p.A., diffuso nelle PMI italiane. Copre contabilità, magazzino, produzione, vendite, acquisti, e ha un ecosistema di estensioni: SPRIX (linguaggio di scripting interno), Mexal WebAPI (API HTTP/REST), Docuvision (gestione documentale), CALLWEBSVC (chiamate a servizi esterni dal gestionale).
Cos'è SPRIX e cosa permette di fare?
SPRIX è il linguaggio di scripting proprietario di Passepartout per estendere Mexal. Esistono due dialetti: SPRIX puro (per report custom, automazioni batch, esportazioni) e SPRIX Collage (per intercettare eventi del gestionale — ad esempio quando un utente conferma un ordine — ed eseguire logica custom in quel momento). È il modo nativo per personalizzare comportamenti del gestionale.
Le Mexal WebAPI permettono di leggere e scrivere?
Sì. Le WebAPI Mexal espongono in HTTP/JSON molte aree del gestionale: anagrafiche clienti/fornitori, articoli, ordini cliente e fornitore, listini, documenti, contabilità. Sono utilizzabili per leggere dati (es. per ecommerce headless) e per scrivere (es. creare nuovi documenti). Richiedono autenticazione e gestione del rate limit.
Come si integra Mexal con un sito web moderno?
Le strategie reali che ho usato: lettura via WebAPI con caching per ecommerce B2B, push periodico di catalogo/listino su storage esterno (Vercel Blob o simili), scrittura ordini cliente via WebAPI dopo checkout, sincronizzazione anagrafiche in entrambi i versi. Quando le WebAPI non bastano, SPRIX Collage permette di intercettare eventi gestionali e propagare verso il web.