# Issettja l-STRYK POS Bridge

Canonical: https://staystryk.com/mt/download/pos-bridge/
Language: mt

Installa l-STRYK POS Bridge fuq Windows jew Linux, ikkoppjaha mal-lukanda tiegħek f'STRYK u iddaħħalha fil-kaxxa bħala s-sistema tal-lukanda. Pass pass…

## Agħżel il-kompjuter xieraq

Installa l-bridge fuq il-kompjuter jew is-server fin-netwerk tal-hotel li l-kaxxa wkoll tista' tilħaq. Ġeneralment dan ikun is-server tal-kaxxa jew PC tar-reception li dejjem jaħdem.

Tużax laptop li jmur id-dar kull filgħaxija. Jekk il-kompjuter ikun mitfi, il-kaxxa ma tistax tagħmel posting fuq il-kamra.

## Iċċekkja l-kundizzjonijiet

- Windows 10 / 11, Windows Server 2016 jew aktar ġdid, 64-bit
- Linux x86-64, systemd
- Il-kompjuter dejjem mixgħul.
- Jista' jilħaq il-kaxxa fin-netwerk. Il-port jiddetermina l-manifattur tal-kaxxa; il-bridge tuża 5010 b'mod awtomatiku.
- Għandu internet (HTTPS) ma' STRYK.

## Installa l-bridge: Windows

Aktar tard fil-menu Start issib “Connect STRYK POS Bridge” (l-istess tieqa) u “STRYK POS Bridge Status” (online jew offline, l-hotel konness, l-aħħar posting).

Għall-IT, installazzjoni silenzjuża: STRYK-POS-Bridge-1.0.0-windows-x64.exe /S /CODE=ABCD-EFGH-JKLM.

Tneħħija permezz ta' “Apps & Features” f'Windows tneħħi wkoll is-servizz.

- Niżżel STRYK-POS-Bridge-1.0.0-windows-x64.exe u agħfas darbtejn fuq il-fajl.
- Ikkonferma t-talba ta' Windows għad-drittijiet ta' amministratur. Din hija meħtieġa għax is-setup jissettja servizz ta' Windows.
- Is-setup jissettja s-servizz ta' Windows “STRYK POS Bridge”. Dan jibda awtomatikament u jerġa' jibda wara ħsara.
- Jiftaħ il-port 5010 fil-firewall ta' Windows, għan-netwerk lokali biss.
- Fl-aħħar tidher it-tieqa “Daħħal il-kodiċi tal-konnessjoni” (pass 4).

## Installa l-bridge: Linux

Niżżel stryk-pos-bridge-1.0.0-linux-x64.tar.gz u mexxi fil-kartella tal-fajl:

tar xzf stryk-pos-bridge-1.0.0-linux-x64.tar.gz && cd stryk-pos-bridge-1.0.0 && sudo ./install.sh

Is-setup jissettja s-servizz systemd stryk-pos-bridge. Dan jibda awtomatikament, anke wara restart. Imbagħad jistaqsi għall-kodiċi tal-konnessjoni (pass 4). L-istatus juri stryk-pos-bridge status.

## Oħloq kodiċi tal-konnessjoni f'STRYK

Iftaħ f'STRYK “Impostazzjonijiet › POS”. Taħt “Ikkonnetti l-kaxxa” agħżel “Permezz ta' STRYK POS Bridge” u kklikkja “Oħloq kodiċi tal-konnessjoni”. Dan isir biss b'STRYK POS attiv u bid-dritt li tiġi amministrata l-kaxxa.

Il-kodiċi għandu 12-il karattru u jidher bħala ABCD-EFGH-JKLM. Jiswa 15-il minuta u darba biss.

Daħħalu fit-tieqa “Daħħal il-kodiċi tal-konnessjoni”. Aktar tard dan isir fuq Windows permezz ta' “Konnetti STRYK POS Bridge” fil-menu Start, u fuq Linux b'sudo stryk-pos-bridge connect ABCD-EFGH-JKLM.

Il-bridge tirċievi ċavetta tagħha stess. Ma jkollok x'tikkopja barra minn hekk.

## Daħħal STRYK fil-kaxxa

Daħħal STRYK fil-kaxxa tiegħek bħala sistema tal-hotel (PMS):

Jekk il-manifattur tal-kaxxa tiegħek jeħtieġ varjant ieħor ta' FIAS, is-support ta' STRYK jadatta l-profil tal-manifattur tal-bridge.

