# Podací a výdejní místo

Při [hromadném importu objednávek](/integrations/hromadny-import-objednavek) určujete v souboru
oba konce cesty zásilky. U každého z nich volíte mezi adresou a místem konkrétního dopravce:

- **Svozová adresa** — kurýr přijede pro zásilku na adresu odesílatele. Adresu určuje pole
  `from_address_id` s ID svozové adresy z Manažeru zásilek, případně výchozí adresa odesílatele
  integrace.
- **Podací místo** — zásilku se štítkem odnesete sami na pobočku nebo do boxu dopravce.
  Konkrétní místo určuje pole `pickup_branch_code`.
- **Adresa příjemce** — kurýr doručí zásilku na adresu z polí `to_*`.
- **Výdejní místo** — příjemce si zásilku vyzvedne na pobočce nebo v boxu dopravce. Konkrétní
  místo určuje pole `delivery_branch_code`, nejbližší místo vybere pole
  `auto_delivery_branch_location`.

<figure className="my-6 mx-auto max-w-lg">
  <svg
    viewBox="0 0 520 560"
    role="img"
    aria-label="Schéma cesty zásilky: odesílatel předá zásilku buď kurýrovi na svozové adrese, nebo na podacím místě; dopravce ji doručí buď na adresu příjemce, nebo na výdejní místo."
    className="w-full h-auto text-foreground"
    fontFamily="inherit"
  >
    <defs>
      <marker id="import-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
        <path d="M 0 0 L 10 5 L 0 10 z" fill="currentColor" />
      </marker>
    </defs>

    <rect x="185" y="10" width="150" height="44" rx="22" fill="currentColor" fillOpacity="0.08" stroke="currentColor" strokeWidth="1.5" />
    <text x="260" y="38" textAnchor="middle" fontSize="16" fontWeight="600" fill="currentColor">Odesílatel</text>

    <rect x="10" y="100" width="222" height="120" rx="12" fill="none" stroke="currentColor" strokeWidth="1.5" />
    <text x="121" y="128" textAnchor="middle" fontSize="15" fontWeight="600" fill="currentColor">Svozová adresa</text>
    <text x="121" y="152" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">Kurýr vyzvedne zásilku</text>
    <text x="121" y="169" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">na vaší adrese.</text>
    <text x="121" y="200" textAnchor="middle" fontSize="12" fontFamily="ui-monospace, monospace" fill="currentColor">from_address_id</text>

    <text x="260" y="165" textAnchor="middle" fontSize="12" fontStyle="italic" fill="currentColor" fillOpacity="0.6">nebo</text>

    <rect x="288" y="100" width="222" height="120" rx="12" fill="none" stroke="currentColor" strokeWidth="1.5" strokeDasharray="6 4" />
    <text x="399" y="128" textAnchor="middle" fontSize="15" fontWeight="600" fill="currentColor">Podací místo</text>
    <text x="399" y="152" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">Zásilku odnesete na pobočku</text>
    <text x="399" y="169" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">nebo do boxu dopravce.</text>
    <text x="399" y="200" textAnchor="middle" fontSize="12" fontFamily="ui-monospace, monospace" fill="currentColor">pickup_branch_code</text>

    <rect x="185" y="265" width="150" height="44" rx="22" fill="currentColor" fillOpacity="0.08" stroke="currentColor" strokeWidth="1.5" />
    <text x="260" y="293" textAnchor="middle" fontSize="16" fontWeight="600" fill="currentColor">Dopravce</text>

    <rect x="10" y="355" width="222" height="120" rx="12" fill="none" stroke="currentColor" strokeWidth="1.5" />
    <text x="121" y="383" textAnchor="middle" fontSize="15" fontWeight="600" fill="currentColor">Adresa příjemce</text>
    <text x="121" y="407" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">Kurýr doručí zásilku</text>
    <text x="121" y="424" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">až ke dveřím.</text>
    <text x="121" y="455" textAnchor="middle" fontSize="12" fontFamily="ui-monospace, monospace" fill="currentColor">to_*</text>

    <text x="260" y="420" textAnchor="middle" fontSize="12" fontStyle="italic" fill="currentColor" fillOpacity="0.6">nebo</text>

    <rect x="288" y="355" width="222" height="120" rx="12" fill="none" stroke="currentColor" strokeWidth="1.5" strokeDasharray="6 4" />
    <text x="399" y="383" textAnchor="middle" fontSize="15" fontWeight="600" fill="currentColor">Výdejní místo</text>
    <text x="399" y="407" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">Příjemce si zásilku vyzvedne</text>
    <text x="399" y="424" textAnchor="middle" fontSize="12" fill="currentColor" fillOpacity="0.8">na pobočce nebo v boxu.</text>
    <text x="399" y="455" textAnchor="middle" fontSize="12" fontFamily="ui-monospace, monospace" fill="currentColor">delivery_branch_code</text>

    <rect x="185" y="510" width="150" height="44" rx="22" fill="currentColor" fillOpacity="0.08" stroke="currentColor" strokeWidth="1.5" />
    <text x="260" y="538" textAnchor="middle" fontSize="16" fontWeight="600" fill="currentColor">Příjemce</text>

    <g fill="none" stroke="currentColor" strokeWidth="1.5" markerEnd="url(#import-arrow)">
      <path d="M 240 54 C 240 80, 121 70, 121 100" />
      <path d="M 280 54 C 280 80, 399 70, 399 100" />
      <path d="M 121 220 C 121 250, 240 240, 240 265" />
      <path d="M 399 220 C 399 250, 280 240, 280 265" />
      <path d="M 240 309 C 240 335, 121 325, 121 355" />
      <path d="M 280 309 C 280 335, 399 325, 399 355" />
      <path d="M 121 475 C 121 505, 240 495, 240 510" />
      <path d="M 399 475 C 399 505, 280 495, 280 510" />
    </g>
  </svg>
