Collegare i tuoi sistemi: integrazione API senza doppi dati

Shop, contabilità, fornitori di pagamento, CRM: colleghiamo ciò che già funziona da te e facciamo circolare i dati nei due sensi. Se l'altro sistema si ferma, il collegamento riprova da solo.

In sintesi

1 unica versione dei dati

Cliente, ordine, pagamento: inseriti una volta, aggiornati ovunque. Quale sistema fa fede lo stabiliamo insieme prima di iniziare.

24/7 in sincronia

L'integrazione lavora anche dopo l'orario d'ufficio. Quello che entra di notte al mattino è già elaborato.

0 doppi inserimenti

Nessuno ridigita gli stessi dati una seconda volta. Sparisce la fonte di errore più frequente nel lavoro quotidiano.

100 % i tuoi accessi

Account e chiavi restano intestati alla tua azienda. Puoi revocarci l'accesso in qualsiasi momento senza che nulla si fermi.

Collegare i sistemi

Una linea che regge

Costruiamo il collegamento tra i tuoi sistemi perché regga il quotidiano: ritentativi in caso di guasto, mappatura pulita dei campi e un registro in cui ritrovi ogni operazione.

Dove falliscono i collegamenti tra sistemi

Quasi ogni azienda ha buon software in casa. Manca il tratto di strada in mezzo.

01

Gli stessi dati, inseriti tre volte

Un nuovo cliente nasce nello shop, poi di nuovo in contabilità e una terza volta nel CRM. Alla quarta nessuno sa più quale indirizzo valga.

02

Numeri del giorno prima

L'allineamento notturno è l'unico momento della giornata in cui le tue giacenze sono esatte. Nelle altre 23 ore sono una stima.

03

Il collegamento si spezza in silenzio

Una chiave scade, un campo cambia nome e il trasferimento si ferma. Di solito ce ne si accorge quando è un cliente a chiedere.

04

Nessuno può andare a controllare

Quando un ordine non arriva, la caccia comincia in tre interfacce e finisce dal fornitore che due anni fa aveva scritto lo script.

Cosa costruiamo in un'integrazione

Combiniamo questi mattoni a seconda del compito. Tutto questo gira, in questa forma o in una simile, nei sistemi che gestiamo ancora oggi.

01

Collegare i sistemi

Shop, contabilità, fornitore di pagamento, gestionale, CRM: colleghiamo ciò che ha un'interfaccia e la costruiamo dove non c'è.

02

Sincronizzazione bidirezionale

I dati vanno e tornano senza sovrascriversi a vicenda. Per ogni campo è stabilito quale sistema lo governa.

03

Reazione immediata

Dove il fornitore lo permette lavoriamo a eventi: il pagamento si annuncia da solo, molto prima che parta la sincronizzazione notturna.

04

Collegamenti sicuri

Verifichiamo la firma dei messaggi in entrata, le chiavi restano cifrate e ogni scrittura porta un identificativo contro le doppie registrazioni.

05

Mappatura pulita dei campi

Codice cliente, aliquota, unità di misura: due sistemi intendono raramente la stessa cosa. La mappatura resta documentata e modificabile senza toccare il codice.

06

API proprie per i tuoi partner

Se altri devono interrogare i tuoi dati, costruiamo l'interfaccia adatta: con documentazione, chiavi di accesso e versioni che tengono in vita le chiamate vecchie.

07

Sistemi legacy & importazioni di massa

I dati storici da tabelle, esportazioni o un sistema dismesso li portiamo dentro una volta sola, a tappe e con una prova generale prima del caso reale.

08

Visibilità su ciò che gira

Ogni trasferimento finisce in un registro con orario, esito e payload. Se qualcosa resta appeso lo vedi lì, prima che a segnalarlo sia un cliente.

09

Esercizio & manutenzione

I fornitori cambiano le interfacce, le chiavi scadono. Monitoriamo le linee, allineiamo le versioni e ci facciamo vivi prima che qualcosa si fermi.

Sistemi che abbiamo già collegato

Ogni integrazione di questo elenco è codice scritto in progetti che gestiamo.

01

Pagamenti & fatturazione

  • Stripe
  • PayPal
  • Carta di credito
  • Addebito diretto SEPA
  • Apple Pay
  • Google Pay
  • Klarna

