Primești o ofertă de la un serviciu extern - o platformă de comenzi, un meniu QR, o aplicație de rezervări, de fidelizare sau de livrare - și te întrebi dacă se poate conecta la Ebriza. Uneori chiar furnizorul îți spune că „se poate". Mai jos găsești cum verifici și ce urmează.
Furnizorul spune că a terminat integrarea, dar nu o găsesc în Marketplace
Unii furnizori își construiesc singuri integrarea cu Ebriza, ca aplicație proprie, pe API-ul nostru public. Când furnizorul îți spune că „a terminat integrarea", înseamnă de obicei că a terminat partea lui de lucru. Înainte ca aplicația să poată fi instalată, echipa Ebriza o verifică împreună cu furnizorul, pe mediul de test, după o listă de criterii de acceptanță (meniu, comenzi, statusuri).
Până când integrarea trece această verificare, aplicația nu este publicată și nu apare în Marketplace-ul din contul tău, deci încă nu ai ce activa sau instala. Asta nu înseamnă că integrarea nu există, ci doar că nu a fost publicată încă.
Ce faci: scrie-ne pe chat și spune-ne numele furnizorului. Un coleg verifică în ce stadiu este integrarea și revine la tine când aplicația se poate instala. Nu îți putem promite un termen, pentru că depinde și de cât de repede finalizează furnizorul verificarea împreună cu noi.
Întâi verifici dacă integrarea există deja
Integrările pe care le poți instala singur se găsesc în contul tău, în Marketplace, în categoria Integrări. Dacă găsești acolo serviciul căutat, integrarea există: îl instalezi și urmezi articolul de ajutor al aplicației respective.
Dacă nu îl găsești, scrie-ne pe chat înainte să tragi o concluzie. Nu toate aplicațiile Ebriza apar în Marketplace - unele sunt incluse în pachetele principale, altele se instalează de către echipa Ebriza - așa că lipsa din listă nu este un răspuns definitiv nici într-un sens, nici în celălalt. Noi îți confirmăm exact cum stă situația pentru serviciul pe care îl folosești.
Faptul că Ebriza are un API public nu înseamnă că avem integrare cu orice serviciu.
Ebriza are un API public, documentat, pe care orice furnizor îl poate folosi ca să construiască o integrare. Asta înseamnă că o integrare este posibilă din punct de vedere tehnic - nu că integrarea cu un anumit serviciu există deja. Sunt două lucruri diferite, iar răspunsul la „aveți integrare cu X?" este dat de lista de integrări, nu de existența API-ului.
O integrare nouă nu se pornește din cont
Nu există o cheie din Marketplace pe care să o iei și cu care să activezi singur o integrare cu un furnizor nou. Nici tu, nici furnizorul nu puteți porni singuri o integrare nouă din cont. Fiecare integrare se stabilește separat, cu fiecare furnizor în parte, iar aplicația din Marketplace o creează echipa Ebriza după ce integrarea a fost agreată și testată.
Criterii de acceptanță
Înainte de trecerea pe producție, vom testa împreună pe contul de stage următoarele scenarii.
1. Sincronizare meniu (SyncProductsUrl)
- Sincronizare inițială a meniului (categorii, produse, prețuri, TVA)
- Categorii imbricate (subcategorii)
- Produse cu modificatori (grup obligatoriu și grup opțional, limite Min/Max)
- Produse de sistem (garanție SGR, bacșiș, taxă de livrare)
- Produs cu garanție SGR asociată
- Modificare preț + re-sincronizare
- Produs nou adăugat / produs șters + re-sincronizare
2. Trimitere comenzi
- Comandă cu un singur produs
- Produs cu modificator cu preț 0
- Produs cu modificator cu preț > 0
- Același produs de două ori, cu modificatori diferiți
- Mai multe opțiuni alese din același grup de modificatori
- Discount pe produs
- Discount pe comandă
- Comandă cu garanție SGR
- Comandă cu bacșiș
- Comandă cu discount + garanție SGR + bacșiș
- Comandă cu taxă de livrare (opțional)
- Notă pe produs
- Comandă cu datele clientului (nume, telefon, adresă)
- Comandă pentru ridicare personală
- Comandă programată (dată de livrare în viitor)
3. Callback-uri
Vom testa și callback-urile de mai jos, urmărind apelurile în logurile noastre:
- ChangeStatusUrl, pentru fiecare status (valoarea ToStatus):
- 10 — Accepted (acceptată)
- 11 — Canceled (anulată / respinsă)
- 20 — InPreparation (în preparare)
- 21 — PreparationFinished (gata de ridicare)
- 29 — NonFiscalReceiptPrinted (bon de comandă tipărit)
- 30 — FiscalReceiptPrinted (bon fiscal tipărit)
- 90 — PickedUp (ridicată)
- 120 — InDelivery (în livrare)
- 130 — DeliveryFinished (livrată)
- StartAcceptingOrdersUrl
- SetItemUnavailableUrl
Cui i se adresează acest ghid?
Acest ghid este scris pentru furnizorii și dezvoltatorii care construiesc o integrare cu Ebriza pe API-ul nostru public.
Dacă ești client Ebriza și vrei doar să afli dacă un anumit serviciu extern este deja integrat cu Ebriza, aceasta este altă întrebare, iar răspunsul nu se află în acest articol. Faptul că avem un API public nu înseamnă că avem integrare cu orice serviciu. Vezi articolul „Se poate integra un anumit serviciu extern cu Ebriza?".
De reținut: o integrare nouă cu un furnizor extern se stabilește separat, cu fiecare furnizor în parte. Nu se pornește din cont, nici de către client, nici de către furnizor, și nu există o cheie din Marketplace care să o activeze.
Pe scurt, pașii sunt aceștia:
1. Ne spui ce serviciu vrei să integrezi, sau furnizorul ne scrie direct la dev@ebriza.com.
2. Furnizorul construiește integrarea pe API-ul nostru public, folosind documentația publică.
3. Echipa Ebriza verifică integrarea împreună cu furnizorul, întâi pe mediul de test, după criteriile de acceptanță. Abia după ce integrarea este acceptată, aplicația este publicată în Marketplace. Până atunci nu o vezi în contul tău.
4. După publicare, instalezi aplicația din Marketplace, iar de acolo integrarea funcționează ca oricare alta.
Nu îți putem promite un termen: depinde de furnizor și de complexitatea integrării. Ce putem face imediat este să înregistrăm cererea ta.
Cazuri care par la fel, dar nu sunt:
-Site-ul tău propriu de comenzi online: legătura dintre site și Ebriza o fac developerii site-ului tău, prin API-ul public. Aplicația „Comenzi Web" nu mai există în Marketplace, deci nu ai nimic de instalat. Developerii scriu la dev@ebriza.com și lucrează pe documentația de la https://ebriza.com/app/public/docs - vezi articolul „Integrare website cu Ebriza".
- Ai o aplicație proprie sau un dezvoltator care vrea să se lege la Ebriza: documentația este publică și o puteți citi imediat - vezi articolul „Integrate external providers with Ebriza" și referința tehnică de la https://ebriza.com/app/public/docs. Pentru întrebări tehnice, dev@ebriza.com.
- Serviciul apare deja instalat în contul tău, dar nu îl vezi: este cel mai probabil o problemă de permisiuni, nu una de integrare - vezi articolul „Nu găsesc o aplicație în contul meu (deși este instalată)".
TAGS: [ integrare cu un serviciu extern, aveți integrare cu, se poate integra cu Ebriza, cum fac o integrare nouă, integrare cu un furnizor nou, API public Ebriza, cheie de integrare din Marketplace, nu găsesc integrarea în Marketplace, cum conectez o aplicație externă la Ebriza, integrare platformă de comenzi, integrare meniu QR, integrare aplicație de rezervări, integrare aplicație de fidelizare, integrare aplicație de livrare, dezvoltator vrea să se lege la Ebriza, documentație API Ebriza, dev@ebriza.com, cât durează o integrare nouă, furnizorul a terminat integrarea, integrarea e gata dar nu apare în Marketplace, nu pot activa integrarea din Marketplace, integrare în verificare la Ebriza, când pot instala aplicația furnizorului]