forumApri un argomento

Hanno detto che faranno l'integrazione API — cosa significa, deve essere una voce a parte nel preventivo?

MMeltemNuovo membro
Ruolo
Libreria
Tipo di organizzazione
cooperativa
Iscrizione
set 2024
Messaggio
32
#1

Abbiamo un'azienda che produce e vende mobili al dettaglio. Attualmente usiamo un software interno di contabilità ed ERP, da cui gestiamo magazzino e fatture. Adesso stiamo trattando con un'agenzia digitale per far realizzare un nuovo sito e-commerce e un sito web aziendale.

Nel preventivo di sviluppo da 180.000 TL presentato dall'agenzia c'è una sola riga generica: "Integrazione API con i sistemi esistenti", senza alcun dettaglio sul perimetro del lavoro. Quando abbiamo chiesto spiegazioni durante la riunione, ci hanno detto che il sito dialogherà con l'ERP e che funzionerà tutto in automatico, senza però entrare nei dettagli tecnici.

Cos'è esattamente un'integrazione API e perché nei preventivi si resta sempre così vaghi? Questo intervento va prezzato come voce separata e indipendente dal sito, oppure è parte integrante del pacchetto di sviluppo web? Quali limiti dobbiamo stabilire a livello contrattuale per non ritrovarci fregati dopo?

GGökhan C***Partecipante
Ruolo
Responsabile acquisti
Settore
Tipografia
Tipo di organizzazione
media impresa
Iscrizione
giu 2022
Messaggio
181
Più utile#2

Risposta breve: l'integrazione API è il ponte tecnico che consente a due software distinti, come il vostro e-commerce e il gestionale contabile o di magazzino, di scambiarsi dati in tempo reale senza intervento umano. Questa procedura non deve assolutamente essere liquidata con una sola riga nel preventivo: la direzione e la frequenza dei dati da trasferire devono essere definite come voce a parte nel capitolato tecnico.

Le agenzie mantengono questa voce generica perché non possono prevedere a priori gli ostacoli tecnici che incontreranno una volta iniziato il lavoro. L'integrazione non è un processo a senso unico: non basta che il sito sia pronto, serve anche che il vostro ERP disponga del supporto API e delle relative licenze per esporre i dati all'esterno. Molti gestionali commerciali richiedono un costo di licenza aggiuntivo per questo modulo.

Ci sono tre punti fondamentali da chiarire nel contratto: 1) Direzione del flusso dati: le giacenze e i prezzi fluiranno dalla contabilità al sito, oppure gli ordini e le anagrafiche dei clienti verranno scritti dal sito sul gestionale? 2) Frequenza di sincronizzazione: i dati verranno aggiornati in tempo reale o due volte al giorno? 3) Gestione delle eccezioni: come verranno registrati nei log gli ordini in sospeso in caso di caduta della connessione internet o di mancata risposta del server ERP?

Il mio consiglio è di richiedere la documentazione API al fornitore del vostro ERP prima di approvare il preventivo e inoltrarla all'agenzia. Solo dopo aver esaminato questa documentazione l'agenzia dovrebbe inserire l'integrazione nel preventivo come deliverable separato, specificando scenari di test e condizioni di garanzia.

VVildan Ş***Partecipante
Ruolo
Addetto al controllo qualità
Settore
Tessile
Tipo di organizzazione
media impresa
Iscrizione
ago 2024
Messaggio
162
#3

L'API è la porta attraverso cui due software si scambiano richieste e risposte in un formato standard. Tuttavia, se questa porta è chiusa sul lato ERP, l'agenzia non può fare nulla dal lato sito. Il vostro fornitore ERP ha già dei web service REST pronti, o bisognerà sviluppare un servizio ponte ad hoc? Firmare senza chiarire questo punto comporta costi imprevisti sicuri.

PPerihan S***PartecipanteMembro della community
Iscrizione
lug 2023
Messaggio
352
#4

Abbiamo fatto lo stesso errore in un progetto simile. L'agenzia ha scritto "integrazione" in una riga, a sito finito il fornitore del gestionale ha detto "la nostra licenza API costa 50.000 TL e il collegamento dovete farlo voi". L'agenzia se n'è lavata le mani dicendo "noi non mettiamo mano alla contabilità". Il progetto è rimasto bloccato per sei mesi con le due aziende che si davano la colpa a vicenda.

KKemal Ç***Partecipante
Ruolo
Rappresentante vendite sul campo
Settore
Plastica
Tipo di organizzazione
Azienda da 120 dipendenti
Iscrizione
ott 2022
Messaggio
140

Doki · Design interfaccia · 2023

#5

Fate subito revisionare quella riga generica nel preventivo. Fate inserire nel contratto l'elenco puntuale delle tabelle dati da trasferire: schede prodotto listini prezzi, quantità a magazzino e dettagli degli ordini. Inoltre, stabilite come clausola contrattuale dove e come dovranno essere salvati i log di errore in caso di disallineamento dei dati.

LLeyla Ç***Esperto
Ruolo
Contabilità di base
Settore
Servizi di sicurezza
Tipo di organizzazione
media impresa
Iscrizione
gen 2026
Messaggio
1
#6