- Interfaċċa: FIAS (spiss msejħa “Fidelio”, “Micros-Fidelio” jew “FIAS”)
- Indirizz IP: l-indirizz IP tal-kompjuter tal-bridge
- Port: 5010

## Agħmel posting tat-test

Agħmel posting żgħir mill-kaxxa fuq kamra tat-test okkupata.

Iċċekkja f'STRYK il-posting fil-folio. Taħt “Impostazzjonijiet › POS › Status” tara jekk il-bridge tkunx online, u l-aħħar posting. Il-bejgħ ta' kuljum għal kull outlet jidher fil-kontabbiltà taħt “Kaxxa › Bejgħ”.

Imbagħad ikkanċella l-pożizzjoni tat-test f'STRYK.

## Ikkonnetti kaxxa cloud

Ħafna kaxxi jaħdmu fuq il-cloud. Ma jeħtieġux bridge u jorbtu ruħhom direttament ma' STRYK b'ċavetta API.

Iftaħ f'STRYK “Impostazzjonijiet › POS”. Agħżel taħt “Ikkonnetti l-kaxxa” “Kaxxa cloud” u kklikkja “Oħloq ċavetta API”. Agħżel l-outlet li għalih il-kaxxa tagħmel il-postings.

Iċ-ċavetta tidher darba biss. Ikkopjaha minnufih u għaddiha lill-fornitur tal-kaxxa tiegħek flimkien mal-“Indirizz għall-kaxxa”.

Il-fornitur tal-kaxxa tiegħek irid jappoġġja l-interfaċċa tal-kaxxa ta' STRYK. Id-deskrizzjoni teknika għalih tinsab fid-dokumentazzjoni tal-POS.

Imbagħad agħmel posting tat-test kif fuq, fil-pass 6.

## Jekk xi ħaġa ma taħdimx

- Il-kaxxa ma ssibx il-bridge: Il-kompjuter huwa mixgħul? Is-servizz qed jaħdem? Fuq Windows tara dan taħt Servizzi › “STRYK POS Bridge”, fuq Linux b'systemctl status stryk-pos-bridge. Iċċekkja l-indirizz IP u l-port fil-kaxxa, u jekk il-port 5010 huwiex miftuħ fil-firewall. Il-kaxxa u l-bridge jridu jkunu fl-istess netwerk.
- Il-bridge offline f'STRYK: Iċċekkja l-konnessjoni tal-internet ta' dan il-kompjuter. Il-firewall u l-proxy jridu jippermettu HTTPS lil app.staystryk.com. Sakemm STRYK ma jkunx jista' jintlaħaq, il-bridge tirrifjuta postings tal-kmamar b'mod awtomatiku. F'dak il-każ il-kaxxa trid tiġbor b'mod ieħor.
- Il-kodiċi tal-konnessjoni skada jew diġà ntuża: Oħloq kodiċi ġdid f'STRYK. Jiswa mill-ġdid 15-il minuta.
- “STRYK POS mhux attiv”: Is-sid jattiva l-modulu addizzjonali taħt “Impostazzjonijiet › Kuntratt › Moduli addizzjonali”.
- Bridge diskonnessa: Dan jiġri meta STRYK POS jintemm jew meta l-bridge titneħħa f'STRYK. Attiva mill-ġdid STRYK POS, oħloq kodiċi ġdid u għaqqad mill-ġdid il-bridge.
- Fejn insib il-protokoll?: Windows: C:\\ProgramData\\STRYK\\pos-bridge\\logs\\bridge.log. Linux: journalctl -u stryk-pos-bridge.

## Noti għat-tekniku tal-kaxxa

Dawn id-dettalji huma meħtieġa minn min jissettja l-kaxxa:

L-endpoints, il-kampi u l-eżempji jinsabu fid-dokumentazzjoni teknika tal-POS.

- Bridge (FIAS): TCP/IP fin-netwerk tal-hotel: indirizz IP tal-kompjuter tal-bridge, port 5010
- Kaxxa cloud: HTTPS lill-“Indirizz għall-kaxxa” minn STRYK (jispiċċa b'/api/v1/pos/public)
- Awtentikazzjoni: Authorization: Bearer pos\_live\_… biċ-ċavetta API
- Netwerk: Il-kompjuter tal-bridge jeħtieġ HTTPS lil app.staystryk.com u jilħaq il-kaxxa fl-istess netwerk. Kaxxi mingħajr ebda netwerk ma jistgħux jiġu konnessi.

## Għajnuna mis-support ta' STRYK

Ikteb lilna liema kaxxa tuża, u jekk possibbli ibgħat ukoll il-protokoll.
