{"id":4401,"date":"2024-07-12T09:06:43","date_gmt":"2024-07-12T07:06:43","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&#038;p=4401"},"modified":"2026-06-12T17:05:11","modified_gmt":"2026-06-12T15:05:11","slug":"bony","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/bony\/","title":{"rendered":"Bony"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Aplikacja <em>Bony<\/em> pochodzi z modu\u0142u <em>Sprzeda\u017c wielokana\u0142owa<\/em> systemu Comarch ERP Enterprise. Aplikacja s\u0142u\u017cy do tworzenia pojedynczych bon\u00f3w oraz do przegl\u0105dania i edycji istniej\u0105cych bon\u00f3w. Ka\u017cdy bon tworzony w aplikacji opiera si\u0119 na zdefiniowanym wcze\u015bniej rodzaju bonu (aplikacja <em>Rodzaje bon\u00f3w<\/em>), z kt\u00f3rego dziedziczy domy\u015bln\u0105 konfiguracj\u0119 (waluta, warto\u015b\u0107, okres wa\u017cno\u015bci, spos\u00f3b u\u017cycia, parametry ksi\u0119gowe).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Otwarcie pojedynczego bonu oraz wprowadzenie zmian jest mo\u017cliwe wy\u0142\u0105cznie w trybie jednostkowym &#8211; aplikacja prezentuje w\u00f3wczas dane jednej, wskazanego bonu. Do zarz\u0105dzania bonami hurtowo (przegl\u0105d, filtrowanie wielu bon\u00f3w) s\u0142u\u017cy aplikacja <em>Lista: Bony<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><section class=\"document-alert-box indicator\"><div class=\"document-alert-title\">Wskaz\u00f3wka<\/div><div class=\"document-alert-content\"><\/div><\/section><\/p>\n\n\n\n<h3 class=\"wp-block-heading has-black-color has-text-color has-link-color wp-elements-74695a3e29d4ac465ee35cd97434495f\" id=\"opis-aplikacji\" >Opis aplikacji<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Aplikacja sk\u0142ada si\u0119 z nag\u0142\u00f3wka. Zawiera on kluczowe atrybuty bonu, kt\u00f3re jednoznacznie identyfikuj\u0105 bon i opisuj\u0105 jej aktualny stan.<\/p>\n\n\n\n<h4 class=\"wp-block-heading has-black-color has-text-color has-link-color wp-elements-4376e2c48ed1123b2b529d450556fe0e\" id=\"naglowek\" >Nag\u0142\u00f3wek<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">W nag\u0142\u00f3wku znajduj\u0105 si\u0119 pola identyfikuj\u0105ce bon i opisuj\u0105ce jej aktualny stan. Pola w panelu:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Numer <\/strong>\u2013 sk\u0142ada si\u0119 z dw\u00f3ch p\u00f3l:<ul><li><strong>Rodzaj<\/strong> \u2013 rodzaj bonu pobierany z aplikacji <em>Rodzaje bon\u00f3w<\/em>. Pole obowi\u0105zkowe, dost\u0119pne pod przyciskiem [<strong>Pomoc uzupe\u0142niania warto\u015bci<\/strong>]. Po wybraniu rodzaju bonu pola bonu s\u0105 wst\u0119pnie wype\u0142niane warto\u015bciami domy\u015blnymi z rodzaju.<\/li><\/ul>\n<ul class=\"wp-block-list\">\n<li><strong>Numer<\/strong> \u2013 unikalny numer bonu. Pole obowi\u0105zkowe. Numer musi by\u0107 unikalny w obr\u0119bie rodzaju bonu. D\u0142ugo\u015b\u0107 numeru wynika z konfiguracji pola <em>D\u0142ugo\u015b\u0107 numer\u00f3w<\/em> w rodzaju bonu.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Status<\/strong> \u2013 aktualny status bonu. Pole nieedytowalne &#8211; warto\u015b\u0107 ustawiana automatycznie przez system. Dost\u0119pne warto\u015bci: <em>Utworzony, Aktywne, Zablokowane, Nieaktywne<\/em>. Warto\u015b\u0107 domy\u015blna dla nowego bonu: <em>Utworzony<\/em>. Szczeg\u00f3\u0142owy opis status\u00f3w znajduje si\u0119 w dokumencie og\u00f3lnym <em>Bony<\/em>.<\/li>\n\n\n\n<li><strong>Warto\u015b\u0107<\/strong> \u2013 aktualna warto\u015b\u0107 pieni\u0119\u017cna bonu (kwota i waluta). Warto\u015b\u0107 domy\u015blna pobierana jest z pola <em>Kwota bonu<\/em> rodzaju bonu. Waluta musi by\u0107 zgodna z walut\u0105 zdefiniowan\u0105 w rodzaju bonu.<\/li>\n\n\n\n<li><strong>Czas utworzenia bonu<\/strong> \u2013 data i godzina utworzenia bonu w systemie. Pole wype\u0142niane automatycznie.<\/li>\n\n\n\n<li><strong>Obowi\u0105zuje od &#8211; do<\/strong> \u2013 okres wa\u017cno\u015bci bonu. Warto\u015bci\u0105 domy\u015bln\u0105 dla daty <em>Obowi\u0105zuje od<\/em> jest data bie\u017c\u0105ca, natomiast <em>Obowi\u0105zuje do<\/em> jest wyliczana jako <em>Obowi\u0105zuje od<\/em> + <em>Okres obowi\u0105zywania w dniach<\/em> (pole rodzaju bonu). Po utracie wa\u017cno\u015bci bonu status bonu zostaje automatycznie zmieniony na <em>Nieaktywne<\/em>.<\/li>\n\n\n\n<li><strong>Klient<\/strong> \u2013 klient (partner o roli <em>Klient<\/em>), do kt\u00f3rego bon jest przypisany. Pole dost\u0119pne wy\u0142\u0105cznie dla bon\u00f3w, kt\u00f3rych rodzaj ma zaznaczony parametr <em>Spersonalizowany<\/em>. Pole obowi\u0105zkowe dla bon\u00f3w spersonalizowanych. Pole edytowalne wy\u0142\u0105cznie do momentu zapisu nowego bonu. Lista dost\u0119pnych klient\u00f3w obejmuje partner\u00f3w posiadaj\u0105cych rol\u0119 Klient w jednej z organizacji przyporz\u0105dkowanych do rodzaju bonu.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading has-black-color has-text-color has-link-color wp-elements-f12d70b7ea2683cc333c739b8807e3d0\" id=\"wspolpraca-z-adapterami\" >Wsp\u00f3\u0142praca z adapterami<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Bony s\u0105 wymieniane mi\u0119dzy systemem a adapterami za po\u015brednictwem aplikacji <em>Eksport bon\u00f3w<\/em> oraz webserwis\u00f3w i interfejs\u00f3w BIS. Spos\u00f3b obs\u0142ugi bonu mo\u017ce r\u00f3\u017cni\u0107 si\u0119 w zale\u017cno\u015bci od adaptera.<\/p>\n\n\n\n<h4 class=\"wp-block-heading has-black-color has-text-color has-link-color wp-elements-af8eb4c430c77794d271ca813316dc6d\" id=\"comarch-pos\" >Comarch POS<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Adapter Comarch POS obs\u0142uguje pe\u0142en cykl \u017cycia bonu wewn\u0119trznego.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Informacje na temat obs\u0142ugi bon\u00f3w w Comarch POS mo\u017cna znale\u017a\u0107 w dokumencie <em><a href=\"https:\/\/pomoc.comarch.pl\/pos\/cee\/documentation\/obsluga-bonow\/\">Obs\u0142uga bon\u00f3w<\/a><\/em>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading has-black-color has-text-color has-link-color wp-elements-10c1b2e1630df074689d81154b00ab0e\" id=\"cloud\" >Cloud<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Adapter Cloud udost\u0119pnia webserwis com.sem.ext.app.mcs.loyalty.giftcard.rest.GiftCardsService obs\u0142uguj\u0105cy tworzenie i realizacj\u0119 bon\u00f3w w sklepach internetowych. W zakresie obs\u0142ugiwanym przez adapter:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>sklep internetowy wywo\u0142uje webserwis \u017c\u0105daj\u0105cy utworzenia nowego bonu (lub kilku bon\u00f3w) podaj\u0105c rodzaj bonu oraz opcjonalnie warto\u015b\u0107 i okres wa\u017cno\u015bci; je\u017celi warto\u015b\u0107 lub okres wa\u017cno\u015bci nie s\u0105 podane, u\u017cywane s\u0105 warto\u015bci domy\u015blne z rodzaju bonu<\/li>\n\n\n\n<li>po utworzeniu bonu webserwis zwraca numer bonu oraz jej status (pocz\u0105tkowo <em>Utworzony<\/em>)<\/li>\n\n\n\n<li>bon mo\u017ce zosta\u0107 aktywowany w dowolnym momencie po jej utworzeniu (np. po potwierdzeniu p\u0142atno\u015bci) za pomoc\u0105 metody activateGiftCard &#8211; status zmienia si\u0119 z <em>Utworzony<\/em> na <em>Aktywne<\/em><\/li>\n\n\n\n<li>przy dodaniu bonu do koszyka sklep internetowy mo\u017ce opcjonalnie wywo\u0142a\u0107 webserwis weryfikuj\u0105cy wa\u017cno\u015b\u0107 bonu i jej dost\u0119pne saldo<\/li>\n\n\n\n<li>przed potwierdzeniem zam\u00f3wienia sklep wykonuje obowi\u0105zkow\u0105 weryfikacj\u0119 bonu &#8211; blokuje to wykorzystanie tej samego bonu r\u00f3wnolegle w innym kanale<\/li>\n\n\n\n<li>po potwierdzeniu p\u0142atno\u015bci sklep przekazuje numer bonu oraz wykorzystan\u0105 kwot\u0119; system aktualizuje saldo bonu i je\u017celi saldo wyniesie zero, automatycznie zmienia status bonu na <em>Nieaktywne<\/em><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">REST<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u015acie\u017cka bazowa:<em> com.sem.ext.app.mcs.loyalty.giftcard.rest.GiftCardsService<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Wszystkie punkty ko\u0144cowe: POST,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Format danych wej\u015bciowych i wyj\u015bciowych: application\/json<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dost\u0119pne metody:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>POST \/createGiftCards<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Tworzy jeden lub wi\u0119cej bon\u00f3w.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Tre\u015b\u0107 \u017c\u0105dania: List&lt;GiftCardCreateData&gt; (tablica JSON).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pole wymagane: rodzaj. Pola opcjonalne: warto\u015b\u0107, data wa\u017cno\u015bci od, data wa\u017cno\u015bci do, klient.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>POST \/isGiftCardValid<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Zwraca aktualny stan istniej\u0105cego bonu.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Tre\u015b\u0107 \u017c\u0105dania: pojedynczy obiekt GiftCardData<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pola wymagane: numer, rodzaj..<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>POST \/redeemGiftCard<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Pobiera kwot\u0119 z aktywnego bonu i zapisuje wpis w historii.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Tre\u015b\u0107 \u017c\u0105dania: GiftCardData<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pola wymagane: numer, rodzaj, kwota. Pole opcjonalne: documentData.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>POST \/activateGiftCard<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; Zmienia status karty podarunkowej z CREATED na ACTIVE.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;Tre\u015b\u0107 \u017c\u0105dania: GiftCardData<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pola wymagane: numer, rodzaj.<\/p>\n","protected":false},"author":18,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-4401","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-bony"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/4401","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/comments?post=4401"}],"version-history":[{"count":3,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/4401\/revisions"}],"predecessor-version":[{"id":43618,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/4401\/revisions\/43618"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=4401"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}