Ca urmare a preluării companiei TAZZ de către WOLT, am implementat modificările necesare în aplicațiile Nexus ERP și Nexus Easy Retail pentru a permite integrarea cu WOLT - API.
Aceasta integrare permite o comunicatie bidirectionala intre Nexus ERP si WOLT si cuprinde:
1. trimiterea de notificari de catre WOLT catre Nexus ERP la aparitia de comenzi noi si la schimbarea starii acestora
2. trimiterea operatiilor de accept sau refuz al comenzilor de catre operatorii din aplicatia Nexus Easy Retail.
Inrolarea (onboarding) unei locatii de vanzare in WOLT API se face urmand pasii:
1. Se achizitioneaza o licenta "Nexus Conector WOLT"
2. In modulul Mesaje EDI se adauga un mesaj completand urmatoarele campuri:
- Directie: Import
- Format: Comanda client - Wolt
- Protocol: https
- Partener: Wolt Romania SRL
- Gestiune: gestiunea de vanzare
- Punct de vanzare - POS: Locatia de vanzare (Catering sau Restaurant)
Acest mesaj EDI va consuma, pentru activare, o licenta de tip Conector WOLT
3. In modulul Aplicatii online se adauga o aplicatie de tip "Aplicatii Externe Online", avand 2 endpoint-uri:
Endpoint 1:
- Denumire : Wolt API autentificare
- Endpoint : v3/webhook/wolt_setauthcode-664eeda2228d49c9ff6b1f89 (ultima parte, dupa semnul "-", e venue_id, obtinut de la Wolt. Nu e obligatoriu, dar daca exista mai multe locatii pe acelasi server, trebuie diferentiate)
- Autentificare = x-api-key
- Param1 = Authorization code endpoint API key (GUID generat aleatoriu si transmis catre Wolt)
- Param2 = venue_id
Endpoint 2:
- Denumire : Wolt API comenzi
- Endpoint : v3/webhook/wolt_orderupdate-664eeda2228d49c9ff6b1f89 (ultima parte e venue_id, ca mai sus)
4. Se trimit urmatoarele informatii catre reprezentantul WOLT pentru onboarding:
Name: NexusERP Restaurant Client (se allege un nume pentru integrare)
RedirectUrl: https://www.nexuserp.ro
Order webhook URL: https://domeniu.ro:55300/api/Endpoint comenzi
Order webhook client secret: Param1 de pe endpoint-ul de comenzi
Order events which trigger notifications: Toate evenimentele
Emails and phone numbers: client@domeniu.ro, Tel: 0733445566
Authorization code endpoint URL: https://domeniu.ro:55300/api/Endpoint autentificare
Authorization code endpoint API key: Param1 de pe endpoint-ul de autentificare
partner_venue_id = GUID generat aleatoriu sau chiar venue_id Wolt
5. Wolt transmite credentialele pentru Wolt-API: client_id si client_secret. Acestea se vor completa pe mesajul EDI in campurile utilizator si parola
6. In Instrumente - Activitati programate se creaza o programare pentru mesajul EDI setat in pasul anterior, avand ca si frecventa: o data la 50 de minute. Acesta va realiza refresh-ul tokenului de acces pe Wolt-API.
7. Se mapeaza articolele din nomenclator cu cele din platforma WOLT. Acest lucru se face prin adaugarea unui cod echivalent de tip "Furnizor", cu partenerul WOLT, avand la cod extern pos_id din platforma Wolt
8. Se specifica articolul utilizat pentru servicii in în modulul Bonuri fiscale → Setări prețuri livratori → Articol serviciu suplimentar. La importul unei comenzi de client provenite din Wolt, dacă pe comandă sunt identificate taxe suplimentare, acestea sunt adăugate automat în Nexus sub forma unui articol de tip serviciu. Dacă există mai multe tipuri de taxe, pentru fiecare tip se generează câte o linie distinctă de serviciu. În denumirea suplimentară a fiecărei linii se afișează denumirea taxei corespunzătoare.
9. Se verifica integrarea prin adaugarea unor comenzi de test
Nota: De regula, activarea integrarii cu WOLT se face asistat de catre personalul Nexus Media.
Operarea în aplicația Nexus Easy Retail se face in modul urmator:
- la aprobarea unei comenzi primite de la WOLT, se va transmite automat către platformă statusul de comandă aprobată, împreună cu data livrării;
- în cazul în care comanda nu poate fi procesată, se va transmite automat statusul "comandă refuzată"
La data de 14 August 2025 a fost rezolvată solicitarea de dezvoltare Integrare WOLT - API cu Nexus Easy Retail prin crearea unei noi funcţionalităţi în aplicaţia Nexus ERP, produsul/licenţa Nexus Easy Retail.
Această funcţionalitate nouă o veţi putea găsi şi utiliza în aplicaţie după instalarea update-ului cu numărul 25.9. Acest update este posibil, ca la data prezentei notificări, să nu fie încă disponibil pentru descărcare şi instalare.
Pentru descărcarea update-ului vă rugăm să accesaţi site-ul nostru www.download.nexuserp.ro,
iar pentru informaţii privind modul de instalare a unui update vă rugăm să accesaţi articolul din manualul online al aplicaţiei Kit-uri, update-uri şi patch-uri.
| v.24.11.200 | Nexus Media