L’integrazione API consente ai software che utilizzate di scambiarsi dati in modo automatico. Se sito web, negozio online, sistema di pagamento, corriere, account sui marketplace, intermediario per la fatturazione elettronica (e-Fatura) e programma di contabilità conservano ciascuno la stessa informazione, significa che il vostro team inserisce ogni giorno a mano gli stessi dati in più schermate. Noi colleghiamo questi sistemi tramite le loro API e facciamo arrivare i dati nel posto giusto, al momento giusto e in modo tracciabile.
Esempi tipici di questo servizio: la spedizione che viene creata e il numero di tracking inviato al cliente non appena il pagamento dell’ordine è confermato, la fattura emessa come e-Fatura o e-Arşiv, i prodotti su Trendyol e Hepsiburada aggiornati quando cambia lo stock, un nuovo modulo compilato che arriva direttamente nel CRM. Sviluppiamo su misura i collegamenti che un plugin pronto non riesce a gestire e che devono funzionare secondo le vostre regole di business.
In questa pagina trovate, categoria per categoria e con i nomi delle aziende, i sistemi con cui possiamo integrarci: integrazione API con i corrieri, integrazione POS virtuale, integrazione con i marketplace, integrazione e-Fatura, collegamenti con contabilità ed ERP, SMS, WhatsApp, mappe, intelligenza artificiale e molto altro. Per ogni scheda spieghiamo anche a cosa serve concretamente l’integrazione.
A chi è adatta l’integrazione API?
- Aziende e-commerce: negozi che vogliono gestire da un unico punto prodotti, stock, prezzi e ordini tra il proprio sito e marketplace come Trendyol, Hepsiburada, N11 e Amazon.
- Aziende che preparano spedizioni ogni giorno: imprese che non vogliono più copiare a mano barcode, etichette e numeri di tracking dal portale del corriere.
- Team finanza e contabilità: aziende che, invece di registrare una per una le vendite in Logo, Mikro, Paraşüt o presso l’intermediario e-Fatura, desiderano un trasferimento automatico.
- Aziende di servizi e in abbonamento: chi vuole collegare in un unico flusso pagamenti online, addebiti ricorrenti, fatturazione automatica e notifiche ai clienti.
- Chi vuole aprire il proprio software all’esterno: aziende che desiderano offrire un’API sicura e documentata alla propria app mobile, ai rivenditori o ai partner commerciali.
- Organizzazioni che usano più sistemi: team che hanno versioni diverse degli stessi dati tra CRM, ERP, sito web e strumenti interni.
Cosa comprende il nostro servizio di API e integrazioni?
Collegamento a servizi esistenti
Analizziamo la documentazione API dei servizi di pagamento, spedizione, marketplace, contabilità e comunicazione, ne ricaviamo condizioni di accesso e limiti di utilizzo e aggiungiamo il collegamento al vostro sito, al pannello di gestione o all’app mobile. Se il vostro software è stato sviluppato da un’altra azienda, esaminiamo prima la struttura del codice e l’accesso al server.
Progettazione e documentazione di API REST
Se volete aprire il vostro sistema all’esterno, progettiamo endpoint, strutture dati, codici di errore, regole di paginazione e di autorizzazione. Per ogni endpoint prepariamo una documentazione con esempi di richiesta e risposta: il vostro team mobile o i vostri partner realizzano il collegamento senza dover andare per tentativi.
Webhook e flussi basati su eventi
Facciamo in modo che un evento in un sistema attivi immediatamente un’azione in un altro: per esempio, l’ordine che si conferma quando il pagamento viene approvato o la notifica al cliente quando cambia lo stato della spedizione. Verifichiamo la firma dei webhook in arrivo e, anche se la stessa notifica arriva due volte, eseguiamo l’operazione una sola volta.
Mappatura dei dati e sincronizzazione bidirezionale
Definiamo in una tabella di mappatura scritta quale campo corrisponde a quale, quale sistema è la fonte principale e cosa prevale in caso di conflitto. Differenze come categorie, varianti, aliquote IVA e unità di misura vengono risolte in questa fase, prima di scrivere il codice.
Attività pianificate e trasferimenti massivi
Per i sistemi che non offrono notifiche in tempo reale configuriamo attività eseguite a intervalli regolari. Con queste attività i file XML dei fornitori, i listini prezzi massivi, i tassi di cambio e i file di stock vengono importati o esportati con regolarità.
Schermate del pannello e monitoraggio
Per consentirvi di vedere lo stato dell’integrazione dal pannello di gestione possiamo aggiungere registri delle operazioni, elenchi degli errori e schermate per il reinvio manuale. Quando un ordine non viene trasferito, il vostro team vede da solo il motivo e come inviare di nuovo il record.
Integrazioni di pagamento e POS virtuale
Integrazione del sistema di pagamento
Aggiungiamo il pagamento con carta al vostro sito o alla vostra app: autenticazione 3D Secure, pagamento a rate, rimborso totale e parziale e, se il provider lo supporta, carte salvate e pagamenti ricorrenti. Non affidiamo l’esito del pagamento al solo reindirizzamento del browser, ma lo verifichiamo con la notifica server-to-server inviata dal provider. I dati della carta non vengono conservati sul vostro server, ma raccolti tramite il modulo di pagamento sicuro del provider.
Integrazione POS virtuale bancario
Se avete un contratto di POS virtuale direttamente con la vostra banca, colleghiamo il pagamento all’infrastruttura della banca senza intermediari. Sono compresi il flusso 3D Secure, la tabella delle rate in base ai circuiti delle carte, la preautorizzazione con chiusura successiva, gli annullamenti e i rimborsi. Se lavorate con più banche, è possibile instradare il pagamento al POS corretto in base al tipo di carta.
Integrazioni API con corrieri e logistica
Integrazione API con corrieri nazionali
Quando l’ordine viene confermato, la spedizione si crea automaticamente presso il corriere; barcode ed etichetta si stampano dal vostro pannello e il numero di tracking viene aggiunto all’ordine e all’e-mail o all’SMS inviato al cliente. Gli stati della spedizione si aggiornano tramite webhook o con interrogazioni periodiche. Calcolo del peso volumetrico (desi) e dei costi, generazione dei codici di reso e dati per il contrassegno vengono configurati nella misura in cui l’API del corriere li offre. Le integrazioni con Yurtiçi Kargo, Aras Kargo e MNG Kargo sono gli esempi più richiesti.
Integrazione con corrieri internazionali
Se spedite all’estero, colleghiamo al vostro sistema la richiesta di preventivi, la creazione delle spedizioni, la preparazione di etichette e documenti doganali, la prenotazione del ritiro e il tracking internazionale. Nell’integrazione API con DHL Express peso, dimensioni e dati di prodotto necessari per la dogana vengono presi automaticamente dall’ordine; lo stesso approccio si applica a UPS, FedEx, Aramex e Royal Mail.
Integrazioni con marketplace, e-Fatura e contabilità
Integrazione con i marketplace
Gestite i vostri prodotti da un unico punto e li pubblichiamo sui marketplace: abbinamento di categorie e attributi, aggiornamento di stock e prezzi, importazione degli ordini nel vostro pannello, invio dei dati di spedizione al marketplace, gestione di annullamenti e resi. L’integrazione API con Trendyol, l’integrazione con Hepsiburada e il collegamento ad Amazon SP-API sono gli esempi più richiesti. È possibile definire anche regole di prezzo o di stock specifiche per ciascun marketplace.
Integrazione con piattaforme e-commerce
Se il vostro negozio è su Shopify, WooCommerce o un’altra piattaforma, colleghiamo gli ordini al programma di contabilità e lo stock al magazzino o all’ERP. Quando passate da una piattaforma all’altra, usiamo gli stessi collegamenti anche per migrare i dati di prodotti, clienti e ordini.
Integrazione e-Fatura, e-Arşiv ed e-İrsaliye
Al completamento della vendita viene verificato se l’acquirente è soggetto all’e-Fatura; in base al risultato la fattura viene emessa come e-Fatura o e-Arşiv tramite il vostro intermediario autorizzato, il PDF viene inviato al cliente e il numero di fattura viene registrato sull’ordine. Per le spedizioni si configurano anche l’e-İrsaliye, l’importazione delle fatture ricevute e le procedure di annullamento, secondo l’API dell’intermediario.
Integrazione con contabilità ed ERP
Anagrafiche clienti e fornitori, schede articolo, ordini, fatture e incassi vengono trasferiti automaticamente al vostro sistema di contabilità o ERP; se necessario, stock e prezzi tornano al sito nella direzione opposta. Poiché i record sono collegati tramite chiavi di abbinamento, la stessa fattura non viene creata due volte. Per le aziende nel Regno Unito è possibile configurare anche i collegamenti con Xero, QuickBooks, QuickFile e Sage.
Comunicazione, mappe, identità e altre API
CRM e strumenti di lavoro
Moduli web, richieste di preventivo e nuove registrazioni di clienti arrivano nel vostro CRM come contatti e opportunità; quando cambia la fase di vendita, il team riceve una notifica su Slack o Teams. Le richieste di assistenza possono trasformarsi in schede Jira o Trello.
SMS, WhatsApp e messaggistica
Conferme d’ordine, numeri di tracking, promemoria degli appuntamenti e codici di verifica monouso vengono inviati via SMS o WhatsApp. Tramite WhatsApp Business Platform (Cloud API) si configurano messaggi modello approvati; per le comunicazioni commerciali si rispettano i consensi dei destinatari.
Invio di e-mail
Colleghiamo le e-mail transazionali, come ordini, fatture e reimpostazione della password, a un servizio di invio e configuriamo i record SPF, DKIM e DMARC per ridurre il rischio che finiscano nello spam. Le liste per le newsletter possono essere sincronizzate con Mailchimp o Brevo.
Mappe e servizi di geolocalizzazione
Funzioni come la ricerca di filiali e rivenditori, il completamento automatico degli indirizzi, la conversione di indirizzi in coordinate, il costo di consegna in base alla distanza e il controllo delle zone di consegna si realizzano con i servizi di mappe.
Autenticazione e accesso
I vostri clienti possono accedere con l’account Google, Apple, Microsoft o Facebook senza creare una password; nelle applicazioni aziendali si configura un accesso centralizzato con OAuth 2.0 e OpenID Connect. Se necessario, si aggiunge anche la verifica del numero di identità turco (T.C. kimlik).
Strumenti Google e motori di ricerca
Colleghiamo gli eventi di Google Analytics 4 e Tag Manager per il monitoraggio delle conversioni, il feed di Merchant Center per i cataloghi prodotti, Calendar per gli appuntamenti e Sheets per i report. Le pagine nuove e aggiornate possono essere segnalate a Bing e Yandex tramite IndexNow.
Integrazione dell’intelligenza artificiale
Colleghiamo i modelli linguistici di grandi dimensioni al vostro sistema per attività come bozze di descrizioni prodotto, classificazione delle richieste di assistenza, sintesi di documenti e ricerca semantica nei vostri contenuti. Al modello vengono inviati solo i dati necessari; i risultati possono essere sottoposti ad approvazione umana prima della pubblicazione.
Video, riunioni e prenotazioni
I video formativi vengono pubblicati su YouTube, Vimeo o Bunny Stream; per gli appuntamenti online il link di Zoom o Google Meet si crea automaticamente. Nelle strutture ricettive camere, tariffe e prenotazioni vengono sincronizzate con il channel manager.
Notifiche mobili e servizi per app
Colleghiamo alla vostra app mobile notifiche push, verifica degli acquisti in-app e degli abbonamenti, segnalazione dei crash e monitoraggio degli errori. Gli acquisti vengono controllati con la verifica lato server dello store.
Altre fonti di dati e protocolli
Rientrano in questo ambito anche l’aggiornamento giornaliero dei prezzi con i tassi di cambio della Banca Centrale turca (TCMB), l’importazione massiva di prodotti da file XML dei fornitori, Excel o CSV, lo scambio di file via FTP o SFTP, i servizi SOAP dei sistemi aziendali legacy e le API GraphQL.
Sulle aziende elencate: si tratta di sistemi con cui possiamo integrarci tramite le loro API; ciò non implica partnership, rapporti di rivendita o approvazioni ufficiali. Per l’integrazione è necessario disporre di un proprio account e di un accesso API presso l’azienda interessata. È possibile collegare anche sistemi non presenti nell’elenco, purché dispongano di un’API.
REST, SOAP, webhook o trasferimento di file: quale metodo usare e quando?
| Metodo | Come funziona | Casi d’uso adatti | Aspetti a cui prestiamo attenzione |
|---|---|---|---|
| REST API | Richieste e risposte via HTTPS, per lo più in formato JSON | La maggior parte dei servizi di pagamento, marketplace, spedizione e CRM | Limiti di utilizzo, rinnovo dei token, cambi di versione |
| SOAP | Chiamate a servizi basati su XML, definiti tramite WSDL | Alcuni servizi bancari, di spedizione, e-Fatura e della pubblica amministrazione, sistemi aziendali legacy | Validazione dello schema, certificati, gestione dei timeout |
| Webhook | Il sistema esterno invia una notifica al vostro indirizzo quando si verifica un evento | Eventi in tempo reale come conferma di pagamento, stato della spedizione, modifica dell’ordine | Verifica della firma, notifiche duplicate, recupero degli eventi persi |
| Trasferimento di file (XML / CSV / FTP) | I file vengono preparati, caricati o scaricati a intervalli regolari | Listini prodotti dei fornitori, prezzi e stock massivi, sistemi senza API | Controllo del formato, codifica dei caratteri, file incompleti |
Nella maggior parte dei progetti questi metodi si usano insieme: l’ordine viene inviato via REST, il cambio di stato arriva via webhook e il file di stock massivo viene ricevuto una volta al giorno. La scelta dipende dalle possibilità offerte dal sistema esterno e da quanto i dati devono essere aggiornati.
Il nostro approccio tecnico alle integrazioni
- Validazione lato server: ogni dato proveniente da un sistema esterno viene controllato per formato, tipo e campi obbligatori; i record errati non entrano nel sistema.
- Resistenza alle richieste ripetute: anche se lo stesso ordine o la stessa notifica arriva più volte, l’operazione viene eseguita una sola volta.
- Code e nuovi tentativi: quando il sistema esterno non risponde temporaneamente, le richieste vengono ripetute in modo controllato e gli errori permanenti vengono segnalati.
- Registri delle operazioni: si può tracciare quale dato è stato inviato, quando e a quale sistema; l’origine di un problema si individua facilmente.
- Prima l’ambiente di test: i collegamenti di pagamento, spedizione ed e-Fatura vengono provati prima negli ambienti di test dei provider e solo dopo portati in produzione.
- Protezione delle chiavi segrete: le chiavi API non sono nel codice, ma in file di configurazione non accessibili dal web; i permessi seguono il principio del privilegio minimo.
- Tutela dei dati personali: i dati trasferiti si limitano a quanto necessario, i collegamenti avvengono su canali cifrati e si rispettano i principi di KVKK e GDPR.
- Rispetto dei limiti di utilizzo: le operazioni massive vengono suddivise in base ai limiti di richieste dei provider e le interrogazioni superflue vengono ridotte con la cache.
Come si svolge un progetto di integrazione API?
- Analisi iniziale: individuiamo insieme i sistemi che utilizzate, le attività svolte a mano e quali dati devono fluire e dove.
- Verifica tecnica: esaminiamo la documentazione API dei servizi da collegare, le condizioni di accesso, gli ambienti di test e i limiti di utilizzo.
- Perimetro e preventivo: presentiamo un’offerta scritta con tabella di mappatura dei dati, schema dei flussi, tempi e prezzo.
- Sviluppo e test: realizziamo l’integrazione nell’ambiente di test e la proviamo con scenari realistici e casi di errore.
- Messa in produzione: la attiviamo con le credenziali reali e monitoriamo con voi le prime operazioni.
- Monitoraggio e assistenza: seguiamo i cambi di versione lato provider e pianifichiamo gli aggiornamenti necessari.
Da cosa dipende il prezzo di un’integrazione?
- Numero di sistemi: quanti servizi vanno collegati e la struttura API di ciascuno.
- Direzione del flusso di dati: se serve un trasferimento monodirezionale o una sincronizzazione bidirezionale.
- Esigenza di aggiornamento: se i dati vanno trasferiti in tempo reale o a intervalli regolari.
- Complessità della mappatura: quanta trasformazione richiedono le differenze di categorie, varianti, imposte e unità di misura.
- Possibilità offerte dal provider: qualità della documentazione API, presenza di un ambiente di test e supporto ai webhook.
- Pannello e reportistica: se rientrano nel perimetro le schermate di monitoraggio, l’elenco degli errori e il reinvio manuale.
Tempi e prezzo vengono definiti nell’offerta scritta, dopo l’analisi iniziale e la verifica tecnica.
Perché ADK Yazılım?
- Metodi che usiamo sulla nostra infrastruttura: nel nostro sistema di ordini pagamento con carta, notifiche di conferma del pagamento, fatturazione automatica, notifiche via e-mail e SMS funzionano collegati tra loro.
- Perimetro, tempi e prezzo chiari: l’offerta specifica per iscritto quali dati vengono trasferiti, in quale direzione, e cosa resta escluso.
- Codice testato e sicuro: ogni integrazione viene testata anche con gli scenari di errore e le informazioni riservate sono protette.
- Sistemi locali e internazionali: oltre a POS virtuali, e-Fatura e corrieri turchi, colleghiamo anche servizi internazionali come Stripe, Xero e Royal Mail.
- Assistenza dopo la pubblicazione: effettuiamo gli aggiornamenti quando i provider cambiano qualcosa; inviate le vostre richieste di assistenza dall’area clienti.

