Nákupní proces a objednávky

Výraz (SPeL), který definuje, jakým způsobem bude generováno číslo objednávky.

Dostupné parametry ve SPeLu jsou:

• data - objekt košíku (ShoppingCart)
• dateFormat(String format) - metoda, která převede aktuální datum na string dle vstupního formátu
• dateFormat(LocalDateTime date, String format) - metoda, která převede datum na vstupu na string dle vstupního formátu
• nextNumber(String sequenceId, Int length) - metoda, která vrátí další číslo z číselné řady, která je určena parametrem 'sequenceId'. Parameter length určuje délku v řetězce výstupního řetězce, kdy číslo bude doplněno 0.
• random(Int length) - metoda, která vrátí náhodné číslo. Parameter length určuje délku v řetězce výstupního řetězce.

Například výraz "'E' + dateFormat('yyyy') + '-' + nextNumber(dateFormat('yyyy'),4)" vygeneruje kód (pro rok 2022) "E2022-0001", "E2022-0002" atd.

Tento výraz je povinný v případě využití default implementace OrderNumberProvider. V případě, že je na projektu vlastní implementace, tak tento výraz nemusí být povinný.

String

✔

-

Seznam zemí, kam je možné fakturovat.

Pokud není uvedeno, berou se země podle seznamu definovaných regionů a jejich zemí.

List: billingCountries/billingCountry

-

-

