Boxpi Admin je webový administratívny panel, cez ktorý spravujete všetky svoje cezhraničné zásielky na jednom mieste. Vytvoríte balík, vyberiete dopravcu, vytlačíte štítok, sledujete doručenie, riešite vrátky a reklamácie a máte prehľad o dobierkach aj faktúrach.

Panel je navrhnutý tak, aby ste nemuseli prepínať medzi systémami jednotlivých dopravcov. Boxpi za vás komunikuje s viac ako dvadsiatimi prepravnými službami naprieč Európou (GLS, DHL, PPL, Cargus, Speedy, DPD, InPost a ďalšími) a vám stačí pracovať v jednom rozhraní.

Pre koho je príručka určená

Príručku sme pripravili pre merchantov — prevádzkovateľov e-shopov a ich tímy, ktoré denne pripravujú a odosielajú zásielky. Nepredpokladáme žiadne technické znalosti; všetko vysvetľujeme krok za krokom a v poradí, v akom to budete reálne používať.

Ako sa prihlásiť

• Otvorte vo svojom prehliadači adresu boxpi-admin.com.
• Zadajte prihlasovacie údaje (e-mail a heslo), ktoré ste dostali od svojho key account managera.
• Po prihlásení sa zobrazí Dashboard s prehľadom vašich štatistík.

Orientácia v paneli

Naľavo nájdete hlavné menu, ktoré je rovnaké na každej obrazovke. Najdôležitejšie položky pre každodennú prácu sú:

• Dashboard — prehľadové štatistiky a metriky.
• Balíky — zoznam zásielok, vytváranie nových balíkov a ich detaily.
• Vratky a Reklamácie — evidencia vrátených zásielok a nahlásených problémov.
• Cenníky — prehľad cien dopravcov podľa krajín.
• Reporty — Týždenný CoD (dobierky) a Mesačná fakturácia (faktúry).
• Health Check — stav pripojenia jednotlivých dopravcov v reálnom čase.
• Nastavenia — profil, dopravcovia, mapovanie CSV a ďalšie.

Dashboard je úvodná obrazovka, ktorá sa zobrazí hneď po prihlásení. Nájdete na nej zhrnutie objemu zásielok, dobierok a výkonu doručovania za zvolené obdobie.

Hlavné ukazovatele (KPI)

V hornej časti sú tri prehľadové dlaždice:

• Celkom balíkov — celkový počet balíkov za celú históriu vášho účtu.
• Posledných 24 h — počet nových balíkov za uplynulý deň (zrušené balíky sa nezapočítavajú).
• Tento týždeň — počet balíkov za posledných 7 dní.

Pod nimi sú dlaždice COD tento mesiac a COD minulý mesiac, ktoré ukazujú objem dobierok a počty balíkov rozdelené podľa stavu (napr. odhadovaný súčet za doručené balíky).

Prepínanie obdobia

V sekcii Štatistiky za obdobie si vpravo hore prepnete časový rozsah, za ktorý sa metriky počítajú:

• 30 dní — predvolené zobrazenie.
• 90 dní — širší pohľad na kvartálny trend.
• Celkovo — celá história účtu.

Po prepnutí sa všetky grafy a čísla nižšie automaticky prepočítajú.

Kľúčové metriky doručovania

• Za obdobie — počet balíkov vo zvolenom rozsahu.
• Čas LMD — medián času doručenia na poslednej míli (Last Mile Delivery) za dané obdobie, počítaný z doručených balíkov.

Grafy

• Podľa krajiny — rebríček top 10 krajín podľa počtu doručených balíkov.
• Podľa statusu — rozdelenie balíkov podľa stavu (doručené, štítok vytvorený, zrušené, v preprave, odoslané a podobne).

Pri zostavách dopravcov nájdete aj prehľadovú tabuľku s mediánom doby doručenia za jednotlivých dopravcov, ktorá vám pomôže porovnať ich reálny výkon.

