Správa objednávok

Po dokončení objednávky so spôsobom dopravy Slovenskej Pošty sa vybrané údaje odberného miesta trvalo ukladajú do objednávky WooCommerce ako meta objednávky. Tieto údaje sa potom zobrazujú na viacerých miestach pre majiteľa obchodu aj zákazníka.

---

Aké údaje sa ukladajú

Nasledujúce polia sa ukladajú ako meta objednávky WooCommerce:

Tieto hodnoty sa zapíšu do objednávky pri jej vytvorení počas pokladne. Sú trvalé a neskorším zmenám databázy odberných miest nie sú ovplyvnené.

Meta kľúče ePodací Hárok

Nasledujúce polia sa ukladajú pri vytvorení ePH zásielky pre objednávku:

---

Meta kľúče trackingu

Nasledujúce polia sa ukladajú pri pridaní sledovacieho čísla k objednávke:

---

Kde sa zobrazujú informácie o odbernom mieste

Každý kontext zobrazenia môže byť nezávisle zapnutý alebo vypnutý v WP-Admin > Slovenská Pošta > Odberné miesta.

---

Prepísanie adresy

Ak je v nastaveniach zapnuté Nahradiť doručovaciu adresu, polia doručovacej adresy WooCommerce sa prepíšu adresou odberného miesta v čase vytvorenia objednávky:

• Firma pri doručení → názov odberného miesta
• Doručovacia adresa 1 → {ulica} {číslo}
• Doručovacie mesto → mesto
• Doručovacie PSČ → PSČ
• Doručovacia krajina → kód krajiny

Tým sa adresa odberného miesta sprístupní každému systému, ktorý číta štandardnú doručovaciu adresu WooCommerce (exporty objednávok, pluginy na tlač štítkov a pod.).

Pôvodné údaje odberného miesta sú vždy dostupné cez meta kľúče _wcsp_pickup_point_* bez ohľadu na nastavenie prepísania adresy.

Administrácia objednávky

Odberné miesto vo WP-Admin

Keď objednávka obsahuje výber odberného miesta Slovenskej Pošty, v stránke úpravy objednávky vo WP-Admin sa zobrazí vyhradená sekcia.

Umiestnenie: Informácie o odbernom mieste sa zobrazujú pod doručovacou adresou v meta boxe Detaily objednávky, na pravej strane obrazovky úpravy objednávky.

---

Čo sa zobrazuje

Administrátorský pohľad na objednávku zobrazuje:

