
Important: integrările cu User API vor înceta să funcționeze începând cu 1 ianuarie 2027
Dezactivăm User API — vechiul API FoodSoul, prin care anterior se schimbau statusurile comenzilor, se actualizau prețurile și zonele de livrare, se gestionau curierii. Acesta nu mai este actualizat de mult timp: toate noile funcționalități le adăugăm în CRM API.
Dacă integrarea dvs. funcționează prin User API, trebuie să o treceți pe CRM API până la 1 ianuarie. În caz contrar, după această dată, FoodSoul va răspunde cu eroare la toate solicitările acesteia. Cum să vă pregătiți pentru tranziție, vă explicăm mai jos.
Cum să verificați integrarea
Verificarea dacă integrarea dvs. funcționează prin User API poate fi făcută de către dezvoltator. O astfel de integrare trimite solicitări către adrese de tipul:
- https://foodsoul.pro/api/user/v1/ (precum și kz. și az.) — prima versiune;
- https://foodsoul.pro/api/user/v2/ (precum și kz. și ua.) — a doua versiune.
Dacă nu sunteți sigur, întrebați persoana care se ocupă de integrarea dvs. sau scrieți la suport.
Ce avantaje oferă tranziția
CRM API oferă mult mai multe posibilități decât User API: cu el puteți lucra cu comenzi și fișele acestora, meniul, lista de stop și stocuri, clienți, promoții și rapoarte.
Merită menționat separat despre webhook-uri. Cu ajutorul lor, CRM informează automat sistemul dvs. despre evenimente — de exemplu, despre o comandă nouă sau schimbarea statusului — și integrarea nu mai trebuie să interogheze constant API-ul.
Un alt avantaj este reprezentat de token-urile de acces separate. Fiecărei integrări i se poate atribui propriul token cu drepturile necesare, iar dacă este nevoie, acesta poate fi blocat sau șters oricând.
Cum să faceți tranziția
- Creați un token API în CRM: „Integrări” → „Token-uri de acces la API”. Salvați-l imediat: token-ul este afișat o singură dată, la crearea lui.
- Transmiteți token-ul și linkul către documentația CRM API dezvoltatorului dvs.
- Dezvoltatorul va transfera integrarea pe CRM API. Nu este suficientă doar schimbarea adresei: acțiunea acum se specifică în URL-ul solicitării, iar lista câmpurilor transmise în cereri și răspunsuri s-a schimbat.
Vă reamintim că acest lucru trebuie făcut până la 1 ianuarie 2027.
Documentația completă a CRM API se găsește pe portalul FoodSoul: docs.foodsoul.pro. Dacă aveți nevoie de ajutor pentru tranziție, scrieți la suport.
Cu respect, echipa FoodSoul! Lucrăm pentru dumneavoastră!