Česká pošta - Online podání - CSV + API export
Zajistěte přenos sledovacích čísel z Vašeho PrestaShopu do administračního rozhraní dopravce Česká pošta. Pomocí CSV souboru přenesete data o objednávkách přímo do online podání dopravce, abyste nemuseli opisovat údaje ručně (jméno, adresa, ulice, psč, ...). Tento modul je součástí výhodného balíčku "Online podání" - doporučujeme. Nově od 2025 modul umí i API napojení (nAPI).
- Podpora + aktualizace zdarma 12 měsíců (poté 50% sleva)
- Pokud chcete modul expresně, žašleme ho oproti potvrzení o platbě
- 1 licence = 1 doména, viz licenční podmínky
- Máte s modulem problém? Prosíme, napište e-mail
- Ceny jsou konečné, nejsme plátci DPH
- Dominik Shaim Ulrich je oficiálním členem týmu PrestaShop Committers.
Popis
Zajistěte efektivní přenos sledovacích čísel z Vašeho PrestaShopu přímo do administračního rozhraní dopravce Česká pošta. Tento modul umožňuje přenos dat o objednávkách pomocí CSV souboru, což výrazně zjednodušuje proces a eliminuje nutnost ručního zadávání údajů (jméno, adresa, ulice, PSČ atd.). Modul je součástí výhodného balíčku "Online podání", který doporučujeme. Od roku 2025 modul nově podporuje také API napojení (nAPI).
Funkce modulu
- Export zásilek do aplikace ve formátu CSV.
- Obousměrné API (nAPI) pro přenos sledovacích čísel a tisk štítků přímo z administrace PrestaShopu.
- Import všech zvolených dat z objednávek, což šetří čas při ručním vypisování adres.
- Možnost filtrovat zásilky dle data a stavu objednávky.
- Podpora více měn, automatická konverze do výchozí měny.
Výhodný balíček
Pokud máte více dopravců, doporučujeme zakoupit modul ve výhodném balíčku, který zahrnuje online podání pro více dopravců. Tento balíček nabízí výrazně výhodnější cenu. Aktuálně je k dispozici podpora pro následující dopravce:
- Česká pošta
- DPD
- GLS
- PPL
- Slovenská pošta
- Toptrans
- WeDo
Automatické přiřazení typu zásilky
Modul umožňuje vybrat typ zásilky (RR, DR, NP, BA, NB, EM, O, VL, VV) a při správném pojmenování dopravců se typ zásilky automaticky označí při exportu bez nutnosti ručního výběru. Například:
- Pokud v názvu dopravce naleznete "do ruky", automaticky se zvolí typ "DR".
- Pokud v názvu dopravce naleznete "doporučená zásilka", automaticky se zvolí typ "RR".
Toto automatické zvolení typu služby lze v modulu libovolně upravit, což šetří čas při manuálních úpravách.
Možnosti doručení
Modul spolupracuje s novinkou České pošty, která umožňuje zvolit čas doručení (dopoledne nebo odpoledne). Dále máte možnost zvolit, zda chcete zásilku poslat křehce nebo zda má být pojištěna (v reálné výši zásilky). Podporuje také volbu velikosti zásilky (S / M / L / XL) a ekonomické doručení (1K).
Modul automaticky zvolí správnou službu i pro zahraniční zásilky. Například, pokud máte zásilku do Maďarska, modul automaticky rozpozná, že se jedná o zahraniční doručení a zvolí příslušnou službu.
Struktura CSV pro Českou poštu
Výsledný CSV feed obsahuje následující strukturu:
- Firma/Celé jméno
- Ulice
- Obec
- PSČ
- Variabilní symbol
- Mobil
- Dobírka
- Zásilka
- Vícekus VK
- Pojištění (udaná cena)
- Hmotnost
- Služby
- Jméno
- Příjmení
- IČ
- DIČ
- Stát
- Poznámka
- Datum narození
- Subjekt
- Stát (u USA apod)
- Měna
Oddělovač sloupců v CSV je středník (;) a kódování souboru je UTF-8.
Ukázka nastavení šablony v CSV v ČP (nová verze webové aplikace ČP)
Ukázka nastavení šablony v CSV v ČP (stará verze webové aplikace ČP)
Podpora a další moduly
Modul lze kombinovat s dalšími moduly pro přenos sledovacích čísel z Online podání do PrestaShopu a pro automatické sledování pohybu balíku. Pro více informací navštivte následující odkazy:
Pokud budete potřebovat pomoc s nastavením šablony, neváhejte mě kontaktovat. Po předchozí domluvě je možné strukturu CSV upravit dle Vašich potřeb.
Automatické sledování zásilek a práce s online podáním u dopravců - informace
- Aktuální funkce modulu jsou viditelné na demo verzi níže, kde je vždy aktuální verze modulu.
- Moduly se vylepšují průběžně. Drobné úpravy v kódu apod. nemusí být v changelogu uváděny.
- Z důvodu nových funkcí, oprav, stability a bezpečnosti je vždy vhodné mít poslední verzi modulu.
- V případě, že byste měli jakékoliv dotazy napište e-mail.
Technické informace a kompatibilita
| PrestaShop 9.x | |
| PrestaShop 8.x | |
| PrestaShop 1.7 | |
| PrestaShop 1.6 | |
| Multistore | |
| Rychlý přístup | ano (Tuto volbu naleznete v administraci PS úplně nahoře vlevo, vedle loga PrestaShopu) |
| Levé menu v BO | ano (Přidá odkaz na modul do levého menu v administraci) |
| PHP | 7.0 - 8.5 |
| Jazyk modulu | CZ + SK + EN + GB |
| Datum vystavení | 19. 6. 2015 |
| Poslední aktualizace popisu | 8. 12. 2025 |
| Verze modulu | 2.6.0 (1. 1. 2026) |
| Název modulu na FTP | shaim_online_podani_cp |
| Kód produktu | CESKA_POSTA_ONLINE_PODANI |
| Autor | Dominik Shaim Ulrich |
| DEMO verze | ano (viz níže) |
Související moduly
Česká pošta - Balík Do ruky - výběr dodání (dopolední / odpolední)
Informace o ceně v detailu.
Česká pošta - Balík Na poštu - výběr odběrného místa přímo v objednávce (CZ)
Informace o ceně v detailu.
Demo modulu
PS verze 9.x
PS verze 8.x
PS verze 1.7
PS verze 1.6
Video (detailní ukázka fungování)
Video bylo natočeno při vydání modulu, nemusí být tedy již plně aktuální, jelikož mohlo dojít ke změnám / aktualizacím v modulu apod.Changelog
- pouze technické přečíslování modulu pro nový rok 2026, kvůli přehlednosti pro naši podporu (update není třeba provádět)
- kompatibilita s PHP 8.5
- pro ČP doplněna nativní podpora pro vícekusovou zásilku přes API (limit 30kg)
- opravena situace, kdy nastavení "Po nahrání zásilky odeslat e-mail se sledovacím číslem zákazníkovi (stejný jako kdybyste zadali sledovací číslo ručně přímo v objednávce)" nešlo vypnout (pouze u API napojení)
- přidání historie štítků z API do administrace
- doplnění volitelné nastavení pro API přenos - "Po nahrání zásilky odeslat e-mail se sledovacím číslem zákazníkovi (stejný jako kdybyste zadali sledovací číslo ručně přímo v objednávce)"
- doplněna možnost volby zásilky "DE" (adresné doručení s doplňkovou službou garantovaný čas dodání v pracovní dny a v sobotu (doručení D+1). K ceně přepravy se přičítá ještě 60 Kč s DPH za doplňkovou službu.)
- do API modulu doplněny proměnné {followup} a {shipping_number}, díky kterým můžete sledovací číslo propsat při změně stavu do libovolného e-mailu, pokud si upravíte e-mail šablonu
- přidána možnost opakovat dotaz na stávky stejné dávky v případě, že dávka nebyla vyhotovena do 60 sekund ze strany API napojení dopravce ČP
- rozšířené interní API logování pro potřeby vývojáře modulu v případě řešení nějakých potíží apod
- vyřešena situace kdy si zákazník objedná balíček do práce, tzn, aby došlo k přenosu obou údajů - jak firmy, tak jméno osoby
- opravena chyba, kdy se nemusel ukládat filtr "řadit dle"
- do ČP API doplněno číslo objednávky na štítek
- ČP API oprava exportu Balíkovny
- u ČP opraveno nastavení F/P (fyzická vs právnická osoba), dle toho se řídí zobrazení údajů na štítku
- oprava chyby, kdy při zapnutém kompaktním módu mohla chybět tlačítka pro export
- u Balíkovny na adresu změněno defaultní označení z "ND" na "DR" a to proto, že "ND" je pro retailové klienty a 99% uživatelů bude Balíkovnu na adresu posílat nově jako DR
- nastavení "API - pozice štítků" bylo na základě opakovaných žádostí zobrazeno i při zapnutém kompaktním módu, abyste si mohli měnit údaje dle toho, jaký arch papíru zrovna máte k dispozici, respektive, na jakou pozici potřebujete začít tisknout štítky na archu
- doplněna možnost používat API napojení dopravce ČP. Tzn. modul má nyní k dispozici 2 možnosti formátu exportu (CSV + API). Pokud budete používat API napojení, již nepotřebujete poté modul "Přenos sledovacích čísel do Presty", jelikož toto automaticky přenese do PrestaShopu právě zmíněná API. Jedná se tedy o obousměrné napojení. Součástí API napojení je i tisk štítků přímo z PS
- úprava aby došlo k řazení při podávání na dopravce ve stejném pořadí jako jsou zásilky seřazené přímo v administraci modulu
- technické přečíslování modulu pro nový rok 2025, kvůli přehlednosti pro naši podporu
- otestována funkčnost s PS 9
- vylepšen výkon modulu, optimalizovaný kód, odstranění starého již nepoužívaného kódu
- více menších úprav a oprav
- ČP - odstranění volby "NP" - Balík na poštu od 1. 1. 2025 ČP ruší a již nebude možno přes něj podat zásilky. To samé se týká typu "EE"
- doplněno nové nastavení "Defaultní stav rozmezí dat" pro lepší filtrování při vstupu do moulu
- doplněno nové nastavení "Defaultní stav checkboxu" pro lepší fungování po vstupu do modulu, jelikož někdo chce mít automaticky vše zaškrtnuté a jiný zase odškrtnuté
- přidán nový filtr pro rozmezí dat "Dnes a včera"
- v nové verzi PS9 zmizela konstanta "ALL_CARRIERS", je nutno to v modulu zohlednit pro správné fungování v PS9
- zohledněna situace, kdy došlo 1. 7. 2024 ke změně na straně České Pošty a Balíkovny, kdy nyní probíhá doručování přes službu "Balíkovna na adresu", tak aby nedocházelo k vyhodnocení, že dopravce "Balíkovna" je pouze na odběrné místo. (týká se pouze těch e-shopů co využívají Balíkovnu)
- přidán nový typ zásilky - ND (Balíkovna na adresu)
- další drobné úpravy
- pouze technické přečíslování modulu pro nový rok 2024, kvůli přehlednosti pro naši podporu (update není třeba provádět)
- přípravy modulu na PS 9.x
- ukládání informací potřebných pro fungování modulu bylo přesunuto do samostatné tabulky jako příprava na PrestaShop 9.0
- upraven vzhled administrace modulu, aby byl více přehledný a kompaktní
- drobné úpravy
- doplněna podpora pro napárování do nového online podání ČP
- další drobné úpravy
- pro Českou Poštu přidán do CSV exportu nový sloupec (pozice v CSV "23"), který uvádí měnu objednávky. Je možno tedy napárovat i cizí měny pro online podání ČP
- drobné úpravy
- přidána možnost volby zásilky "VD" pro Českou poštu. Respektive, stačí zvolit balík "V" a pokud tam bude dobírka, automaticky se propíše "VD"
- drobné úpravy
- doplněna podpora pro PrestaShop 8.0+ a PHP 8.0/8.1/8.2
- technické přečíslování pro nový rok 2023, kvůli přehlednosti
- moduly prověřeny utilitou PHPStan až do levelu 5, odstraněny nekompatibility a opravy datových typů. Tato utilitka je mezi programátory velmi známá a používá se zejména pro optimalizaci kódu, odstranění nepoužívaných částí kódu, apod)
- kompletní revize modulu (odstranění starého nepotřebného kódu, výměna za novější řešení, optimalizace rychlosti modulu, doplněny překladové stringy a mnoho dalšího -> generální každoroční údržba :))
- kromě rychlého přístupu byl modul přidán také do levého menu v administraci pro větší variabilitu
- více menších úprav a optimalizací
- zohledněno zaokrouhlování dle SK legislativy (EUR) od 1. 7. 2022
- zdroj:
- https://www.opytajsauctovnika.sk/zaokruhlovanie-platieb-bude-od-01-07-2022-realitou/
Množstevní slevy
| Počet | Sleva |
|---|---|
| 2 ks a více | 15% |
| 5 ks a více | 30% |
Proč nakupovat na PSModuly.cz
- Letité zkušenosti s PS již od roku 2012.
- Vždy plně aktuální moduly dle poslední specifikace.
- Obrovský výběr modulů, možnost mít většinu modulů od jednoho vývojáře.
- Plná podpora samotného vývojáře, který své moduly zná a sám je psal.
- Nárok na podporu a aktualizace zdarma je 12 měsíců od data zakoupení.
- Samotná licence modulů není časově omezena.
- Sleva na aktualizace modulů 50%.
- Dominik Shaim Ulrich je oficiálním členem týmu PrestaShop Committers.
Více než 170
PS modulů
Na trhu
od 2012
Aktualizace
12 měsíců
Podpora
vývojáře
Hodnocení od zákazníků (5)
Komentáře mohou udělovat pouze registrování zákazníci, kteří produkt reálně koupili a to v sekci "Můj účet".
Komentáře prochází schvalovacím procesem, který provádí administrátor e-shopu.
Modul používám denně a zatím mě nezradil – což se o České poště říct nedá . Rychlá reakce autorů na technické dotazy a bezproblémové fungování tohoto i mnoha dalších modulů. Doporučuji.
vše funguje, jak má! Spokojenost a mohu doporučit.
počáteční nastavení byl trochu boj, ale funguje skvěle
TOP podpora i modul, výrazně urychluje a zjednodušuje práci, 100% doporučuji!
Modul funguje dobře, je přehledný, technická podpora funguje rychle a ochotně. Doporučuji.