• Názov odberného miesta — úplný názov zvoleného miesta (napr. „Pošta Bratislava 1").
• Adresa — ulica, číslo ulice, PSČ a mesto.
• Otváracie hodiny — formátovaná tabuľka otváracích hodín odberného miesta, usporiadaná podľa dní v týždni.

Rozvrhnutie používa dvojstĺpcový flexbox dizajn:

• Ľavý stĺpec: názov a adresa
• Pravý stĺpec: tabuľka otváracích hodín

---

Úprava odberného miesta

Administrátorský pohľad je len na zobrazenie. Neexistuje žiadne zabudované UI na zmenu odberného miesta v existujúcej objednávke z administrátorského panela. Ak potrebujete aktualizovať odberné miesto, môžete upraviť meta polia objednávky priamo pomocou pluginu meta boxov (napríklad Advanced Custom Fields alebo zabudovaný meta box Vlastné polia vo WordPress).

Príslušné meta kľúče na aktualizáciu sú uvedené v Prehľad správy objednávok.

---

---

Tracking metabox

Keď je funkcia sledovania zapnutá, do stránky úpravy objednávky sa pridá postranný metabox Slovenská Pošta – Tracking.

Zadanie sledovacieho čísla

Napíšte alebo vložte čiarový kód zásielky do poľa Tracking Number a uložte. Uloženie čísla:

• Uloží ho ako _wcsp_tracking_number pri objednávke.
• Resetuje prípadné predtým uložené udalosti, ak sa číslo zmenilo.
• Pridá poznámku k objednávke: „Tracking number set: [číslo]".

Obnovenie sledovacích udalostí

Kliknite na Refresh pre okamžité načítanie najnovších udalostí z API Slovenskej Pošty, bez ohľadu na interval synchronizácie na pozadí alebo ochranu nočných hodín. Metabox sa aktualizuje na mieste cez AJAX a zobrazí čas poslednej aktualizácie.

Zoznam udalostí

Metabox zobrazuje uložené sledovacie udalosti s:

• Dátumom a časom
• Označením kategórie stavu (napr. „In Transit", „Available for Pickup")
• Popisom z API
• Názvom miesta / depota (ak je dostupný)

Na spodnej časti metaboxu je zobrazený odkaz Track on Slovenská Pošta →.

Stĺpec v zozname objednávok

Keď je v Nastaveniach trackingu zapnuté Show Admin Order List Column, za stĺpcom Celková suma objednávky sa v zozname objednávok zobrazí stĺpec Tracking. Každý záznam zobrazuje:

• Sledovacie číslo ako farebne odlíšený odznak (farba odráža najnovšiu kategóriu sledovania).
• Ikonu detailu, ktorá otvorí modálne okno s úplnou časovou osou udalostí pre danú objednávku.

---

ePodací Hárok metabox

Keď je nakonfigurovaná funkcia ePodací Hárok, do stránky úpravy objednávky sa pridá postranný metabox Slovenská Pošta – ePodací Hárok. Umožňuje vytvárať zásielky a sťahovať štítky bez opustenia obrazovky objednávky. Úplné podrobnosti sú v Jednotlivá objednávka.

Pred vytvorením zásielky

Metabox zobrazuje formulár na úpravu s poliami pre hmotnosť, kategóriu zásielky, triedu zásielky, typ platby, doplnkové služby, sumu dobierky, sumu poistenia a poznámku. Niekoľko polí je automaticky predvyplnených na základe údajov objednávky (detekcia dobierky, neuskladniteľné balenie, príznak služby odberného miesta).

Po registrácii

Po vytvorení a zaregistrovaní zásielky na Slovenskej Pošte je formulár nahradený súhrnom iba na čítanie zobrazujúcim číslo zásielky, odoslané detaily, tlačidlo Download Label a tlačidlo Regenerate ePH.

Stĺpec v zozname objednávok

Zoznam objednávok zobrazuje kompaktný odznak súhrnu ePH pre každú objednávku s ePH údajmi: kategória zásielky, hmotnosť, sumy dobierky/poistenia (ak je to relevantné), odkaz na rýchlu úpravu a odkaz na stiahnutie štítka.

---

Action hooks

Vlastný obsah môžete pridať pred alebo za zobrazenie odberného miesta v administrátorskom rozhraní pomocou action hooks:

// Pred zobrazením odberného miesta
add_action( 'wcsp_before_pickup_point_admin_display', function( $order ) {
    // $order = WC_Order object
} );

// Za zobrazením odberného miesta
add_action( 'wcsp_after_pickup_point_admin_display', function( $order ) {
    // $order = WC_Order object
} );

Úplný prehľad nájdete v Hooks & Filters.

E-maily objednávky

Odberné miesto v e-mailoch objednávky

Keď je v Nastaveniach odberných miest zapnuté Zobraziť v e-mailoch objednávky, detaily odberného miesta sa automaticky pridajú do e-mailov objednávky WooCommerce.

Sekcia odberného miesta sa pridá do e-mailov cez hook woocommerce_email_after_order_table. Zobrazuje sa za tabuľkou objednávky v tele e-mailu.

---

Formát e-mailu

Zobrazenie v e-maile používa HTML dvojstĺpcový formát tabuľky:

• Ľavý stĺpec: Názov odberného miesta a úplná adresa.
• Pravý stĺpec: Tabuľka otváracích hodín (dni v týždni a hodiny).

E-mail podporuje aj formát čistého textu pre e-mailových klientov, ktorí nezobrazujú HTML. V režime čistého textu sa názov, adresa a otváracie hodiny zobrazia ako jednoduchý text.

---

Ktoré e-maily obsahujú údaje o odbernom mieste

WooCommerce odosiela e-maily objednávky pri rôznych udalostiach. Údaje odberného miesta sa pridajú do všetkých e-mailov, ktoré používajú hook woocommerce_email_after_order_table, čo zvyčajne zahŕňa:

• Nová objednávka (odoslaná administrátorovi obchodu)
• Potvrdenie objednávky zákazníkovi (odoslaná zákazníkovi pri pokladni)
• Faktúra zákazníkovi / Detaily objednávky (odoslaná na požiadanie)
• Notifikácia o spracovaní objednávky

---

Vypnutie zobrazenia v e-mailoch

Ak chcete odstrániť informácie o odbernom mieste z e-mailov bez úplného vypnutia funkcie, nastavte Zobraziť v e-mailoch objednávky na Nie v WP-Admin > Slovenská Pošta > Odberné miesta.

---

---

Tracking v e-mailoch

Keď je pre objednávku nastavené sledovacie číslo a v Nastaveniach trackingu je zapnuté Zobraziť v e-mailoch objednávky, do zákazníckych transakčných e-mailov sa vloží sekcia sledovania.

Ktoré e-maily obsahujú tracking

Predvolene je tracking zahrnutý v:

• Zákazník – Objednávka v spracovaní — odoslaná pri zmene stavu objednávky na „Spracováva sa"
• Zákazník – Dokončená objednávka — odoslaná pri zmene stavu objednávky na „Dokončená"
• Zákazník – Objednávka pozastavená — odoslaná pri zmene stavu objednávky na „Pozastavená"

Zoznam ID e-mailov je filtrovateľný cez filter hook wcsp_tracking_email_ids. Administrátorské notifikačné e-maily tracking blok nedostávajú.

Formát e-mailu

HTML e-maily: Za tabuľkou objednávky sa pridá označený blok obsahujúci sledovacie číslo ako klikateľný odkaz a odkaz „Track your parcel on Slovenska Pošta →".

E-maily v čistom texte: Sledovacie číslo a úplná verejná URL sledovania sa pridajú ako čistý text.

Sekcia sledovania sa pridá len vtedy, keď objednávka používa spôsob dopravy Slovenskej Pošty a má nastavené sledovacie číslo.

---

Action hooks

Vlastný obsah môžete pridať pred alebo za zobrazenie odberného miesta v e-maile:

add_action( 'wcsp_before_pickup_point_email_display', function( $order, $sent_to_admin, $plain_text ) {
    // $order        = WC_Order
    // $sent_to_admin = bool
    // $plain_text    = bool
}, 10, 3 );

add_action( 'wcsp_after_pickup_point_email_display', function( $order, $sent_to_admin, $plain_text ) {
    // ...
}, 10, 3 );

Úplný prehľad nájdete v Hooks & Filters.

Zákaznícke stránky

Stránka ďakujeme

Po úspešnej pokladni WooCommerce zobrazí stránku s potvrdením objednávky (stránka „Ďakujeme"). Keď je v nastaveniach zapnuté Zobraziť na stránke Ďakujeme, pod tabuľkou objednávky na tejto stránke sa zobrazí názov, adresa a otváracie hodiny zvoleného odberného miesta.

Zobrazenie sa pridáva cez hook woocommerce_order_details_after_order_table.

Ak chcete vypnúť: nastavte Zobraziť na stránke Ďakujeme na Nie v WP-Admin > Slovenská Pošta > Odberné miesta.

---

Môj účet — Zobraziť objednávku

Prihlásení zákazníci môžu zobraziť svoje predchádzajúce objednávky v Môj účet > Objednávky > Zobraziť objednávku. Keď je v nastaveniach zapnuté Zobraziť v Môj účet — Zobraziť objednávku, detaily odberného miesta sa zobrazia pod tabuľkou položiek objednávky na tejto stránke.

Používa rovnaký hook woocommerce_order_details_after_order_table ako stránka Ďakujeme — plugin kontroluje aktuálny kontext stránky, aby určil, ktoré nastavenie zobrazenia použiť.

Ak chcete vypnúť: nastavte Zobraziť v Môj účet — Zobraziť objednávku na Nie v WP-Admin > Slovenská Pošta > Odberné miesta.

---

Formát zobrazenia

Stránka Ďakujeme aj pohľad na objednávku v Môj účet používajú rovnaké HTML rozvrhnutie:

• Názov odberného miesta ako nadpis.
• Adresa (ulica, číslo, PSČ, mesto).
• Tabuľka otváracích hodín s dňami a hodinami.

Zobrazenie je štylizované frontendovým štýlovým súborom pluginu (wcsp-pp-checkout.css).

---

---

Sledovanie zásielky

Keď je pre objednávku nastavené sledovacie číslo a funkcia sledovania je zapnutá, informácie o sledovaní sa zobrazujú na zákazníckych stránkach objednávky.

Môj účet — Zobraziť objednávku (riadok Sledovacie číslo)

Do tabuľky súhrnov objednávky sa pridá riadok Tracking Number. Sledovacie číslo sa zobrazí ako klikateľný odkaz smerujúci na verejnú stránku sledovania Slovenskej Pošty.

Riadi: nastavenie tracking_in_my_account v WP-Admin > Slovenská Pošta > Tracking.

Stránka Ďakujeme a Zobraziť objednávku (sekcia priebehu)

Pod tabuľkou objednávky sa zobrazuje sekcia sledovania priebehu. Obsahuje:

5-krokový progress bar — kroky sa aktivujú pri prijatí udalostí:

Označenie krokov 4 a 5 sa automaticky prispôsobuje podľa toho, či má objednávka zvolené odberné miesto (prítomnosť meta _wcsp_pickup_point_id).

Časová os udalostí — zbaliteľný zoznam všetkých sledovacích udalostí, najnovšie ako prvé. Každý riadok zobrazuje dátum/čas, označenie stavu, popis a miesto.

Sekciu sledovania je možné obnoviť cez AJAX bez opätovného načítania stránky.

Riadi: nastavenie tracking_in_thank_you v WP-Admin > Slovenská Pošta > Tracking.

---

Riadenie zobrazenia podľa kontextu

Každý kontext zobrazenia je riadeného nezávisle:

Všetky nastavenia sa nachádzajú v WP-Admin > Slovenská Pošta > Odberné miesta.