Česká pošta API

Kompatibilita: CS-Cart 4.x
PHP: 5.4+
Autor: CSCart česky
Verze: 0.1

Pro koho je addon určen

• Provozujete e-shop na CS-Cartu
• Odesíláte zásilky přes Českou poštu nebo Balíkovnu
• Chcete šetřit čas při expedici, eliminovat ruční přepisování dat
• Potřebujete oficiální API napojení, ne poloviční řešení

Co vám addon přinese (hlavní přínosy)

• Úspora času při expedici – žádné přepisování adres do systémů ČP
• Méně chyb – data jdou do České pošty přímo z objednávky
• Pohodlí pro zákazníky – výběr Balíkovny přímo v košíku
• Vše na jednom místě – zásilky i tisk štítků přímo v administraci
• Připraveno pro růst e-shopu – zvládne desítky i stovky zásilek denně

Hlavní funkce addonu

• Automatické založení zásilky přes API České pošty

• Tisk štítků (PDF / ZPL) přímo z administrace

• Plná podpora Balíkovny (výběr pobočky zákazníkem)

• Podpora služeb:

  • Balík Do ruky
  • Balík Na poštu
  • Balíkovna

• Dobírka (COD) – automaticky rozpoznaná z platební metody

• Podpora doplňkových služeb:

  • Cenný obsah
  • Nestandardní rozměry

• Automatická změna stavu objednávky po založení zásilky

• Testovací i produkční režim

• Synchronizace aktuálního seznamu poboček Balíkovny

Jak addon funguje v praxi

1️⃣ Zákazník vytvoří objednávku

• Vybere běžnou dopravu nebo Balíkovnu
• U Balíkovny si zvolí konkrétní výdejní místo
• Vše probíhá přímo v checkoutu – bez přesměrování

2️⃣ Objednávka čeká na expedici

• Objednávka se vytvoří standardně
• Zásilka se nezaloží automaticky
  (máte plnou kontrolu nad expedicí)

3️⃣ Založení zásilky jedním klikem

V detailu objednávky:

• zadáte hmotnost a případné doplňkové služby

• kliknete na „Založit zásilku“

• addon:

  • odešle data do České pošty
  • uloží číslo zásilky
  • změní stav objednávky

4️⃣ Tisk štítků

• Vyberete jednu nebo více objednávek
• Kliknete na „Vytisknout štítky Česká pošta“
• Okamžitě se stáhne PDF se štítky

Podporované služby České pošty

Základní produkty

• Balík Do ruky – doručení na adresu
• Balík Na poštu – vyzvednutí na poště
• Balíkovna – výdejní místo / box

Doplňkové služby

• Dobírka (COD)
• Cenný obsah
• Nestandardní rozměry

Jednoduchá konfigurace

Nastavení dopravy

V administraci CS-Cartu pouze:

• zvolíte typ služby (Do ruky / Na poštu / Balíkovna)
• vložíte API přihlašovací údaje od České pošty
• zvolíte testovací nebo ostrý režim

Nastavení dobírky

• u platební metody pouze označíte, že jde o dobírku
• addon ji automaticky použije při zakládání zásilky

Bezpečnost a spolehlivost

• Oficiální API České pošty
• Komunikace přes HTTPS
• Ošetřené chybové stavy a duplicity
• Zásilku nelze omylem založit dvakrát

Omezení (transparentně)

• Multi-shipping objednávky nejsou plně podporovány
• Tracking číslo se nepřenáší automaticky do notifikací
• Synchronizaci poboček Balíkovny je nutné občas spustit ručně

Technické informace (pro pokročilé)

Addon:

• využívá Composer knihovny (součást balíčku)
• ukládá data o zásilkách do vlastní tabulky
• pracuje s CS-Cart hooky (update_shipping, get_order_info)
• je připraven pro další rozšiřování

(Detailní technická dokumentace může být součástí README / podpory.)

Podpora a aktualizace

• Web: https://cs-cart.cz
• E-mail: [email protected]
• Aktivní vývoj a možnost úprav na míru

Licence

Komerční addon – vytvořeno společností CSCart česky