Sekcia Balíky je srdcom celého panela. Tu vytvárate nové zásielky, vyhľadávate existujúce, sledujete ich stav a vykonávate všetky operácie — od tlače štítka po vrátky a reklamácie.

3.1 Zoznam balíkov

Po kliknutí na Balíky v menu sa zobrazí prehľadná tabuľka všetkých vašich zásielok spolu s filtrami a vyhľadávaním.

Stĺpce tabuľky

Filtre nad tabuľkou

Nad zoznamom máte rýchle filtre, ktoré sa dajú ľubovoľne kombinovať:

• Referencia a Tracking číslo — fulltextové vyhľadávanie; viac hodnôt oddelíte čiarkou.
• Status — filtrovanie podľa stavu zásielky.
• Dopravca a Krajina — zúženie na konkrétneho dopravcu alebo cieľovú krajinu.
• Od dátumu / Do dátumu — časové obdobie vytvorenia.
• COD — výber typu (všetko / s dobierkou / bez), plus rozsah COD od a COD do.

Pod hlavnými filtrami sú Detailné filtre, kde viete hľadať podľa ID balíka, mena príjemcu, e-mailu, telefónu či mesta/PSČ. Pri viacerých hodnotách ich oddeľte čiarkou (napr. Novák, Kováč). Po nastavení kritérií kliknite na Filtrovať.

Triedenie a stránkovanie

Kliknutím na šípky pri názve stĺpca (ID, Status, Dopravca, COD, Vytvorené…) zoznam zoradíte vzostupne alebo zostupne. Medzi stránkami sa pohybujete ovládacími prvkami pod tabuľkou.

Akcie nad balíkmi

Pri každom riadku je vpravo tlačidlo ••• (kontextové menu), cez ktoré sa dostanete k akciám pre danú zásielku — napríklad otvorenie detailu. Kliknutím priamo na riadok otvoríte detail balíka (kapitola 3.3).

V hornej lište sú tri tlačidlá:

• Sync — manuálne vyžiadanie synchronizácie stavov. Systém sa inak synchronizuje automaticky každých 30 minút.
• Import CSV — hromadné nahranie zásielok zo súboru.
• + Nový balík — otvorí formulár na vytvorenie zásielky (kapitola 3.2).

Export do CSV / Excelu

Vpravo nad tabuľkou je tlačidlo Export CSV. Po nastavení filtrov vyexportujete presne tú množinu balíkov, ktorú vidíte v zozname.

• Nastavte filtre tak, aby ste videli požadované zásielky (napr. konkrétne obdobie a krajinu).
• Kliknite na Export CSV — stiahne sa súbor so záznamami.
• Export obsahuje kľúčové stĺpce zo zoznamu (ID, referencia, tracking, status, dopravca, príjemca, COD, dátum vytvorenia), takže ho viete priamo otvoriť v Exceli alebo nahrať do účtovného systému.

3.2 Vytvorenie nového balíka

Nový balík vytvoríte kliknutím na tlačidlo + Nový balík v pravom hornom rohu zoznamu balíkov. Otvorí sa formulár, v ktorom vyplníte údaje o zásielke.

Krok za krokom

• Referencia (voliteľné) — vaše interné označenie, napríklad číslo objednávky.
• Dopravca * — vyberte prepravnú službu zo zoznamu dostupných pre cieľovú krajinu.
• Príjemca — Meno * a Firma (voliteľné).
• Ulica *, Mesto *, PSČ *, Krajina * — adresa doručenia (krajina je predvolene Slovensko, zmeníte ju v rozbaľovacom zozname).
• Telefón a Email (voliteľné, ale odporúčané) — dopravca podľa nich notifikuje príjemcu.
• Balík — Váha (kg) a rozmery Šírka / Výška / Dĺžka (cm).
• Dobierka — Suma a Mena, ak má príjemca platiť pri prevzatí. Ak nie je dobierka, ponechajte prázdne.
• Deklarovaná hodnota — Suma a Mena obsahu (dôležité najmä pri cezhraničných zásielkach).
• Poznámka (voliteľné) — interná poznámka k zásielke.