I metodi di pagamento passano da Stripe o dal tuo fornitore. Sotto la superficie comincia la parte interessante: un'autorizzazione da cui più tardi si incassano acconto e saldo separatamente, la fatturazione ad abbonamento con addebito diretto e imposta automatica, e la regola per cui un importo risulta pagato solo quando lo conferma la risposta firmata del fornitore. Da qui dipende se a fine mese la contabilità torna.

02

Solvibilità, identità & obblighi fiscali

  • Verifica di solvibilità (SCHUFA in Germania)
  • Stripe Identity
  • Verifica partita IVA (VIES)
  • VeriFactu (Spagna)

Prima che da una richiesta nasca un contratto, spesso serve sapere chi sta firmando davvero. La verifica di solvibilità presso una centrale rischi gira da noi in produzione: in Germania passa dall'interfaccia XML firmata di SCHUFA con certificato di partecipante proprio, compresi i casi che una persona deve lavorare a mano e chiudere entro un termine. Con lo stesso schema colleghiamo la centrale rischi del tuo mercato. Il controllo della partita IVA decide aliquota e regime di fatturazione. Per il mercato spagnolo l'obbligo di comunicazione VeriFactu è costruito e testato.

03

Shop & sistemi di magazzino

  • Shopware 6 (Store API & Admin API)
  • Shopware 5 (plugin interno)
  • Gestione licenze
  • S3 & CloudFront

Con licenze o download il lavoro prosegue dopo l'ordine. Accanto allo shop gira una gestione delle licenze: assegna le chiavi all'ordine pagato e controlla le giacenze prima di rilasciare qualcosa. I file restano in uno storage protetto e vengono sbloccati solo per l'ordine corrispondente.

04

Prenotazioni, calendari & portali

  • Channel manager
  • Calendari iCal
  • Google Hotel Center
  • Google Vacation Rentals

Chi offre camere, appuntamenti o veicoli su più portali ha bisogno di un calendario che faccia da riferimento per tutti. Portali come Booking.com e Airbnb li raggiungi tramite un channel manager o tramite i feed di calendario. La direzione opposta è delicata: una voce importata non deve tornare indietro come propria, e partenza e arrivo nello stesso giorno non devono bloccarsi a vicenda. Per Google abbiamo costruito anche il lato fornitore, che consegna le anagrafiche e risponde alle richieste di prezzo nel momento della ricerca.

05

E-mail, WhatsApp & push

  • Mailchimp
  • Resend
  • SMTP
  • Gmail API
  • WhatsApp Business
  • Web Push

Una pratica riguarda di rado una sola persona. Costruiamo l'invio in modo che un cambio di stato raggiunga insieme cliente, partner e ufficio interno, ognuno sul canale a cui ha dato il consenso: modelli WhatsApp approvati, Web Push o la classica e-mail. Le newsletter girano con double opt-in e consenso dimostrabile. Il servizio di invio dietro le quinte resta sostituibile.

06

IA & traduzione

  • OpenAI
  • Anthropic
  • DeepL
  • Mistral
  • Modelli ospitati nell'UE
  • dragoman

Le risposte compaiono parola per parola, mentre il modello sta ancora scrivendo. I limiti di contenuto stanno sul server, perché un assistente non dica quello che per legge non può dire. Anche il luogo del trattamento è una decisione. Per contenuti personali si può impiegare un modello ospitato nell'UE. Le traduzioni passano dal nostro strumento open source dragoman, che fa pagare solo i testi nuovi e modificati.

07

Dati, mappe & località

  • Supabase
  • Firestore
  • Mapbox
  • Google Maps Geocoding

Ricerca sulla mappa con lista risultati e raggio, completamento degli indirizzi già durante la digitazione, funzioni di database per pratiche che due operatori non devono poter prendere nello stesso momento. I dati di posizione sono raramente il tema principale di un progetto e compaiono quasi in ognuno.

Così nasce la tua integrazione

Quattro passi dalla ricognizione all'esercizio quotidiano.

01

Sistemi & flussi di dati

Guardiamo quali sistemi hai in casa, quali dati devono muoversi tra loro e quale sistema ha ragione in caso di conflitto. Ne esce uno schema che capisce anche il tuo commercialista.

02

Concept e prezzo fisso

Ricevi per iscritto la mappatura dei campi, la direzione di ogni sincronizzazione e la gestione degli errori, più un prezzo fisso per tappa. Sai cosa nasce prima che si scriva codice.