Ai sensi del diritto contrattuale e dei principi dei capitolati tecnici, gli impegni di integrazione con ambito non definito possono essere interpretati a sfavore del committente in caso di controversia. I criteri di accettazione dei servizi di integrazione, i tempi di tolleranza agli errori e la ripartizione dei costi di licenza dei software di terze parti devono essere disciplinati esplicitamente in un allegato contrattuale.

VVildan D***Partecipante
Ruolo
Addetto al controllo qualità
Settore
Elettrotecnica ed elettronica
Tipo di organizzazione
distributore di zona
Iscrizione
apr 2024
Messaggio
160

Doki · Formazione sulla consapevolezza phishing · 2024

#7

Con un budget totale di 180.000 TL promettere sito aziendale, infrastruttura e-commerce e persino integrazione ERP personalizzata non mi sembra affatto realistico. Un'integrazione bidirezionale fatta a regola d'arte richiede già da sola settimane di test. Molto probabilmente si limiteranno a un semplice passaggio degli ordini e considereranno il lavoro finito.

SSena M***PartecipanteMembro della community
Iscrizione
dic 2024
Messaggio
142
#8

è successa la stessa cosa pure a noi poi arrivavano gli ordini dal sito ma le aliquote iva o gli sconti passavano sbagliati sull'erp. il personale stava uscendo pazzo a correggere tutto a mano. vi consiglio di nn approvare quella clausola senza prima aver preparato una tabella di mappatura dei dati.

JJülide S***EspertoMembro della community
Iscrizione
set 2023
Messaggio
184
#9

Il software ERP che utilizzate è un sistema moderno in cloud oppure gira su un server locale on-premise in azienda? Se si tratta di una struttura desktop di vecchio tipo, per l'accesso dall'esterno saranno necessari IP statico e configurazione del firewall; l'agenzia ha verificato questi requisiti infrastrutturali?

GGamze U***Partecipante
Ruolo
Direttore tecnologico
Settore
Tipografia
Tipo di organizzazione
Team di 8 persone
Iscrizione
feb 2024
Messaggio
270
#10

Lascio un avvertimento. Quando prendete una decisione, scrivete anche lo scenario peggiore, non solo quello migliore.

Sono curioso di sapere se qualcuno lo fa in modo diverso.

CCansu I***VeteranMembro della community
Iscrizione
lug 2022
Messaggio
377
#11

Può approfondire un po'? Le soluzioni che funzionano su piccola scala crollano quando si cresce l'ho imparato tardi.

Correggetemi se sbaglio.

KKadir G***PartecipanteMembro della community
Iscrizione
set 2022
Messaggio
44
#12

Sono passato da qui, vi racconto. Inizia con un piccolo test, non impegnarti subito su tutto.

Le persone difendono le abitudini non i processi. La resistenza nasce da lì. Confermato dall'esperienza.

HHilal D***PartecipanteMembro della community
Iscrizione
dic 2024
Messaggio
166
#13

Sono d'accordo.

YYağmur P***Esperto
Ruolo
Direttore relazioni con i clienti
Settore
Elettrotecnica ed elettronica
Tipo di organizzazione
Azienda da 120 dipendenti
Iscrizione
giu 2025
Messaggio
405
#14

Se volete procedere così, risolvete questo punto fin dall'inizio. L'offerta più economica è spesso quella meno ponderata.

Se avete domande, scrivete, rispondo per quanto possibile.

LLale K***PartecipanteMembro della community
Iscrizione
ott 2025
Messaggio
323
#15

Grazie per averlo scritto è proprio così... Le persone difendono le abitudini, non i processi. La resistenza nasce da lì.

È tutto scusate se mi sono dilungato.

FFerhat A***EspertoMembro della community
Iscrizione
mar 2026
Messaggio
124
#16

C'è un errore comune che si commette facendo questo. Le soluzioni che funzionano su piccola scala crollano quando si cresce, l'ho imparato tardi.

Naturalmente cambia se la vostra situazione è diversa.

MMert Ö***Partecipante
Ruolo
Distributore carburanti
Tipo di organizzazione
startup appena avviata
Iscrizione
nov 2023
Messaggio
64
#17

Breve riassunto per i nuovi arrivati: Se è la prima volta, inizia in piccolo, il ridimensionamento viene dopo.

Quando prendete una decisione, scrivete anche lo scenario peggiore, non solo quello migliore.

PPerihan K***Partecipante
Ruolo
Product manager
Settore
Catering
Tipo di organizzazione
Azienda di 20 persone
Iscrizione
feb 2024
Messaggio
220

Doki · Sito web aziendale · 2024

#18

Per un periodo ci siamo bloccati anche noi nello stesso punto. Inizia con un piccolo test, non impegnarti subito su tutto.

Sono curioso di sapere se qualcuno lo fa in modo diverso.

AAslı G***EspertoMembro della community
Iscrizione
gen 2023
Messaggio
1
#19

Grazie mille, era la risposta che cercavo.

FFatma E***PartecipanteMembro della community
Iscrizione
ott 2025
Messaggio
89
#20

grazie mille proveerò oggi poi boh non abbiate paura di chiedere, chi non chiede paga sempre di più.

confermato dall'esperienza.

Rispondi