HandyCafe Docs
owner it-admin

POS интеграции

Страницата со поставки Интеграции поврзува квалификуван HandyCafe сервер со терминал Ödeal D2D. Достапноста се проверува преку HandyCafe Облак. Менито и страницата се целосно скриени кога кафето нема право да го користи Ödeal.

Пред да започнете

Ви требаат активна претплата за HandyCafe Облак, трговски клуч на Ödeal и таен клуч на Ödeal. Исто така мора да го создадете терминалот во делот Cihazlarım на Ödeal. Точното име доделено на тој терминал е неговиот externalDeviceKey. Започнете со околината Stage. Префрлете се на Production дури откако Ödeal ќе ги одобри податоците за пристап за околината Production и поставувањето на повратниот повик.

Конфигурирање на Ödeal

  1. Отворете Поставки и изберете Интеграции.
  2. Во Ödeal сметка внесете ги трговскиот клуч и тајниот клуч што ви ги дал Ödeal. HandyCafe овие вредности ги испраќа директно до HandyCafe Облак. Тие се шифрираат, не се чуваат во локалната база на податоци и повеќе не се прикажуваат.
  3. Изберете Тест на врската. Кога има нови клучеви, HandyCafe прво ги зачувува безбедно, а потоа ја тестира врската со Ödeal API. Овој тест ја проверува само сметката на Ödeal. Тој не докажува дека терминалот е спарен или онлајн.
  4. Додајте го терминалот. Внесете јасно локално име на уредот. За Име на уред во Ödeal (externalDeviceKey) внесете го точното име на уредот создадено во Ödeal. Потоа внесете ги PaxID (изборно), околината, времето на чекање на плаќањето, градот на клиентот, општината на клиентот, стапката на ДДВ за сесии и стапката на ДДВ за нарачки.
  5. Овозможете POS интеграцијата е активна и изберете Зачувај.
  6. Завршете една готовинска сметка и едно плаќање со картичка во околината Stage за да ги проверите спарувањето на терминалот и двата начина на порамнување.

Во ова издание е поддржан само еден активен Ödeal терминал по сервер. Тоа спречува плаќањето да биде упатено кон несакан терминал пред да стане достапен избор на терминал за касиерот.

HandyCafe го зачувува пописот на терминали локално пред Облак да го провери новиот пар податоци за пристап. Одбивањето на податоците за пристап од Ödeal не го отфрла името на терминалот ниту полињата за спарување. Терминал што бара нови податоци за пристап се чува како неактивен додека тие не бидат проверени за избраната околина.

Страницата Интеграции го чита пописот на терминали директно од локалната SQLite база и го прикажува без да чека Облак. Само состојбата на шифрираните податоци за пристап и оддалечената дозвола од давателот бараат барање до Облак.

Ако Ödeal ја одбие конфигурацијата, HandyCafe го прикажува објаснувањето вратено од Ödeal. Одговорот дека профилот на организацијата не е пронајден значи дека парот трговски и таен клуч не припаѓа на организација во избраната околина Stage или Production.

Однесување при плаќање

Кога активниот метод на плаќање е готовина или картичка, наплатата на сесија на компјутер, наплатата на сесија на конзола и затворањето на самостојна нарачка испраќаат идемпотентна кошничка до Ödeal. Готовината се испраќа како документираната опција за плаќање CASH на Ödeal. Терминалот го запишува готовинското плаќање и го печати фискалниот бон или e-Archive сметката, без да отвора екран за наплата со картичка. Картичката се испраќа како CREDITCARD, а HandyCafe го чека резултатот од повратниот повик додека клиентот го завршува плаќањето на терминалот. Наплата што содржи и готовина и картичка ги испраќа двете опции за плаќање со нивните соодветни износи.

Клиентот може да избере плаќање на рати на терминалот кога картичката и договорот со трговецот го овозможуваат тоа. HandyCafe го зачувува пријавениот број на рати со локалната продажба. Локалната продажба се потврдува дури откако Ödeal ќе ја потврди трансакцијата. Ако локалното запишување не успее по потврдата, HandyCafe бара откажување во истиот ден. Неуспешното откажување создава грешка за рачно усогласување и мора да се провери во извештајот за трансакции на Ödeal. Методите на плаќање што не се готовина или картичка продолжуваат низ постоечкиот тек на порамнување во HandyCafe.

