Integrări POS

Pagina de setări Integrări conectează un server HandyCafe eligibil la un terminal Ödeal D2D. Disponibilitatea este verificată prin HandyCafe Cloud. Meniul și pagina sunt complet ascunse când cafeneaua nu are dreptul să folosească Ödeal.

Înainte de a începe

Aveți nevoie de un abonament HandyCafe Cloud activ, de o cheie de comerciant Ödeal și de o cheie secretă Ödeal. Trebuie să creați și terminalul în zona Cihazlarım din Ödeal. Numele exact atribuit acelui terminal este externalDeviceKey. Începeți cu mediul Stage. Treceți la Production doar după ce Ödeal a aprobat credențialele de producție și configurarea callback-ului.

Configurarea Ödeal

Deschideți Setări și selectați Integrări.
În Cont Ödeal, introduceți cheia de comerciant și cheia secretă furnizate de Ödeal. HandyCafe trimite aceste valori direct către HandyCafe Cloud. Ele sunt criptate, nu sunt stocate în baza de date locală și nu mai sunt afișate ulterior.
Selectați Test conexiune. Când există chei noi, HandyCafe le salvează în siguranță înainte de a testa conexiunea la API-ul Ödeal. Acest test verifică doar contul Ödeal. El nu dovedește că terminalul este asociat sau online.
Adăugați terminalul. Introduceți un nume local clar pentru dispozitiv. La Nume dispozitiv Ödeal (externalDeviceKey), introduceți numele exact al dispozitivului creat în Ödeal. Completați apoi câmpurile opționale: PaxID, mediul, timpul de așteptare a plății, orașul clientului, districtul clientului, cota de TVA pentru sesiuni și cota de TVA pentru comenzi.
Activați Integrare POS activă și selectați Salvează.
Finalizați un bon în numerar și o plată cu cardul în mediul Stage pentru a verifica asocierea terminalului și ambele căi de decontare.

În această versiune este acceptat un singur terminal Ödeal activ per server. Astfel se evită direcționarea unei plăți către un terminal nedorit înainte de a fi disponibil un selector de terminal pentru casier.

HandyCafe salvează local inventarul de terminale înainte ca serviciul Cloud să verifice o pereche nouă de credențiale. Respingerea credențialelor Ödeal nu șterge numele terminalului sau câmpurile de asociere. Un terminal care are nevoie de credențiale noi este păstrat ca inactiv până când acestea sunt verificate pentru mediul selectat.

Pagina Integrări citește inventarul de terminale direct din baza de date SQLite locală și îl afișează fără a aștepta răspunsul din Cloud. Doar starea credențialelor criptate și permisiunea furnizorului la distanță necesită o cerere către Cloud.

Dacă Ödeal respinge configurația, HandyCafe afișează explicația returnată de Ödeal. Un răspuns de tipul „profil de organizație negăsit” înseamnă că perechea formată din cheia de comerciant și cheia secretă nu aparține niciunei organizații din mediul Stage sau Production selectat.

Comportamentul plăților

Când metoda de plată activă este numerarul sau cardul, închiderea sesiunii de PC, închiderea sesiunii de consolă și închiderea unei comenzi de sine stătătoare trimit către Ödeal un coș idempotent. Numerarul este trimis ca opțiunea de plată CASH documentată de Ödeal. Terminalul înregistrează plata în numerar și tipărește bonul fiscal sau bonul e-Arhivă fără a deschide un ecran de încasare cu cardul. Cardul este trimis ca CREDITCARD; HandyCafe așteaptă rezultatul callback-ului în timp ce clientul finalizează plata pe terminal. O închidere care conține numerar și card trimite ambele opțiuni de plată cu sumele aferente.

Clientul poate alege pe terminal o opțiune de plată în rate atunci când cardul și contractul de comerciant permit acest lucru. HandyCafe stochează numărul de rate raportat împreună cu vânzarea locală. Vânzarea locală este înregistrată doar după ce Ödeal confirmă tranzacția. Dacă înregistrarea locală eșuează după confirmare, HandyCafe solicită o anulare în aceeași zi. O anulare eșuată generează o eroare de reconciliere manuală și trebuie verificată în raportul de tranzacții Ödeal. Metodele de plată diferite de numerar și card continuă prin fluxul de decontare obișnuit din HandyCafe.