Kód stavu objednávky, při kterém dojde k rezervaci zboží na skladě, resp. dojde k aktualizaci (Order#getBookingExpiration()), na základě které přechází rezervace do stavu ProductQuantityBookingStatus#ORDERED.

V případě, že rezervace na skladě se váže na jinou událost než stav objednávky, nastavte hodnotu tohoto atributu na none.

Hodnota Order#getBookingExpiration() se pak nastavuje pomocí této modifikace com.fg.cps.eshop.order.modification.dto.OrderModificationSetBookingExpiration.

Výchozí hodnota: "processing-order".

String

-

processing-order

Počet dní, po které se uchovávají rozpracované košíku v DB. Po uplynutí této doby jsou "opuštěné" košíku odstraněny.

Výchozí hodnota je 30 dní.

TimeInterval

-

30d

Atribut podle, kterého se vyhledávají produkty v rámci importu košíku.

Výchozí hodnota je code. Podporován je libovolný filtrovatelný atribut produktu, např. com.fg.cps.eshop.product.model.Product#PROPERTY_CATALOG_NUMBER apod.

String

-

code

Seznam zemí, kam je možné doručovat.

Pokud není uvedeno, berou se země podle seznamu definovaných regionů a jejich zemí.

List: deliveryCountries/deliveryCountry

-

-

Maximální počet položek v košíku, kdy nad tento limit již nelze přidat další položky.

V případě překročení je zákazníkovi zobrazena upozorňující hláška (warning). Limit se nevztahuje přidání bonusových produktů, které se přidávají automaticky na základně splněných podmínek.

Výchozí hodnota je 150.

int

-

150

Hodnota určuje, zda se mají anonymní objednávky při aktivaci uživatele přesunout pod aktivovaného uživatele na základě shody e-mailu uživatele a e-mailu u objednávky.

Hodnota true (výchozí hodnota) znamená, že se objednávky přesunou. V opačném případě se objednávky nepřesunou.

Tuto vlastnost nelze nastavit specificky pro konkrétní katalog. Více zde.

Boolean

-

true

Konfigurace modifikace objednávky.

modifications

-

-

Konfigurace notifikací.

notificationConfig

-

-

Seznam typů doprav, pro které je možné mít nepovinné fakturační údaje.

Nepovinné fakturační údaje jsou možné v případě objednávky do 10tis bez DPH v CZK a také v případě, že není nutné znát dodací adresu, např. při osobním odběru.

V případě, že nebudou fakturační údaje uvedeny, nebude generována faktura, ale stačí pokladní doklad (Tisk pokladního dokladu z EdeeShopu není aktuálně podporován, a je nutné to řešit projektově). Případně, že zákazník bude požadovat fakturu později je nutné, aby si to dořešil přímo s provozovatelem e-shopu.

Nepovinná fakturační adresa je podporována pouze pro CZK měnu.

Výchozí je seznam prázdný, tedy fakturační údaje jsou vždy povinné.

List:

• cPostPickupPoint - Česká pošta - Balík Na poštu
• cPostBalikovna - Česká pošta - Balík do balíkovny
• cPost - Česká pošta - Balík Do ruky
• sPostPickupPoint - Slovenska pošta - Balík na poštu
• sPostBalikobox - Slovenska pošta - Balík do BalíkoBOXu
• sPost - Slovenska pošta - Balík na adresu
• personalPickup - Osobní odběr bez výběru odběrného místa.
• personalPickupAtPoint - Osobní odběr s výběrem odběrného místa
• dpd - DPD
• dpdPickupPoint - DPD Pickup Point
• ppl - PPL
• pplParcelShop - PPL ParcelShop
• zasilkovna - Zásilkovna
• zasilkovnaToAddress - Zásilkovna - doručení na adresu
• geis - GEIS
• gls - GLS
• glsPickupPoint - GLS ShopDeliveryService
• oneDelivery - One by Allegro - doručení na adresu (OneDelivery)
• oneDeliveryPickupPoint - One by Allegro - výdejní místa (OneDelivery)
• dbSchenker - DB Schenker
• dhl - DHL
• email - Typ dopravy, kdy není nutné dopravit zboží fyzicky, ale posílá se emailem
• other - Jiný dopravce (např. doprava do zahraničí)

-

-

Hodnota určuje, zda je kontaktní telefon na zákazníka povinný.

Pokud je hodnota true, telefon je nepovinný. Pokud je false, telefon je povinný. Výchozí hodnota je false.

boolean

-

false

Zapnutí a konfigurace pro částečné expedice.

Tedy objednávku lze částečně přepnout do stavu "částečně expedováno" a "částečně na pobočce" (k vyzvednutí).

Nepovinná hodnota. Pokud není uvedeno, tak částečné expedice nejsou povoleny.

partDispatchConfig

-

-

Hodnota určuje zaokrouhlení přidaného množství produktů v případě, že požadované množství nevyhovuje WithOrderData#getStepOrderAmount().

Pokud je hodnota false (výchozí hodnota), tak se zaokrouhluje směrem nahoru. V opačném případě směrem dolů.

Tedy například produkt lze přidat pouze po 1.5m2 a zákazník požaduje 5m2. Množství v objednávce bude automaticky upraveno na násobek 1.5, tedy ve výchozím nastavení na 6m2.

boolean

-

false

Pravidla pro výpočet úrovně zaokrouhlení finální částky k úhradě.

Pokud nejsou definována žádná pravidla, tak se zohledňuje konfigurace computedPricesRoundedToDecimalPlaces v rámci currencyConfig.

List: roundingRules/roundingRule

-

-

Hodnota určuje způsob zpracování poukazů a případně kreditů (přesněji cenových politik typy OrderPricePolicyCalculationStrategy#PAYMENT) v kontextu uplatnění DPH.

Možné hodnoty jsou:

• single - jednoúčelový poukaz -
• multi - víceúčelový poukaz - výchozí hodnota.

Jednoúčelový poukazZkopírovat odkaz na sekci

• Podmínkou je, aby všechny položky (produkty, dopravy, platby) měly vždy stejnou sazbu DPH v rámci jedné objednávky.
• DPH se odvádí při zakoupení dárkové poukazu. Tedy dárkový poukaz se prodává s odpovídající sazbou DPH.
• Při uplatnění se snižuje základ DPH o hodnotu dárkového poukazu (tak aby nedošlo k dvojímu odvodu DPH).

Víceúčelový poukazZkopírovat odkaz na sekci

• DPH se odvádí při uplatnění dárkového poukazu. Tedy uplatnění dárkového poukazu nesnižuje základ DPH.

String

-

-

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

-

-

Kód země (ISO 3166 - 2 znaky).

String

-

-

Identifikátor regionu.

Pokud je uvedeno, nastavení platí pouze pro tento region. Pokud není uvedeno, platí pro všechny regiony v aktuálním katalogu.

region

-

-

Kód země (ISO 3166 - 2 znaky).

Povinná hodnota.

String

-

-

Měna regionu ( ISO 4217 - 3 znaky).

Povinná hodnota.

currency

-

-

Kód jazyka (ISO 639 - 2 znaky).

Povinná hodnota.

locale

-

-

Kód země (ISO 3166 - 2 znaky).

String

-

-

Identifikátor regionu.

Pokud je uvedeno, nastavení platí pouze pro tento region. Pokud není uvedeno, platí pro všechny regiony v aktuálním katalogu.

region

-

-

Kód země (ISO 3166 - 2 znaky).

Povinná hodnota.

String

-

-

Měna regionu ( ISO 4217 - 3 znaky).

Povinná hodnota.

currency

-

-

Kód jazyka (ISO 639 - 2 znaky).

Povinná hodnota.

locale

-

-

Zapnutí a konfigurace modifikace adres a odběrného místa objednávky.

Pokud není definováno, tak není modifikace povolena.

addressModification

-

-

Interval, po které dojde k automatickému přepnutí stavu do expedováno v případě, že modifikací došlo ke kompletní expedici objednávky.

Interval představuje ochrannou lhůtu, kdy ještě může dojít k modifikaci objednávky, tedy může dojít k odebrání všech položek k expedici a následně k přidání nové položky.

Výchozí hodnota je "3m".

TimeInterval

-

3m

Zapnutí a konfigurace modifikace kontaktních údajů (email + telefon).

Pokud není definováno, tak není modifikace povolena.

contactModification

-

-

Zapnutí a konfigurace modifikace položek objednávky.

Pokud není definováno, tak není modifikace povolena.

itemModification

-

-

Zapnutí a konfigurace modifikace platební metody.

Modifikovat platbu je možné přes AR a také je zpřístupněno rest-api pro změnu platební metody na frontend zákazníkem.

Pokud není definováno, tak není modifikace povolena.

paymentModification

-

-

Možnost konfigurace stavů, kdy už není možné objednávku pro daný typ modifikace upravovat.

Pokud není definováno, tak není modifikace povolena.

List: stateChecks/stateCheck

-

-

Hodnota určuje na jaký typ objednávky z hlediska doručení se konfigurace vztahuje.

Pokud je true, tak se konfigurace vztahuje pouze na objednávky, které byly doručeny na výdejní místo. Pokud je false, tak se konfigurace vztahuje pouze na objednávky, které nebyly doručeny na výdejní místo. Pokud je null, tak se konfigurace vztahuje na všechny objednávky.

Boolean

-

-

Typ modifikace.

Typ odpovídá hodnotě OrderModification#getType() konkrétní implementace.

String

-

-

Kód stavu. Pokud se v daném stavu objednávka nachází, modifikaci již nelze provést.

String

-

-

Seznam stavů objednávky, pro které ma dojít "k okamžitému" odeslání notifikací (e-mail).

Standardně se notifikace odesílají v intervalu 5 min. Pro některé stavy objednávky (např. "new-order") je vhodné odeslat notifikace co nejdříve.

Hodnota je nepovinná a pokud není uvedeno, tak se k okamžitému odeslání dochází pouze pro stav new-order.

String

-

-

Seznam typů doprav, pro které je povolena částečná expedice (nevztahuje se k "částečně na pobočce").

Pokud je seznam prázdný (default), tak je částečná expedice povolena pro všechny typy doprav.

• cPostPickupPoint - Česká pošta - Balík Na poštu
• cPostBalikovna - Česká pošta - Balík do balíkovny
• cPost - Česká pošta - Balík Do ruky
• sPostPickupPoint - Slovenska pošta - Balík na poštu
• sPostBalikobox - Slovenska pošta - Balík do BalíkoBOXu
• sPost - Slovenska pošta - Balík na adresu
• personalPickup - Osobní odběr bez výběru odběrného místa.
• personalPickupAtPoint - Osobní odběr s výběrem odběrného místa
• dpd - DPD
• dpdPickupPoint - DPD Pickup Point
• ppl - PPL
• pplParcelShop - PPL ParcelShop
• zasilkovna - Zásilkovna
• zasilkovnaToAddress - Zásilkovna - doručení na adresu
• geis - GEIS
• gls - GLS
• glsPickupPoint - GLS ShopDeliveryService
• oneDelivery - One by Allegro - doručení na adresu (OneDelivery)
• oneDeliveryPickupPoint - One by Allegro - výdejní místa (OneDelivery)
• dbSchenker - DB Schenker
• dhl - DHL
• email - Typ dopravy, kdy není nutné dopravit zboží fyzicky, ale posílá se emailem
• other - Jiný dopravce (např. doprava do zahraničí)

-

-

Pravidlo je platné pokud je objednávka v této měně (ISO 4217 - 3 znaky). Povinný atribut.

currency

-

-

Pravidlo je platné pokud je platba objednávky daného typu. Nepovinný atribut.

• cash - Platba hotově předem.
• cashOnDelivery - Platba při převzetí (dobírka).
• transfer - Platba předem bankovním převodem.

Pro tento typ platby lze definovat bankovní účty, kam lze uhradit objednávku.

• invoice - Platba na fakturu se splatností.

Zboží se odesílá před uhrazením.

• proformaInvoice - Platba zálohovou fakturou.

Zálohová faktura se zákazníkovi posílá samostatnou notifikací, jakmile je k objednávce vytvořena či nahrána — nezávisle na stavu objednávky. Přechod objednávky do stavu zpracováno existenci zálohové faktury nevyžaduje.

Zboží se odesílá až po zaplacení.

• payU - Platební brána PayU.

Tato platební metoda vyžaduje zapnutý modul PayU platební brány.

• gpWebPay - Platební brána GpWebPay.

Tato platební metoda vyžaduje zapnutý modul GpWebPay platební brány.

• csob - ČSOB Platební brána.

Tato platební metoda vyžaduje zapnutý modul ČSOB platební brány.

• payPal - PayPal.
• paysec - PaySec.cz
• goPay - GoPay platební brána.

Tato platební metoda vyžaduje zapnutý modul GoPay platební brány.

• iPlatba - iPlatba.cz (Cofidis)
• comgate - ComGate platební brána.

Tato platební metoda vyžaduje zapnutý modul ComGate platební brány.

• essox - Platba ESSOX.

Tato platební metoda vyžaduje zapnutý modul Essox platební brány.

• pays - Pays platební brána.

Tato platební metoda vyžaduje zapnutý modul Pays platební brány.

• stripe - Stripe platební brána.

Tato platební metoda vyžaduje zapnutý modul Stripe platební brány.

• twisto - Twisto platební brána.

Tato platební metoda vyžaduje zapnutý modul Twisto platební brány.

-

-

Hodnota určuje na kolik desetinných míst se má zaokrouhlit částka k úhradě. Povinný atribut.

Integer

-

-

Seznam zdrojů objednávek, které mají být zahrnuty do zpracování prodejnosti produktů.

Pokud není uvedeno, tak se zpracují pouze objednávky z košíku, tedy objednávky jejíž zdroj je cart.

String

-

-

Konfigurace odesílání SMS zpráv.

sender

-

-

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

-

-

Přihlašovací údaje pro ctomato.

String

-

-

Konfigurace zpráv, které se mají případně odeslat v případě splnění podmínek.

V případě, že podmínky splňuje více zpráv, tak se odesílá jen první v pořadí.

List: messages/message

-

-

Přihlašovací údaje pro ctomato.

String

-

-

Libovolná textová data, která budou uložena k SMS.

Nepovinná hodnota.

String

-

-

Podmínky toho, zda se tato zpráva odeslat. Je vyžadována minimálně jedna podmínka.

Příklad podmínky:

1order.catalogCode == 'myCatalog' and notificationType == 'NEW_ORDER'

Podmínka je vyhodnocena jako SpEL výraz, kde jako root je k dispozici com.fg.cps.eshop.order.sms.event.OrderSmsNotificationEvent.

List: String

-

-

Klíč pro tělo zprávy.

Pod tímto klíčem se následně hledá message v properties. Message může obsahovat jeden argument, který představuje číslo objednávky.

String

-

-

Pokud je hodnota true, tak nedojde k reálnému odeslání na bránu, ale pouze k zalogování. Vhodné např. pro vývoj.

Výchozí hodnota je false;

boolean

-

false

Klíč pro číslo nebo textový identifikátor odesílatele.

Pod tímto klíčem se následně hledá properties.

Výchozí hodnotou je prázdný řetězec - SMS bude odeslána z čísla ProfiSMS. Možnou hodnotou je buď telefonní číslo v mezinárodním tvaru, nebo text skládající se z písmen anglické abecedy, číslic a znaků . a - (tečka a pomlčka). V případě textu může být tento maximálně 11 znaků dlouhý, bude-li text delší, nebo bude-li obsahovat nepovolené znaky, potom dojde k jeho automatické úpravě na straně ProfiSMS.

String

-

-