Тестови и операции со терминалот

Тестот на врската ги проверува само трговските податоци за пристап на Ödeal и пристапот до API. Тој не печати сметка, не наплаќа картичка и не докажува дека externalDeviceKey е спарен со терминалот.

Доставената документација за D2D API не дефинира посебни крајни точки за Печати тест сметка или Тест наплата. Тестирањето за прифаќање се прави со вообичаени кошнички во околината Stage: испратете готовинска кошничка и проверете го отпечатениот бон, потоа испратете кошничка со картичка и завршете трансакција со едно плаќање или на рати на терминалот. Користете само податоци за тест картички добиени од Ödeal.

Тест случаите за прифаќање на Ödeal вклучуваат затворање на денот и повторно печатење на последната сметка, но тоа се операции на самиот терминал. D2D не документира оддалечени API повици за нив, па HandyCafe не ги нуди како копчиња за далечинско управување.

Оддалечено овозможување и оневозможување

Администраторите на HandyCafe го контролираат Ödeal од Admin > Admin Settings > POS Providers во контролната табла. Глобалниот прекинувач е главната контрола. Стандардните вредности по земја користат двобуквени ISO кодови, како TR. Контролите на ниво на кафе можат изречно да го отворат или затворат Ödeal за една лиценца. Одлуката за одредено кафе има предност пред стандардната вредност за земјата. Со ресетирање на одлуката за кафето, тоа кафе повторно ја следи својата земја.

Редоследот на одлучување е глобален прекинувач, потоа одлука за одредено кафе, потоа стандардна вредност за земјата. Исклучен глобален прекинувач го затвора Ödeal за секое кафе. Изречното затворање за кафе ја крие страницата и кога неговата земја е отворена. Изречното отворање за кафе ја дозволува страницата и кога неговата земја не е во стандардниот список. Исклучувањето на пристапот веднаш го блокира создавањето нови кошнички. Постоечките трансакции во тек сè уште можат да се проверат или откажат, за да не остане заглавено плаќање во тек.

Серверот ја проверува достапноста преку HandyCafe Облак и ја кешира последната успешно потврдена одлука за земјата или за кафето. Каталогот на даватели враќа HTTP 200 со структуриран error.code кога неговиот податок за пристап е невалиден. Десктоп апликацијата го обработува тој одговор така што го освежува податокот за пристап и се обидува повторно. Привремена грешка при автентикација или во мрежата не толкува овозможена административна одлука како оневозможена, па менито Интеграции останува стабилно. Успешен подоцнежен одговор го ажурира кешот веднаш, вклучувајќи и административна одлука за оневозможување. Кога нема претходно потврдена одлука, непозната земја на кафето, неактивна претплата или оневозможен давател ја држат страницата скриена. Новите операции со Ödeal секогаш повторно се одобруваат од Облак, дури и кога се користи кеширана видливост. Кога синхронизираниот профил на кафето нема земја, се користи земјата зачувана на лиценцата.

Безбедност и закрепнување

Податоците за пристап на Ödeal се шифрирани во HandyCafe Облак со клучот од трезорот на распоредувањето. Барањата за повратен повик се автентицираат со конфигурираниот клуч за барање или со заглавјата за трговски и таен клуч на Ödeal. Референтните кодови на кошничките се стабилни за секоја нарачка или сесија. Повторувањето на истата наплата не создава второ задолжување.

Откажувањето кај Ödeal е достапно само според правилата на Ödeal за истиот ден, пред да се затвори серијата на терминалот. Кошничка во тек може да се отстрани посебно пред да заврши плаќањето. Ödeal D2D не нуди општа операција за враќање на средства. Кога рокот за откажување е поминат, користете ги административниот панел на Ödeal и извештајот за трансакции.

Ödeal D2D не нуди документирана оддалечена операција за Z извештај или за затворање на денот. Затворањето на денот завршете го на терминалот. HandyCafe може да чита извештаи за трансакции заради усогласување и ги запишува повратните повици за исплата од Ödeal.