Teste și operațiuni pe terminal

Test conexiune verifică doar credențialele de comerciant Ödeal și accesul la API. Nu tipărește un bon, nu taxează un card și nu dovedește că externalDeviceKey este asociat cu terminalul.

Documentația API D2D furnizată nu definește endpoint-uri separate pentru Tipărire bon de test sau Tranzacție de test. Testarea de acceptanță folosește coșuri obișnuite în mediul Stage: trimiteți un coș cu plată în numerar și verificați bonul tipărit, apoi trimiteți un coș cu plată cu cardul și finalizați pe terminal o tranzacție cu plată integrală sau în rate. Folosiți doar datele cardurilor de test Stage furnizate de Ödeal.

Cazurile de acceptanță Ödeal includ închiderea de zi și retipărirea ultimului bon, dar acestea sunt operațiuni ale terminalului. D2D nu documentează apeluri API la distanță pentru ele, așa că HandyCafe nu le expune ca butoane la distanță.

Activare și dezactivare la distanță

Administratorii HandyCafe controlează Ödeal din Admin > Setări administrator > Furnizori POS în Dashboard. Comutatorul global este controlul principal. Valorile implicite pe țară folosesc coduri ISO din două litere, precum TR. Controalele la nivel de cafenea pot deschide sau închide explicit Ödeal pentru o singură licență. O decizie specifică unei cafenele are prioritate față de valoarea implicită a țării. Resetarea deciziei cafenelei o face să urmeze din nou setarea țării sale.

Ordinea deciziei este: comutatorul global, decizia specifică cafenelei, apoi valoarea implicită a țării. Un comutator global dezactivat închide Ödeal pentru fiecare cafenea. O închidere explicită la nivel de cafenea ascunde pagina chiar dacă țara respectivă este deschisă. O deschidere explicită la nivel de cafenea permite pagina chiar dacă țara nu se află în lista implicită. Dezactivarea accesului blochează imediat crearea de coșuri noi. Tranzacțiile în așteptare existente pot fi în continuare verificate sau anulate, astfel încât o plată în curs să nu rămână blocată.

Serverul verifică disponibilitatea prin HandyCafe Cloud și memorează în cache ultima decizie de țară sau de cafenea verificată cu succes. Catalogul de furnizori returnează HTTP 200 cu un error.code structurat atunci când credențialul său este invalid. Aplicația desktop tratează acest răspuns reîmprospătând credențialul și reîncercând. O eroare temporară de autentificare sau de rețea nu reinterpretează drept dezactivată o decizie administrativă de activare, așa că meniul Integrări rămâne stabil. Un răspuns ulterior reușit actualizează imediat cache-ul, inclusiv o decizie de dezactivare din partea administratorului. În lipsa unei decizii verificate anterior, o țară necunoscută a cafenelei, un abonament inactiv sau un furnizor dezactivat mențin pagina ascunsă. Operațiunile Ödeal noi sunt întotdeauna autorizate din nou de Cloud, chiar și atunci când se folosește vizibilitatea din cache. Țara salvată pe licență este folosită atunci când profilul de cafenea sincronizat nu are o țară.

Securitate și recuperare

Credențialele Ödeal sunt criptate în HandyCafe Cloud cu cheia de seif a instalării. Cererile de callback sunt autentificate prin cheia de cerere configurată sau prin anteturile Ödeal cu cheia de comerciant și cheia secretă. Codurile de referință ale coșului sunt stabile pentru fiecare comandă sau sesiune. Repetarea aceleiași închideri nu creează o a doua taxare.

Anularea prin Ödeal este disponibilă doar conform regulilor Ödeal privind anularea în aceeași zi, înainte de închiderea lotului pe terminal. Un coș în așteptare poate fi eliminat separat înainte de finalizarea plății. Ödeal D2D nu oferă o operațiune generală de rambursare. Folosiți back office-ul Ödeal și raportul de tranzacții după ce perioada de anulare a trecut.

Ödeal D2D nu oferă o operațiune documentată de raport Z la distanță sau de închidere de zi. Efectuați închiderea de zi pe terminal. HandyCafe poate citi rapoartele de tranzacții pentru reconciliere și înregistrează callback-urile de tip payback primite de la Ödeal.