</figure>

<span className="text-muted-foreground">_Cesta zásilky: plná čára = adresa, čárkovaná = místo dopravce. Obě strany lze kombinovat libovolně._</span>

## Jak zadat jednotlivé varianty

| Chcete | Co zadat v souboru |
| --- | --- |
| Kurýr vyzvedne zásilku na adrese odesílatele | Pole `from_address_id` s ID svozové adresy ([Svozy → Svozové adresy](/mz/svozy#svozové-adresy)). Pole `from_*` a `pickup_branch_code` nevyplňujte. |
| Podání na libovolném podacím místě dopravce | U integrace zapněte přepínač **Zásilky vytvářet s předáním na podacím místě** (viz [Nastavení importu](/integrations/hromadny-import-objednavek#nastavení-importu-v-manažeru-zásilek)). Platí pro všechny řádky souboru. Pokud máte v Nastavení → Šablony nastavené **Výchozí podací místo** daného dopravce, použije se ono. |
| Podání na konkrétním podacím místě | `carrier` + `pickup_branch_code`. Místo musí podporovat podání zásilek (v číselníku míst příznak `is_collection`). |
| Doručení na adresu příjemce | Pole `to_*`. Pole `delivery_branch_code` nevyplňujte. |
| Doručení na konkrétní výdejní místo nebo box | `carrier` + `delivery_branch_code`. |
| Doručení na nejbližší výdejní místo k adrese příjemce | `auto_delivery_branch_location` = `1`. S polem `carrier` se vybírá jen z míst daného dopravce. |

:::warning[Zásilkovna a Balíkovna vždy z podacího místa]

Zásilky dopravců **Zásilkovna** a **Balíkovna** import vždy vytvoří s podáním na podacím
místě, protože tito dopravci zásilky na adrese odesílatele nevyzvedávají. Bez
`pickup_branch_code` můžete zásilku podat na libovolné pobočce dopravce, případně se použije
vaše výchozí podací místo.

:::

## Kde získat kód místa

Kód místa (`pickup_branch_code`, `delivery_branch_code`) je kód, pod kterým místo vede daný
dopravce. Kód je jedinečný pouze v rámci dopravce, proto je nutné vždy vyplnit i pole `carrier`.
Podací i výdejní místo v jednom řádku musí patřit stejnému dopravci.

- Číselník míst: veřejný endpoint [`GET /parcelpoints/list`](/api-v1/podaci-a-vydejni-mista)
  vrací všechna místa včetně kódu (`code`) a příznaků `is_collection` (lze zde podat zásilku)
  a `is_locker` (box). Volat ho můžete bez API klíče, filtrovat lze podle země a dopravce.
- [Mapový widget](/map_widget) vrací po výběru místa na mapě stejný objekt včetně kódu.

Formát kódu se liší podle dopravce. Příklady odpovídají stavu číselníku v době psaní tohoto
návodu, před použitím si je ověřte v číselníku:

| Dopravce (`carrier`) | Podoba kódu | Příklad | Místo z příkladu |
| --- | --- | --- | --- |
| `zasilkovna` | číselné ID pobočky nebo Z-BOXu | `4835` | Alfamobil, Poštovská 455/8, Brno |
| `ppl` | `KM` + číslice | `KM11460200` | AKVARIUS, Novobranská 532/20, Brno |
| `dpd` | `CZ` + číslice | `CZ10913` | Allwyn – GAHO vinotéky, Charbulova 831/30, Brno |
| `gls` | `CZ` + PSČ + `-` + označení | `CZ61500-PSHOP002` | Apokryf knihy, Stará Osada 15, Brno |
| `balikovna` | číselný kód pobočky | `60100` | Brno 1, Šumavská 519/35, Brno |

:::note

Boxy (AlzaBox, PPL Parcelbox, DPD box) slouží u většiny dopravců pouze k doručení a nelze
na nich zásilku podat. V číselníku míst je poznáte podle `is_locker: 1` a `is_collection: false`.

:::

:::tip[Hotové příklady]

Hotové importní soubory pro jednotlivé varianty — zásilku ze svozové adresy, z podacího místa
na výdejní místo a zásilku se Zásilkovnou — najdete na stránce
[Příklady importních souborů](/integrations/hromadny-import-objednavek/priklady).

:::