forumApri un argomento

Hanno detto "faremo un'integrazione API": come funziona il processo e cosa ci verrà chiesto?

NNuri N***PartecipanteMembro della community
Iscrizione
nov 2023
Messaggio
4
#1

Sul nostro sito e-commerce riceviamo in media 60-70 ordini al giorno. onestamente finora ogni sera un dipendente inseriva a mano fatture e movimenti di magazzino nel nostro gestionale contabile. Per automatizzare la sincronizzazione di ordini anagrafiche clienti e giacenze abbiamo concordato il lavoro con un team di sviluppo esterno. Ci hanno fatto un preventivo di 45.000 TL con tempi di consegna di 3 settimane.

Alla prima riunione hanno detto: "preparate gli endpoint API dell'altro sistema e l'ambiente di test, al resto pensiamo noi". Noi però non siamo un'azienda tecnica. cioè quando abbiamo chiamato i fornitori del nostro gestionale contabile, ci hanno chiesto 12.000 TL extra per l'upgrade della licenza API e si sono limitati a mandarci un link alla documentazione prima di sparire.

All'atto pratico, quali sono le fasi di questo processo di integrazione API? Come azienda, quali accessi, account e dati dobbiamo fornire per evitare intoppi? Secondo voi le 3 settimane stimate sono realistiche?

RRecep T***Nuovo membro
Ruolo
Rappresentante vendite sul campo
Settore
Logistica
Tipo di organizzazione
azienda all'interno di un gruppo
Iscrizione
ago 2026
Messaggio
39

Doki · Configurazione del backup · 2023

Più utile#2

Risposta breve: l'integrazione API serve a far dialogare e scambiare dati in automatico il vostro sito web e il software contabile, seguendo regole predefinite. Per far avanzare il processo dovrete sbloccare la licenza API del vostro gestionale, inoltrare la documentazione tecnica agli sviluppatori e predisporre un ambiente di test in cui lavorare senza toccare i dati di produzione.

Di norma il processo si articola in quattro fasi. La prima è la mappatura dei dati: i campi del sito web (nome cliente, partita IVA/codice fiscale, codice articolo, aliquota IVA, spese di spedizione) vengono associati punto per punto a quelli del gestionale. La seconda fase è lo sviluppo e l'integrazione in ambiente di test (sandbox), dove lo sviluppatore crea ordini fittizi per verificare il passaggio al gestionale.

Nella terza fase si testano i casi di errore e le eccezioni. Ad esempio: cosa deve fare il sistema se manca il codice fiscale TC nell'ordine? Come vengono gestiti i coupon sconto in fattura? Come si chiudono a livello contabile resi e annullamenti? Nella quarta fase si inseriscono le chiavi API di produzione, si apre il sistema agli ordini reali e si monitora attentamente per i primi giorni.

Da parte vostra serviranno essenzialmente tre cose: 1) Le chiavi API e la documentazione fornite dalla software house del gestionale, 2) L'accesso a un database di test, 3) La conferma scritta delle vostre logiche operative (momento di emissione fattura, gestione magazzino, regole di sconto). Se il fornitore del gestionale consegna tutta la documentazione tecnica senza ritardi, 3 settimane sono un lasso di tempo ragionevole; se l'assistenza è lenta, si può arrivare facilmente a 5 settimane.

UUfuk S***Partecipante
Ruolo
Contabilità di base
Settore
Agricoltura
Tipo di organizzazione
cooperativa
Iscrizione
giu 2022
Messaggio
74

Doki · Supporto risposta agli incidenti · 2025

#3

L'errore più critico è la mancata corrispondenza dei codici prodotto. Se i codici articolo (SKU) sull'e-commerce non coincidono alla perfezione con quelli del gestionale, l'integrazione salta al primo giorno. Prima di affidare il lavoro al programmatore, verificate voi stessi su un foglio Excel che ogni singolo codice corrisponda tra i due sistemi.

CCanPartecipante
Ruolo
SEO Specialist
Iscrizione
mar 2024
Messaggio
172
#4

Mettete nero su bianco se l'integrazione sarà unidirezionale o bidirezionale. Devono solo passare gli ordini dal sito al gestionale, oppure le giacenze di magazzino e i prezzi modificati a gestionale devono essere riscritti sul sito? Nel caso bidirezionale entrano in gioco limiti di chiamate API e gestione dei conflitti, e questo allunga direttamente i tempi di sviluppo.

KKader U***Partecipante
Ruolo
Addetto al negozio
Settore
Media e editoria
Tipo di organizzazione
azienda familiare
Iscrizione
giu 2024
Messaggio
86
#5

L'anno scorso abbiamo fatto un'integrazione simile. Ci sono voluti ben 9 giorni solo per ottenere licenza API e credenziali di test dalla casa del gestionale. Il team di programmatori ha chiuso il codice in 12 giorni, ma per far quadrare le righe di spedizione e sconto sulla contabilità i test sono andati avanti per altri 8 giorni. In tutto ci sono voluti 29 giorni per andare online.

OOrhan T***PartecipanteMembro della community
Iscrizione
mar 2024
Messaggio
242
#6

Ecco la lista di cose da preparare da parte vostra: 1) Richiedete documentazione e ambiente di test (sandbox) al fornitore del gestionale. 2) Definite con il vostro commercialista le regole operative scritte per gestire annullamenti, resi e consegne parziali. 3) Prima del rilascio in produzione fate emettere almeno 15 fatture di prova coprendo diversi scenari d'uso.

