Documentazione

Connessioni

Tutte le connessioni si configurano da Impostazioni → Connessioni. Ogni credenziale viene verificata con una chiamata reale prima di essere salvata (cifrata).

Negozio PrestaShop

  1. 1Scarica il modulo da Impostazioni → Modulo e installalo dal back office del negozio (Moduli → Carica un modulo).
  2. 2In Impostazioni → Connessioni genera il codice di pairing e incollalo nella configurazione del modulo sul negozio.
  3. 3Il modulo si registra da solo: da quel momento vedrai stato, versione e ultima attività nella dashboard.

Un account gestisce un negozio. Il pulsante Verifica connessione esegue un ping e aggiorna la versione del modulo mostrata.

Business Central

Serve un’app registrata su Microsoft Entra ID (Azure AD) con autenticazione service-to-service verso le API Business Central. Di solito la crea il partner BC in pochi minuti:

  1. 1Su Entra ID: registra un’app, crea un client secret, annota Tenant ID e Client ID.
  2. 2Su Business Central: pagina Registrazioni applicazione Microsoft Entra → nuova registrazione con il Client ID, stato Abilitato, permessi D365 BUS FULL ACCESS (o un set equivalente con lettura articoli e gestione ordini di vendita).
  3. 3In i-Connect (Impostazioni → Connessioni → Business Central): inserisci Tenant ID, Client ID e Secret. La piattaforma verifica le credenziali ed elenca gli environment e le company disponibili.
  4. 4Scegli environment (es. Production o sandbox) e company: da quel momento i flussi sono operativi.

Consiglio

Fai i primi test su un environment sandboxe passa a Production solo a flussi verificati. Il pulsante “Scegli la company” permette di cambiare company in ogni momento senza reinserire le credenziali.

FTP (stock da file)

Se lo stock arriva da un file che si autoaggiorna in una cartella FTP/FTPS (tipico export del gestionale), inserisci host, porta, utente, password e percorso. Il percorso può essere:

  • /cartella/stock.csv — file esatto
  • /cartella/ — la piattaforma prende il file più recente della cartella
  • /cartella/stock_*.csv — il file più recente che corrisponde al pattern

Al salvataggio la connessione viene testata davvero (login + risoluzione del file). La frequenza di lettura si imposta nel flusso Stock da file.

Sendcloud

Chiave pubblica e segreta dal pannello Sendcloud (Impostazioni → Integrazioni → API). i-Connect usa Sendcloud solo per stampare l’etichetta: l’ordine dentro Sendcloud lo crea la tua integrazione Sendcloud già esistente sul negozio. Vedi Sendcloud e Klaviyo.

Klaviyo

Basta una Private API Key con permesso Events. i-Connect invia eventi server-side (ordine modificato, ordine spedito) che puoi usare nei flow Klaviyo.

Chiave webhook (ritorno da Business Central)

Quando la verifica di evadibilità è in modalità webhook, la piattaforma genera un URL con chiave segreta per il tuo tenant, da far chiamare a Business Central quando un ordine viene lavorato:

POST https://i-connect.tech/api/webhooks/bc?key=<chiave>
{ "bcOrderNo": "OV26014470" }

La stessa chiave vale per il push dello stock in tempo reale (vedi Per il partner BC).

Prossimo capitolo: Modulo PrestaShop