Povinné vs. voliteľné polia

Povinné sú polia označené hviezdičkou: Dopravca, Meno príjemcu, Ulica, Mesto, PSČ a Krajina. Ostatné polia sú voliteľné.

Výber dopravcu

V rozbaľovacom zozname Dopravca sa zobrazia tí dopravcovia, ktorých máte aktívnych pre danú cieľovú krajinu. Ak v zozname chýba dopravca, ktorého očakávate, skontrolujte krajinu doručenia alebo sa obráťte na svojho key account managera, aby vám príslušný cenník/dopravcu aktivoval (viď kapitola 4).

Čo sa stane po odoslaní

Po vyplnení formulára kliknite na Vytvoriť. Systém:

• založí balík a pridelí mu interné ID,
• pripraví ho na vytvorenie štítka (stav „Nový“ / „Štítok vytvorený“),
• po vytvorení štítka vám sprístupní tracking číslo a PDF štítok na tlač.

Tlačidlom Zrušiť formulár zatvoríte bez uloženia.

3.3 Detail balíka

Detail balíka otvoríte kliknutím na riadok v zozname. Je to kľúčová obrazovka, z ktorej riadite celý životný cyklus zásielky. V pravej hornej časti a v tele stránky nájdete šesť hlavných ovládacích prvkov, ktoré sme v obrázku označili číslami 1–6.

1 Tlačiť štítok (Vytvorenie štítka)

Vygeneruje PDF štítok pre balík. Použite ho, keď je zásielka v stave „Nový“ alebo „Čaká na štítok“. Po kliknutí systém vytvorí štítok priamo u dopravcu a vráti vám PDF na vytlačenie a nalepenie na balík.

2 Vyžiadať vratku

Spustí proces vrátenia balíka od zákazníka.

• Pre krajiny SK, CZ, HU, PL, HR, SI sa vrátka vytvorí automaticky cez portál Retino.
• Pre ostatné krajiny ju spracuje náš support tím manuálne.
• Vyplníte rozmery a hmotnosť, následne dostanete potvrdenie a tracking link pre vrátku.

3 Nahlásiť reklamáciu

Použite, ak so zásielkou nastal problém — poškodenie, strata alebo omeškanie. Otvorí sa formulár, v ktorom:

• popíšete problém,
• priložíte fotky,
• odošlete reklamáciu — náš support tím ju ďalej rieši priamo s dopravcom.

4 Tracking balíka

Otvorí externú sledovaciu stránku dopravcu (napr. GLS, DHL a pod.) v novej karte prehliadača. Vidíte tu priebeh zásielky priamo zo systému dopravcu. Na detaile balíka tomuto prvku zodpovedá odkaz s tracking číslom a tlačidlo „Tracking u dopravcu“.

5 Sledovanie zásielky (tracking)

Zobrazí časovú os všetkých udalostí balíka — od vytvorenia štítka cez prevzatie dopravcom až po doručenie. Každá zásielka môže počas svojho životného cyklu nadobudnúť jeden z nasledujúcich stavov:

Farebný prúžok vľavo naznačuje typ stavu: príprava · v pohybe · úspech · vrátka · problém.

6 Otvorenie vytlačeného štítka

Ak už bol štítok vytvorený, týmto tlačidlom („Otvoriť štítok“) otvoríte jeho PDF v novom okne — napríklad keď ho potrebujete znova vytlačiť.

V sekcii Cenníky vidíte prehľad cien dopravcov pre jednotlivé krajiny — koľko vás bude stáť preprava podľa hmotnosti, aké sú príplatky za dobierku a koľko stojí vrátka.

Štruktúra cenníkov

