Přeskočit na hlavní obsah

Datový Model a Architektura

Entity Diagram​

Klíčové Entity​

1. Dopravce (Carrier)​

Definuje konfiguraci konkrétního dopravce.

  • identifier: Název pro uživatele (např. "PPL Firemní").
  • responsibleShippingProvider: Technický driver (backend třída), který obsluhuje komunikaci (např. PPL, Zasilkovna).
  • trackingUrl: Šablona URL pro sledování.

2. Přepravní štítek (ShippingLabel)​

Představuje konkrétní balík/zásilku.

  • parcelId: Číslo zásilky u dopravce.
  • label: PDF soubor se štítkem.
  • orderStatus: Aktuální stav doručení (např. "Doručováno", "Uloženo na depu").
  • invoice, salesOrder, goodsIssue: Vazby na zdrojové doklady.

Architektura Integrace​

Integrace je postavena na vzoru Strategy.

Interface: Espo\Modules\ShippingProviders\Tools\Shipping\Provider

Každý podporovaný dopravce (PPL, Zásilkovna atd.) implementuje tento interface, který standardizuje metody:

  • createLabel(...): Odeslání dat dopravci.
  • getLabel(...): Stažení PDF.
  • track(...): Získání aktuálního stavu.

Factory: Espo\Modules\ShippingProviders\Tools\Shipping\ProviderFactory vybere správnou implementaci na základě pole responsibleShippingProvider v entitě Carrier.