20.11.2026, 07:43

Importante: le integrazioni con User API smetteranno di funzionare dal 1° gennaio 2027

Stiamo disattivando la User API, la vecchia API di FoodSoul attraverso 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 al passaggio.
 

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.ru/api/user/v1/ (così come by.) — prima versione;
  • https://foodsoul.ru/api/user/v2/ (così come by.) — seconda versione.

Se non siete sicuri, chiedete a chi si occupa della vostra integrazione oppure scrivete all’assistenza.
 

Vantaggi della migrazione
 

La CRM API offre molte più funzionalità rispetto alla User API: permette di lavorare con ordini e relative schede, menu, lista dei prodotti esauriti e giacenze, clienti, promozioni e report.
 

Vale la pena menzionare separatamente i webhook. Grazie a essi, la CRM comunica direttamente al vostro sistema gli eventi — ad esempio, un nuovo ordine o un cambio di stato — senza che l’integrazione debba interrogare costantemente l’API.
 

Un altro vantaggio sono i token di accesso separati. A ogni integrazione può essere assegnato un token con i permessi necessari, che può essere bloccato o eliminato in qualsiasi momento, se necessario.
 

Come effettuare la migrazione

  1. 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.
  2. Inviate il token e il link alla documentazione della CRM API al vostro sviluppatore.
  3. 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.ru. Se avete bisogno di assistenza per la migrazione, scrivete al supporto.



Cordiali saluti, il team di FoodSoul! Lavoriamo per voi!