Cenníky sú organizované podľa krajiny a v rámci nej podľa dopravcu. Každý cenník je rozdelený do hmotnostných skupín (tarifných tried). Pri každej skupine vidíte:

• Hmotnostná kategória — rozsah hmotnosti (napr. Skupina 1: 0–3 kg, Skupina 2: 3–10 kg…).
• Cena — cena za zásielku v danom hmotnostnom pásme.
• Dobierka — príplatok za platbu pri prevzatí.
• Neprevzatý balík — cena pri neúspešnom doručení.
• Manuálna vratka — cena pri vrátení zo strany odosielateľa.

Aktívne vs. dostupné cenníky

Pri každej krajine sú dve sekcie:

• Vaše aktívne cenníky — tie môžete reálne používať pri vytváraní zásielok.
• Dostupné (neaktívne) cenníky — tvoria referenčný základ pre danú krajinu, ale na vašom účte zatiaľ nie sú aktívne. Pri neaktívnom cenníku sa zobrazujú referenčné základné ceny.

V hornej časti obrazovky vidíte aj súhrn: počet krajín, počet vašich aktívnych cenníkov a počet dostupných (neaktívnych) cenníkov.

Vaša zľava a individuálne ceny

Niektoré cenníky majú pri sebe označenie „vlastné kategórie“ alebo poznámku typu „Applied from proposal“. Znamená to, že ide o individuálne nastavenie pre váš účet — teda vaše dohodnuté (zvyčajne zvýhodnené) ceny, nie len referenčné základné ceny. Tieto vidíte v sekcii aktívnych cenníkov.

Vrátkové ceny a manuálne vrátky

Stĺpce Neprevzatý balík a Manuálna vratka ukazujú náklady spojené s neúspešným doručením alebo vrátením zásielky. Tieto ceny sa uplatnia, keď si zákazník balík neprevezme, alebo keď zásielku vraciate vy ako odosielateľ.

Export cenníkov

Stránka Cenníky slúži predovšetkým na prehliadanie cien priamo v paneli a samostatné tlačidlo na export do CSV tu momentálne nie je k dispozícii. Ak potrebujete cenník v elektronickej podobe (napr. pre internú kalkuláciu), požiadajte oň svojho key account managera, ktorý vám pošle aktuálnu verziu.

Dobierky (Cash on Delivery, skrátene COD/CoD) nájdete v menu pod Reporty → Týždenný CoD. Ide o prehľad vybraných dobierok za jednotlivé týždne, vrátane súm a dátumov spracovania.

Čo sú CoD reporty

CoD report zobrazuje všetky dobierkové zásielky za vybraný týždeň — koľko bolo od zákazníkov vybraté a kedy sa táto suma spracováva a preposiela. Reporty sú rozdelené per merchant a per obdobie (týždeň).

Ako sa dobierky zhromažďujú a kedy chodia

Dobierky vyzbierané dopravcom sa zhromažďujú a spracovávajú v týždenných cykloch. V reporte pri každom zázname vidíte tri dôležité dátumy:

• Dátum vyzbierania — kedy dopravca dobierku reálne vybral od zákazníka.
• Dátum zadania — kedy bola dobierka zadaná na spracovanie.
• Dátum fakturácie — kedy bola zaradená do fakturácie/preposlania.

Filtre a štruktúra tabuľky

Vpravo hore prepínate týždeň (napr. 2026-W21). Pod ním sú prehľadové dlaždice s celkovými sumami podľa meny — Celkom CZK, Celkom EUR, Celkom RON — vrátane počtu záznamov v každej mene.

Tabuľka záznamov obsahuje stĺpce:

• cod_id — identifikátor dobierky,
• Krajina, Dopravca, Mena, CarrierCode,
• Tracking, Referencia, CoD suma,
• Dátum vyzbierania, Dátum zadania, Dátum fakturácie,
• Číslo faktúry, Variabilný symbol.

Export dobierok

