
Importante: le integrazioni con User API smetteranno di funzionare dal 1° gennaio 2027
Stiamo disattivando la User API — la vecchia API di FoodSoul, tramite la quale in passato si modificavano gli stati degli ordini, si aggiornavano i prezzi e le zone di consegna, si gestivano i corrieri. Non viene aggiornata da tempo: tutte le nuove funzionalità vengono aggiunte alla CRM API.
Se la vostra integrazione funziona tramite la User API, dovrete migrarla alla CRM API entro il 1° gennaio. Altrimenti, dopo questa data, FoodSoul risponderà con un errore a tutte le richieste provenienti da essa. Di seguito vi spieghiamo come prepararvi alla transizione.
Come verificare l’integrazione
La verifica se la vostra integrazione utilizza la User API può essere effettuata da uno sviluppatore. Tale integrazione invia richieste agli indirizzi del tipo:
- https://foodsoul.pro/api/user/v1/ (così come kz. e az.) — prima versione;
- https://foodsoul.pro/api/user/v2/ (così come kz. e ua.) — seconda versione.
Se non siete sicuri, chiedete a chi si occupa della vostra integrazione oppure scrivete all’assistenza.
Cosa offre la transizione
La CRM API offre molte più funzionalità rispetto alla User API: permette di gestire ordini e le loro schede, il menù, la lista dei prodotti esauriti e le giacenze, i clienti, le promozioni e i report.
Vale la pena menzionare separatamente i webhook. Grazie a essi, la CRM comunica autonomamente al vostro sistema gli eventi — ad esempio, un nuovo ordine o un cambio di stato — e l’integrazione non deve più interrogare costantemente l’API.
Un altro vantaggio sono i token di accesso separati. A ogni integrazione può essere assegnato un proprio token con i permessi necessari, che può essere bloccato o eliminato in qualsiasi momento, se necessario.
Come effettuare la migrazione
- Create un token API nella CRM: “Integrazioni” → “Token di accesso all’API”. Salvatelo subito: il token viene mostrato solo una volta, al momento della creazione.
- Inviate il token e il link alla documentazione della CRM API al vostro sviluppatore.
- Lo sviluppatore migrerà l’integrazione alla CRM API. Non basta sostituire l’indirizzo: ora l’azione viene specificata nell’URL della richiesta e l’elenco dei campi trasmessi nelle richieste e nelle risposte è cambiato.
Vi ricordiamo che questa operazione deve essere completata entro il 1° gennaio 2027.
La documentazione completa della CRM API è disponibile sul portale FoodSoul: docs.foodsoul.pro. Se avete bisogno di assistenza per la migrazione, scrivete al supporto.
Cordiali saluti, il team di FoodSoul! Lavoriamo per voi!