{"id":43619,"date":"2026-06-12T17:03:57","date_gmt":"2026-06-12T15:03:57","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&#038;p=43619"},"modified":"2026-06-12T17:04:05","modified_gmt":"2026-06-12T15:04:05","slug":"rodzaje-bonow","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/rodzaje-bonow\/","title":{"rendered":"Rodzaje bon\u00f3w"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Aplikacja <em>Rodzaje bon\u00f3w<\/em> pochodzi z modu\u0142u <em>Sprzeda\u017c wielokana\u0142owa<\/em> systemu Comarch ERP Enterprise. Aplikacja umo\u017cliwia definiowanie szablon\u00f3w (rodzaj\u00f3w) bon\u00f3w, kt\u00f3re s\u0105 wykorzystywane przy tworzeniu pojedynczych bon\u00f3w. Rodzaj bonu determinuje domy\u015blne ustawienia i zachowanie wszystkich bon\u00f3w utworzonych na jego podstawie, co zapewnia sp\u00f3jno\u015b\u0107 konfiguracji i zmniejsza nak\u0142ad pracy potrzebny do za\u0142o\u017cenia ka\u017cdego bonu.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dane wprowadzone w rodzaju bony s\u0105 wykorzystywane mi\u0119dzy innymi w aplikacjach <em>Bony<\/em>, <em>Lista: Bony<\/em> oraz <em>Eksport bon\u00f3w<\/em>. Konfiguracja rodzaju bonu jest r\u00f3wnie\u017c przekazywana do system\u00f3w zewn\u0119trznych (Comarch POS, Cloud) za po\u015brednictwem aplikacji eksportuj\u0105cych.<\/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\">Aplikacja obs\u0142uguje bony dla adapter\u00f3w, kt\u00f3re umo\u017cliwiaj\u0105 ich obs\u0142ug\u0119, obecnie: Comarch POS oraz Cloud.<\/div><\/section><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"opis-aplikacji\" >Opis aplikacji<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Aplikacja sk\u0142ada si\u0119 z nag\u0142\u00f3wka oraz obszaru roboczego podzielonego na zak\u0142adki. Cz\u0119\u015b\u0107 p\u00f3l w nag\u0142\u00f3wku oraz w zak\u0142adkach uzale\u017cniona jest od konfiguracji innych p\u00f3l (np. od oznaczenia bonu jako zewn\u0119trznego) &#8211; pola niedost\u0119pne s\u0105 wyszarzone lub ukryte.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"naglowek\" >Nag\u0142\u00f3wek<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">W nag\u0142\u00f3wku aplikacji znajduj\u0105 si\u0119 pola identyfikuj\u0105ce rodzaj bonu oraz jego podstawowe parametry biznesowe. Pola w nag\u0142\u00f3wku:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Rodzaj<\/strong> \u2013 trzyznakowy kod jednoznacznie identyfikuj\u0105cy rodzaj bonu w systemie. Pole obowi\u0105zkowe, edytowalne wy\u0142\u0105cznie przed pierwszym zapisem rodzaju. Po utworzeniu pierwszego bonu na podstawie tego rodzaju zmiana kodu nie jest mo\u017cliwa.<\/li>\n\n\n\n<li><strong>D\u0142ugo\u015b\u0107 numer\u00f3w<\/strong> \u2013 liczba ca\u0142kowita okre\u015blaj\u0105ca d\u0142ugo\u015b\u0107 numer\u00f3w bon\u00f3w generowanych dla tego rodzaju. Pole obowi\u0105zkowe. Warto\u015b\u0107 musi by\u0107 wi\u0119ksza od zera i nie wi\u0119ksza ni\u017c 50.<\/li>\n\n\n\n<li><strong>Prefiks <\/strong>\u2013 opcjonalne pole, pozwalaj\u0105ce okre\u015bli\u0107 prefiks dla numer\u00f3w bon\u00f3w. Prefiks mo\u017ce zawiera\u0107 tylko wielkie litery, numery oraz niekt\u00f3re znaki (na przyk\u0142ad my\u015blnik)<\/li>\n\n\n\n<li><strong>Sufiks <\/strong>\u2013 opcjonalne pole, pozwalaj\u0105ce okre\u015bli\u0107 sufiks dla numer\u00f3w bon\u00f3w. Sufiks mo\u017ce zawiera\u0107 tylko wielkie litery, numery oraz niekt\u00f3re znaki (na przyk\u0142ad my\u015blnik)<\/li>\n\n\n\n<li><strong>Regex<\/strong> \u2013 parametr typu tekstowego pozwalaj\u0105cy na bezpo\u015brednie zdefiniowanie wyra\u017cenia regularnego identyfikuj\u0105cego bonu tego rodzaju. Je\u017celi pole jest wype\u0142nione, adapter wykorzystuje wprowadzon\u0105 warto\u015b\u0107. Je\u017celi pole jest puste, adapter POS buduje wyra\u017cenie regex na podstawie p\u00f3l <em>Prefiks<\/em>, <em>D\u0142ugo\u015b\u0107 numeru<\/em> i <em>Sufiks<\/em>. Pole jest dost\u0119pne, je\u015bli parametr <em>Zewn\u0119trzny<\/em> jest zaznaczony.<\/li>\n\n\n\n<li><strong>Artyku\u0142<\/strong> \u2013 artyku\u0142 reprezentuj\u0105cy bon na dokumentach sprzeda\u017cy. Bon nie mo\u017ce zosta\u0107 bezpo\u015brednio dodany jako pozycja na dokumencie &#8211; jest reprezentowana przez powi\u0105zany artyku\u0142. Pole obowi\u0105zkowe dla bon\u00f3w wewn\u0119trznych. Po utworzeniu pierwszego bonu na podstawie tego rodzaju zmiana artyku\u0142u nie jest mo\u017cliwa.<\/li>\n\n\n\n<li><strong>Opis<\/strong> \u2013 kr\u00f3tki opis rodzaju bonu<\/li>\n\n\n\n<li><strong>Pe\u0142na nazwa<\/strong>\u2013 d\u0142ugi opis rodzaju bonu. Pe\u0142ny opis mo\u017ce pe\u0142ni\u0107 rol\u0119 tekstu domy\u015blnego nadrukowywanego na bonowi (np. \u201eKarta mo\u017ce zosta\u0107 wykorzystana wy\u0142\u0105cznie na artyku\u0142y z 21% VAT\u201d).<\/li>\n\n\n\n<li><strong>W\u0142a\u015bciwa organizacja <\/strong>\u2013 organizacja odpowiedzialna za rodzaj bonu. Domy\u015bln\u0105 warto\u015bci\u0105 jest aktualnie wybrana organizacja. Organizacja musi by\u0107 zgodna z organizacj\u0105 odpowiedzialn\u0105 przypisan\u0105 do artyku\u0142u reprezentuj\u0105cego rodzaj bonu. Po utworzeniu pierwszego bonu na podstawie tego rodzaju zmiana organizacji nie jest mo\u017cliwa.<\/li>\n\n\n\n<li><strong>Kwota bonu<\/strong> \u2013 warto\u015b\u0107 pieni\u0119\u017cna bonu (kwota i waluta), kt\u00f3ra zostanie wst\u0119pnie ustawiona na ka\u017cdym bonie utworzonym w tym rodzaju. Warto\u015b\u0107 0 oznacza, \u017ce bon nie ma warto\u015bci domy\u015blnej i jego warto\u015b\u0107 jest ustalana w procesie sprzeda\u017cy. Domy\u015bln\u0105 walut\u0105 jest waluta wiod\u0105ca pobierana z <em>Konfiguracji<\/em>. Waluta musi odpowiada\u0107 walucie wewn\u0119trznej organizacji przetwarzaj\u0105cej dane bonu.<\/li>\n\n\n\n<li><strong>Zewn\u0119trzny<\/strong> \u2013 parametr typu logicznego okre\u015blaj\u0105cy, czy bon jest wystawiany przez system Comarch ERP Enterprise (parametr odznaczony &#8211; bon wewn\u0119trzny), czy te\u017c przez podmiot zewn\u0119trzny (parametr zaznaczony &#8211; bon zewn\u0119trzny). Dla bonu zewn\u0119trznego system pe\u0142ni jedynie rol\u0119 \u015bledz\u0105c\u0105 i nie odpowiada za walidacj\u0119 bonu. Warto\u015b\u0107 pola po pierwszym zapisie nie mo\u017ce zosta\u0107 zmieniona.<\/li>\n\n\n\n<li><strong>Przyporz\u0105dkowana organizacja<\/strong> \u2013 lista organizacji, w kt\u00f3rych bonu tego rodzaju mog\u0105 zosta\u0107 sprzedane i zrealizowane. Pole obs\u0142uguje wyb\u00f3r wielu warto\u015bci za pomoc\u0105 przycisku rombu. Pole obowi\u0105zkowe.<\/li>\n\n\n\n<li><strong>Generowanie numeru bonu przez adapter <\/strong>\u2013 po zaznaczeniu pola nowy numer bonu jest tworzony przez adapter w momencie sprzeda\u017cy bonu. Dzia\u0142anie zale\u017cy r\u00f3wnie\u017c od pola <em>Do sprzeda\u017cy w sklepie stacjonarnym<\/em> (offline): gdy oba pola s\u0105 odznaczone, adapter musi najpierw zleci\u0107 systemowi CEE weryfikacj\u0119 wprowadzonego numeru; gdy oba s\u0105 zaznaczone, adapter tworzy numer bonu bez weryfikacji CEE; gdy zaznaczone jest tylko pole <em>sprzeda\u017cy w sklepie stacjonarnym<\/em>, numer mo\u017cna wprowadzi\u0107 bezpo\u015brednio z bonu papierowego bez weryfikacji CEE. Pole jest edytowalne wy\u0142\u0105cznie, gdy pole <em>Zewn\u0119trzny<\/em> ma warto\u015b\u0107 <em>Nie<\/em>, a pole <em>sprzeda\u017cy w sklepie stacjonarnym<\/em> ma warto\u015b\u0107 <em>Tak<\/em>, i tylko dop\u00f3ki rodzaj bonu nie zosta\u0142 zapisany po raz pierwszy.<\/li>\n\n\n\n<li><strong>Sta\u0142e znaki identyfikacji miejsca utworzenia<\/strong> \u2013 liczba znak\u00f3w zarezerwowanych w numerze bonu na identyfikator miejsca utworzenia (kana\u0142u sprzeda\u017cy lub terminala POS). Pole wype\u0142niane automatycznie warto\u015bci\u0105 z <em>Konfiguracji<\/em> (parametr <em>Sta\u0142e znaki dla numeru bonu <\/em>w funkcji<em> Og\u00f3lne<\/em>) podczas pierwszego zapisu rodzaju, gdy zaznaczony jest parametr <em>Generowanie numeru bonu przez adapter<\/em>. Pole nie jest edytowalne. Po pierwszym zapisie warto\u015b\u0107 nie podlega aktualizacji.<\/li>\n\n\n\n<li><strong>Aktywne<\/strong> \u2013 parametr informuj\u0105cy, czy rodzaj bonu mo\u017ce by\u0107 wykorzystywany przez adaptery do tworzenia nowych bon\u00f3w. Warto\u015b\u0107 ustawiana automatycznie przez system na podstawie zgodno\u015bci konfiguracji pola <em>Sta\u0142e znaki identyfikacji miejsca utworzenia<\/em> z najwy\u017cszym identyfikatorem kana\u0142u sprzeda\u017cy lub terminala POS. Warto\u015b\u0107 domy\u015blna: <em>Aktywne<\/em>. Pole nie jest edytowalne i nie mo\u017ce zosta\u0107 zmienione przez import BIS.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"obszar-roboczy\" >Obszar roboczy<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Obszar roboczy aplikacji podzielony jest na zak\u0142adki grupuj\u0105ce parametry rodzaju bonu wed\u0142ug ich przeznaczenia: parametry og\u00f3lne sposobu u\u017cycia oraz parametry ksi\u0119gowe.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"zakladka-ogolne\" >Zak\u0142adka <em>Og\u00f3lne<\/em><\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">Zak\u0142adka Og\u00f3lne zawiera parametry definiuj\u0105ce spos\u00f3b u\u017cytkowania bon\u00f3w tego rodzaju w procesie sprzeda\u017cy i realizacji.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Zastosowanie<\/strong> \u2013 definiuje, czy bonu tego rodzaju mog\u0105 zosta\u0107 wykorzystane jednorazowo, czy te\u017c wielokrotnie. Dost\u0119pne warto\u015bci: <em>Jednorazowego u\u017cytku<\/em> (bon jest realizowany w ca\u0142o\u015bci na jednym dokumencie) oraz <em>Wielokrotnego u\u017cytku<\/em> (bon mo\u017ce by\u0107 realizowany cz\u0119\u015bciowo na wielu dokumentach do wyczerpania salda). Po utworzeniu pierwszego bonu na podstawie tego rodzaju zmiana sposobu u\u017cycia nie jest mo\u017cliwa.<\/li>\n\n\n\n<li><strong>Okres obowi\u0105zywania w dniach<\/strong> \u2013 liczba dni, przez kt\u00f3r\u0105 bon jest wa\u017cny, licz\u0105c od dnia sprzeda\u017cy. Warto\u015b\u0107 0 oznacza, \u017ce bon nie ma daty wa\u017cno\u015bci (jest wa\u017cny bezterminowo). Warto\u015b\u0107 musi by\u0107 wi\u0119ksza lub r\u00f3wna 0.<\/li>\n\n\n\n<li><strong>\u015arodki mo\u017cliwe do do\u0142adowania <\/strong>\u2013 parametr okre\u015bla, czy mo\u017cliwe jest dodanie \u015brodk\u00f3w do bonu po jego pierwszym zakupie. Pole jest informacj\u0105 przekazywan\u0105 do adapter\u00f3w.<\/li>\n\n\n\n<li><strong>Zezwalaj na zwrot got\u00f3wki<\/strong> \u2013 pole okre\u015bla, czy dla danego rodzaju bonu dozwolony jest zwrot got\u00f3wki. Pole jest dost\u0119pne i edytowalne, a jego warto\u015b\u0107 mo\u017cna zmienia\u0107 r\u00f3wnie\u017c wtedy, gdy istniej\u0105 bony tego rodzaju. Warto\u015b\u0107 domy\u015blna: <em>Nie<\/em>. Pole nie jest edytowalne, gdy zaznaczone jest pole <em>Limit u\u017cycia<\/em><\/li>\n\n\n\n<li><strong>Do sprzeda\u017cy w sklepie stacjonarnym<\/strong> \u2013 definiuje, czy bon mo\u017ce zosta\u0107 sprzedany w trybie offline na stanowisku POS. Pole jest informacj\u0105 przekazywan\u0105 do adapter\u00f3w.<\/li>\n\n\n\n<li><strong>Do realizacji w sklepie stacjonarnym<\/strong> \u2013 definiuje, czy bon mo\u017ce zosta\u0107 realizowany w trybie offline na stanowisku POS. Pole jest informacj\u0105 przekazywan\u0105 do adapter\u00f3w.<\/li>\n\n\n\n<li><strong>Spersonalizowane<\/strong> \u2013 okre\u015bla, czy bony tego rodzaju s\u0105 przypisywane do konkretnego klienta. Dla bon\u00f3w spersonalizowanych obowi\u0105zkowe jest wskazanie klienta (partnera o roli <em>Klient<\/em>) podczas tworzenia bonu. Realizacja bonu spersonalizowanego przez innego klienta podlega kontroli zgodnie z parametrem <em>Realizuj bon przez innego klienta<\/em> w <em>Konfiguracji<\/em> (<em>Sprzeda\u017c wielokana\u0142owa<\/em>, funkcja <em>Og\u00f3lne<\/em>).<\/li>\n\n\n\n<li><strong>Mo\u017cna stosowa\u0107 przez x dni po dacie obowi\u0105zywania<\/strong> \u2013 liczba dni, w trakcie kt\u00f3rych bon jest akceptowany po up\u0142ywie oficjalnego okresu wa\u017cno\u015bci. Pole edytowalne wy\u0142\u0105cznie, gdy zaznaczone jest pole <em>Limit u\u017cycia<\/em> (dla bon\u00f3w \u017cywieniowych) lub <em>Bon us\u0142ugowy<\/em>. Warto\u015b\u0107 domy\u015blna: 0. Dopuszczalne s\u0105 warto\u015bci b\u0119d\u0105ce dodatnimi liczbami ca\u0142kowitymi. Je\u017celi pole Limit wykorzystania zostanie odznaczone, warto\u015b\u0107 zostaje przywr\u00f3cona do 0.<\/li>\n\n\n\n<li><strong>Limit u\u017cycia<\/strong> \u2013 parametr typu logicznego oznaczaj\u0105cy, \u017ce bon zewn\u0119trzny jest bonem \u017cywieniowym z limitem warto\u015bci i ograniczeniem do okre\u015blonych artyku\u0142\u00f3w. Pole jest edytowalne, gdy zaznaczono parametr <em>Zewn\u0119trzny<\/em>. Po eksporcie rodzaju bonu do systemu zewn\u0119trznego (Comarch POS) parametr nie jest edytowalny. Je\u017celi pole <em>Zewn\u0119trzny<\/em> jest odznaczone, pole zostaje przywr\u00f3cone do warto\u015bci domy\u015blnej. Zaznaczenie parametru blokuje edycj\u0119 p\u00f3l <em>Zezwalaj na zwrot got\u00f3wki<\/em> oraz <em>Okres obowi\u0105zywania w dniach<\/em>.<\/li>\n\n\n\n<li><strong>Bon us\u0142ugowy<\/strong> \u2013 parametr typu logicznego oznaczaj\u0105cy, \u017ce bon zewn\u0119trzny jest bonem us\u0142ugowym (np. bon socjalny wystawiany przez podmioty publiczne). Pole jest dost\u0119pne wy\u0142\u0105cznie dla bon\u00f3w zewn\u0119trznych. Zaznaczenie parametru umo\u017cliwia wykorzystanie pola <em>Mo\u017cna stosowa\u0107 przez x dni po dacie obowi\u0105zywania<\/em>.<\/li>\n\n\n\n<li><strong>Kod wystawcy (Emitter code)<\/strong> \u2013 kod wystawcy bonu zgodny ze struktur\u0105 numeru GS1-128. Pole edytowalne wy\u0142\u0105cznie, gdy zaznaczone s\u0105 parametry <em>Zewn\u0119trzny<\/em> oraz <em>Aktywne<\/em>. Dozwolone s\u0105 wy\u0142\u0105cznie cyfry o d\u0142ugo\u015bci od 6 do 12 cyfr. Po utworzeniu pierwszego bonu na podstawie tego rodzaju zmiana warto\u015bci nie jest mo\u017cliwa. Pole mo\u017ce by\u0107 ustawiane za pomoc\u0105 BIS.<\/li>\n\n\n\n<li><strong>Kontrola sprzeda\u017cy nie jest wymagana <\/strong>\u2013 parametr decyduj\u0105cy, czy bon tego rodzaju musi zosta\u0107 sprzedany przed jej realizacj\u0105. Warto\u015b\u0107 domy\u015blna: parametr odznaczony &#8211; bon musi by\u0107 sprzedany przed realizacj\u0105. Po zaznaczeniu walidacja sprzeda\u017cy przed realizacj\u0105 zostaje pomini\u0119ta. Pole edytowalne wy\u0142\u0105cznie dla bon\u00f3w wewn\u0119trznych. Dla bon\u00f3w zewn\u0119trznych kontrola sprzeda\u017cy nie jest wykonywana niezale\u017cnie od ustawienia tego parametru.<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"zakladka-rachunkowosc\" >Zak\u0142adka <em>Rachunkowo\u015b\u0107<\/em><\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">Zak\u0142adka <em>Rachunkowo\u015b\u0107<\/em> zawiera parametry dotycz\u0105ce rozlicze\u0144 podatkowych i ksi\u0119gowych sprzeda\u017cy oraz realizacji bon\u00f3w.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Zastosowanie<\/strong> \u2013 pole okre\u015bla model rozliczenia podatku VAT dla bon\u00f3w danego rodzaju. Decyduje o tym, w kt\u00f3rym momencie naliczany jest podatek. Dost\u0119pne warto\u015bci:\n<ul class=\"wp-block-list\">\n<li><em>R\u00f3\u017cnego przeznaczenia<\/em> \u2013 bon mo\u017ce zosta\u0107 zrealizowany na zakup artyku\u0142u o dowolnej stawce VAT. Podatek nie jest naliczany w chwili sprzeda\u017cy bonu, lecz dopiero w momencie jego realizacji, przy dostawie towaru lub us\u0142ugi.<\/li>\n\n\n\n<li><em>Jednego przeznaczenia<\/em> \u2013 bon mo\u017ce zosta\u0107 u\u017cyty wy\u0142\u0105cznie na zakup artyku\u0142\u00f3w o jednej, okre\u015blonej stawce VAT. Podatek jest naliczany ju\u017c w chwili sprzeda\u017cy bonu, a nie podczas jego realizacji.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Pole jest widoczne, ale niedost\u0119pne do edycji \u2013 przyjmuje sta\u0142\u0105 warto\u015b\u0107 <em>R\u00f3\u017cnego przeznaczenia<\/em>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" 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\" 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\" 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<h5 class=\"wp-block-heading\" id=\"rest\" >REST<\/h5>\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\">Tworzy jeden lub wi\u0119cej bon\u00f3w.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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\">Zwraca aktualny stan istniej\u0105cego bonu.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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\">Pobiera kwot\u0119 z aktywnego bonu i zapisuje wpis w historii.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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\">Zmienia status karty podarunkowej z CREATED na ACTIVE.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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-43619","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\/43619","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=43619"}],"version-history":[{"count":1,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/43619\/revisions"}],"predecessor-version":[{"id":43620,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/43619\/revisions\/43620"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=43619"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}