Vpravo hore vedľa výberu týždňa sú dve tlačidlá na stiahnutie reportu za zvolený týždeň:

• CSV — textový formát vhodný na import do účtovných systémov.
• XLSX — súbor pre Excel s rovnakými dátami v tabuľke.

Pri hromadnom stiahnutí viacerých súborov naraz ich systém môže zabaliť do jedného ZIP archívu. Postup je jednoduchý: vyberte týždeň, kliknite na CSV alebo XLSX a súbor sa stiahne.

Faktúry nájdete v menu pod Reporty → Mesačná fakturácia. Tu si stiahnete mesačné fakturačné dokumenty za prepravné a súvisiace služby.

Výber obdobia

V hornej časti zvolíte Mesiac a Rok. Po výbere sa nižšie zobrazí karta s faktúrami za dané obdobie, napríklad „Faktúry — Marec 2026“, aj s počtom faktúr.

Stiahnutie faktúry

Pri každom zázname vidíte stĺpce Merchant, Číslo faktúry, Suma a Vytvorené (dátum a čas vystavenia). V stĺpci Súbory sú dve tlačidlá:

• PDF — samotná faktúra na stiahnutie a archiváciu.
• XLSX — detailný rozpis položiek faktúry v Exceli.

Faktúry pokrývajú najmä prepravné a súvisiace služby; dobierkové sumy a ich párovanie nájdete v týždenných CoD reportoch (kapitola 5), kde sú prepojené cez číslo faktúry a variabilný symbol.

Stav úhrady a história platieb

Táto obrazovka slúži predovšetkým na stiahnutie fakturačných dokumentov za jednotlivé mesiace. Detailný stav úhrady konkrétnej faktúry (uhradená / neuhradená) a kompletnú históriu platieb nájdete v samotnom dokumente faktúry, prípadne vám ich potvrdí naše finančné oddelenie alebo key account manager.

Stránka Health Check ukazuje, či sú jednotlivé prepravné služby (a ich API rozhrania) momentálne funkčné. Využijete ju vtedy, keď máte podozrenie na výpadok u niektorého dopravcu — napríklad keď sa nedarí vytvoriť štítok.

Čo stránka zobrazuje

V hornej časti sú štyri prehľadové dlaždice:

• Služieb celkom — počet všetkých sledovaných služieb dopravcov.
• Funkčných — koľko z nich práve funguje.
• Výpadkov — koľko služieb má aktuálne výpadok.
• Priem. dostupnosť — priemerná dostupnosť všetkých služieb v percentách.

Pod nimi je vyhľadávanie (Hľadať službu alebo dopravcu…) a filtre podľa stavu a dopravcu, plus zoradenie (napr. výpadky prvé). Nižšie sú karty jednotlivých dopravcov.

Karta dopravcu

Každá karta obsahuje názov dopravcu s vlajkou krajiny, kódy konkrétnych služieb (napr. GLS-COURIER-SI, DHL-POINT-DE) a tri údaje:

• chýb — počet zaznamenaných chýb,
• posl. výpadok — ako dávno bol posledný výpadok (napr. „pred 1d“),
• trvanie — ako dlho trval posledný výpadok.

Ako interpretovať farby a ikony

Stavový odznak „OK“ hovorí o tom, či služba funguje práve teraz, kým farba a percento dostupnosti hodnotia jej spoľahlivosť za dlhšie obdobie. Služba teda môže byť aktuálne „OK“, hoci jej dlhodobá dostupnosť je nižšia.

Ako často sa dáta aktualizujú

Health Check sa obnovuje automaticky každú minútu a čas posledného obnovenia je uvedený vpravo hore (napr. „Posledný refresh: 01. 06. 2026 14:03“). Pre výklad metodiky kliknite na rozbaľovaciu časť „Ako funguje health check?“.

Aby sa vaša požiadavka vyriešila čo najrýchlejšie, kontaktujte priamo správny tím podľa povahy problému.