YYaseminPartecipante
Ruolo
Titolare PMI
Iscrizione
lug 2024
Messaggio
98
#7

Il vostro gestionale è in cloud oppure è installato su un server locale nel vostro ufficio? Se gira su un PC in ufficio servono un IP statico e l'apertura delle porte sul server. Questo però può creare falle di sicurezza e se salta la connessione in ufficio, blocca l'integrazione; ne avete già parlato?

TTaner E***Partecipante
Ruolo
Responsabile acquisti
Settore
Pelle
Tipo di organizzazione
startup appena avviata
Iscrizione
giu 2023
Messaggio
132
#8

all'inizio il nostro commercialista faceva bloccare le fatture dei clienti stranieri senza codice fiscale tc kimlik numarası. cioè se ricevete ordini dall'estero o fate fatture aziendali mettetevi d'accordo subito su come mappare quei campi altrimenti gli ordini vi restano bloccati nel sistema.

edit: ho scritto una cosa sbagliata sopra, scusate.

SSinemEsperto
Ruolo
Project manager
Iscrizione
ott 2023
Messaggio
176
#9

Mettete il team di sviluppo e l'assistenza tecnica del vostro gestionale nello stesso gruppo email o canale di comunicazione. Non tocca a voi capire i termini tecnici e fare da tramite. Lasciate che parametri ed endpoint se li smazzino direttamente i tecnici tra di loro.

VVahide K***Partecipante
Ruolo
Grafico
Settore
Energia
Tipo di organizzazione
Azienda da 120 dipendenti
Iscrizione
nov 2023
Messaggio
411
#10

Alla nostra prima integrazione non volevamo spendere 12.000 TL per l'ambiente di test e abbiamo testato direttamente sul database di produzione. Mentre lo sviluppatore emetteva fatture di prova, al cliente reale sono partiti la fattura e-arşiv e gli SMS di notifica. Quel giorno abbiamo capito chiaramente che i soldi spesi per un ambiente di test sono in realtà la polizza più economica che ci sia.

OOnur M***Esperto
Ruolo
Impiegato contabile
Settore
Plastica
Tipo di organizzazione
media impresa
Iscrizione
mag 2023
Messaggio
7
#11

Salvato.

HHüseyin S***VeteranMembro della community
Iscrizione
lug 2022
Messaggio
175
#12

La risposta sopra ha colto l'essenza della questione. Il vero problema non è il numero, ma su cosa si basa quel numero.

Le decisioni affrettate diventano decisioni da correggere sei mesi dopo. Sono curioso di sapere se qualcuno lo fa in modo diverso.

İİbrahim Y***PartecipanteMembro della community
Iscrizione
dic 2024
Messaggio
182
#13

C'è una parte che non ho capito. Se il contratto non specifica la proprietà del codice, al momento di andarsene non hai potere contrattuale.

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

HHilal B***Veteran
Ruolo
Grafico
Settore
Elettrotecnica ed elettronica
Tipo di organizzazione
distributore di zona
Iscrizione
dic 2023
Messaggio
17
#14

Racconto la mia esperienza. Le credenziali di accesso devono essere create a nome dell'azienda, non con account personali.

Lascio una nota, potrebbe servire.

İİbrahim Y***PartecipanteMembro della community
Iscrizione
feb 2026
Messaggio
3
#15

sono d'accordo.

EElifPartecipante
Ruolo
Proprietario di catena di caffè
Tipo di organizzazione
Azienda di produzione da 40 persone
Iscrizione
ago 2024
Messaggio
63

Doki · Supporto risposta agli incidenti · 2024

#16

Non trascurare nulla: L'offerta più economica è spesso quella meno ponderata.

Io seguirei questa strada.

HHavva K***PartecipanteMembro della community
Iscrizione
lug 2024
Messaggio
111
#17

La strada che sembra economica di solito finisce per costare cara. Le credenziali di accesso devono essere create a nome dell'azienda, non con account personali.

Da noi la cosa che faceva perdere più tempo era non sapere chi decidesse. Se avete domande, scrivete, rispondo per quanto possibile.

MMehmet A***Esperto
Ruolo
Sviluppatore software
Settore
Formazione
Tipo di organizzazione
Azienda da 300 dipendenti
Iscrizione
lug 2022
Messaggio
2
#18

Lascio un avvertimento. Ogni punto non scritto è un punto che in futuro le due parti ricorderanno diversamente.

Io seguirei questa strada.

KKübra G***Esperto
Ruolo
IT Manager
Settore
Sport e fitness
Tipo di organizzazione
Azienda di 20 persone
Iscrizione
nov 2025
Messaggio
10
#19

Ho vissuto la stessa cosa. Un report settimanale scritto sull'avanzamento è molto più utile che chiedere date.

Inizia con un piccolo test, non impegnarti subito su tutto. Buon lavoro.

OOsman K***PartecipanteMembro della community
Iscrizione
mar 2024
Messaggio
117
#20

Grazie per averlo scritto, è proprio così. Le decisioni affrettate diventano decisioni da correggere sei mesi dopo.

Non abbiate paura di chiedere, chi non chiede paga sempre di più. È tutto, scusate se mi sono dilungato.

Rispondi