03

Integrazione & collaudo

Costruiamo contro l'ambiente di test del fornitore e proviamo casi reali, anche quelli scomodi: notifica doppia, timeout, sistema remoto offline. Solo dopo la linea tocca dati veri.

04

Go-live & esercizio

La prima linea entra in produzione e toglie subito lavoro, le successive seguono nell'ordine che rende di più. Poi monitoriamo i collegamenti e li adeguiamo ai cambi dei fornitori.

Pronto?

Quali due sistemi devono parlarsi?

Dicci i due programmi tra cui da te passa più lavoro a mano. Nella prima consulenza gratuita ti diciamo se esiste un'interfaccia adatta e quanto costa all'incirca l'integrazione.

Domande frequenti su interfacce e integrazioni API

Una singola integrazione parte di solito da circa 4.000 €, i progetti più ampi su più sistemi si collocano tra 10.000 e 40.000 €. Decidono il numero di sistemi, la direzione della sincronizzazione e la qualità dell'interfaccia dall'altra parte: un'API moderna e documentata costa molto meno di un sistema legacy da cui i dati vanno estratti a fatica. Dopo la prima consulenza ricevi un prezzo fisso per tappa.

Sì, è il caso normale. Ci leggiamo la documentazione e costruiamo contro l'ambiente di test del fornitore. Quando un'interfaccia manca del tutto, valutiamo le vie laterali: esportazioni di file pianificate, accesso al database o un'importazione da tabelle. Prima dell'offerta ti diciamo con franchezza quanto è praticabile la controparte.

Lo mettiamo in conto fin dall'inizio. I trasferimenti falliti entrano in coda e vengono ritentati a intervalli crescenti, perché un'interruzione breve non costi dati. Ogni ritentativo porta un identificativo, quindi la stessa operazione non arriva due volte. Se una linea resta ferma a lungo, la segnalazione parte lo stesso giorno.

Con la frequenza che il flusso richiede. Dove il fornitore invia eventi, l'integrazione reagisce in pochi secondi: un pagamento si annuncia da solo appena è andato a buon fine. Dove gli eventi mancano, interroghiamo a cadenza fissa, da pochi minuti a una volta di notte. La cadenza la fissiamo linea per linea, perché giacenze e anagrafiche hanno urgenze diverse.

A te. Gli account presso i fornitori di pagamento, le chiavi delle interfacce e i certificati sono intestati alla tua azienda, e noi lavoriamo con accessi nostri al di sotto. Quando la collaborazione finisce, ci togli l'accesso e tutto continua a girare. Lo stesso vale per il codice dell'integrazione e la sua documentazione.

Succede regolarmente, di solito con preavviso. Per questo dopo il go-live restiamo sulle linee: seguiamo gli annunci di modifica dei fornitori, allineiamo le versioni e testiamo in anticipo contro la nuova release. Se in azienda nessuno se ne accorge, il lavoro è stato fatto bene.

Sì, e capita più spesso di quanto si pensi. Definiamo l'interfaccia in anticipo: campi, tipi e casi di errore sono fissati prima della prima chiamata. La descrizione resta versionata nel progetto e le chiamate vecchie continuano a funzionare quando esce una nuova release. Si aggiungono chiavi di accesso per ogni partner, un limite alle richieste e una documentazione con cui il tuo partner parte senza doverti chiedere nulla. In piattaforme nostre già in esercizio i terzi interrogano esattamente così dati degli immobili e prezzi.

Ogni messaggio in entrata passa il controllo della firma prima di attivare qualsiasi cosa, altrimenti chiunque potrebbe simulare una fattura pagata. Chiavi e certificati restano cifrati e separati dal codice, ambiente di test e ambiente di produzione sono nettamente divisi. Trasferiamo solo ciò che serve allo scopo, e dove entrano in gioco dati personali verifichiamo prima il luogo del trattamento.

Decidi tu. Monitoriamo le linee, ci occupiamo delle modifiche dei fornitori e costruiamo le integrazioni successive: molti clienti li accompagniamo così da anni. Oppure consegniamo alla tua IT, con documentazione, mappatura dei campi e affiancamento. Entrambe le strade sono normali.

Contattaci

Da te c'è ancora qualcosa che passa a mano tra due programmi? Dicci quali sono. Ti diremo se i due si possono collegare e quanto costa all'incirca il collegamento.