Balíkobot

Balíkobot

Rozšíření, které zajišťuje napojení na Balikobot, více zde.

Konfigurační soubor se standardně nachází v adresáři config/module-edeeshop/features/third-party/balikobot.xml.

Zkopírovat odkaz na sekciPříklad konfigurace

xml
1 <balikobot>2    <instances>3        <instance>4            <userName>balikobot_test2cztest</userName>5            <apiKey>someApiKey</apiKey>6            <code/>7            <eidPrefix/>8        </instance>9    </instances>10    <allowedShippings>11        <shipping>12            <type>PPL</type>13            <serviceTypes>14                <serviceType>15                    <serviceType/>16                    <shippingCode/>17                    <shippingType/>18                </serviceType>19            </serviceTypes>20        </shipping>21    </allowedShippings>22    <baseApiUrl>https://api.balikobot.cz/</baseApiUrl>23    <catalogSpecific>24        <catalogCode/>25        <instances>26            <instance>27                <userName>balikobot_test2cztest</userName>28                <apiKey>someApiKey</apiKey>29                <code/>30                <eidPrefix/>31            </instance>32        </instances>33        <allowedShippings>34            <shipping>35                <type>PPL</type>36                <serviceTypes>37                    <serviceType>38                        <serviceType/>39                        <shippingCode/>40                        <shippingType/>41                    </serviceType>42                </serviceTypes>43            </shipping>44        </allowedShippings>45    </catalogSpecific>46</balikobot>

Zkopírovat odkaz na sekciPopis

Zkopírovat odkaz na sekcibalikobot

Konfigurace integrace se systémem Balíkobot.

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
instances/instance

Seznam konfigurací pro jednotlivá napojení na Balíkobot.

Standardně postačí pouze jedna instance. Pokud ale existuje více expedičních míst, je potřeba definovat v rámci Balikobotu pro každé expediční místo vlastní instanci (účet). Z tohoto důvodu je možné definovat více instancí, které lze použít pro komunikaci s Balikobotem. Každá instance je pak identifikována svým kódem.

Projektově je pak možné určit, kterou instanci použít. Ve výchozím stavu se použije instance bez kódu.

List: instances/instance

-

-

allowedShippings/shipping

Seznam podporovaných doprav.

List: allowedShippings/shipping

-

-

baseApiUrl

Url, kde leží API Balíkobotu.

Tuto vlastnost nelze nastavit specificky pro konkrétní katalog. Více zde.

String

https://api.balikobot.cz/

catalogSpecific

Vlastnosti této konfigurace lze specifikovat pro konkrétní katalog. Více zde.

-

-

Zkopírovat odkaz na sekciinstances/instance

Seznam konfigurací pro jednotlivá napojení na Balíkobot.

Standardně postačí pouze jedna instance. Pokud ale existuje více expedičních míst, je potřeba definovat v rámci Balikobotu pro každé expediční místo vlastní instanci (účet). Z tohoto důvodu je možné definovat více instancí, které lze použít pro komunikaci s Balikobotem. Každá instance je pak identifikována svým kódem.

Projektově je pak možné určit, kterou instanci použít. Ve výchozím stavu se použije instance bez kódu.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
userName

Přihlašovací jméno do Balíkobot API.

Přihlašovací údaje se získají v klientské zóně – https://client.balikobot.cz)

String

-

apiKey

Přihlašovací klíč do Balíkobot API.

Přihlašovací údaje se získají v klientské zóně – https://client.balikobot.cz)

String

-

code

Kód instance v případě, že je v rámci katalogu více instancí.

Pokud je v rámci katalogu pouze jedna instance, je možné tento parametr vynechat.

String

-

-

eidPrefix

Prefix, který se odesílá jako součást eid.

String

-

-

Zkopírovat odkaz na sekciallowedShippings/shipping

Seznam podporovaných doprav.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
type

Typ dopravce v Balikobotu.

  • CP - Česká pošta s.p.
  • DHL - DHL Express
  • DHLSK - DHL Parcel Slovensko
  • DPD - Direct Parcel Distribution CZ s.r.o.
  • GEIS - Geis CZ s.r.o., Parcel i Cargo, CZ i SK verze
  • GLS - General Logistics Systems Czech Republic s.r.o.

Typ ShippingType.GLS_PICKUP_POINT vyžaduje nastavené této služby na v Balíkobotu na .

  • INTIME - IN TIME SPEDICE s.r.o.
  • PBH - Pošta bez hranic (Frogman s.r.o.)
  • PPL - PPL CZ s.r.o. – Parcel i Sprint
  • SP - Slovenská pošta a.s.
  • SPS - Slovak Parcel Service s.r.o.
  • TNT - TNT
  • TOPTRANS - TOPTRANS EU a.s.
  • ULOZENKA - Uloženka s.r.o.
  • UPS - UPS
  • ZASILKOVNA - Zásilkovna s.r.o.

-

serviceTypes/serviceType

Seznam typů služeb daného dopravce, které se odesílají do Balikobotu v atributu service_type.

Seznam je pro každého dopravce jiný, případně může být prázdný. Službu lze případně konkretizovat pro konkrétní dopravu (kód) nebo dle typu dopravy.

List: serviceTypes/serviceType

-

-

Zkopírovat odkaz na sekciserviceTypes/serviceType

Seznam typů služeb daného dopravce, které se odesílají do Balikobotu v atributu service_type.

Seznam je pro každého dopravce jiný, případně může být prázdný. Službu lze případně konkretizovat pro konkrétní dopravu (kód) nebo dle typu dopravy.

VlastnostPopisHodnotaPovinnáVýchozí hodnota
serviceType

Kód služby dopravce.

Povinná hodnota.

Seznam povolených hodnot pro jednotlivé dopravy je možné získat zde:

serviceType

-

shippingCode

Kód dopravy, pro který je služba určena. Pokud je null, pak je služba určena pro všechny dopravy.

String

-

-

shippingType

Typ dopravy, pro který je služba určena.

Pokud je null, pak je služba určena pro všechny typy doprav (dává smysl pokud je pouze jeden typ dopravy).

  • cPostPickupPoint - Česká pošta - Balík Na poštu
  • cPostBalikovna - Česká pošta - Balík do balíkovny
  • cPost - Česká pošta - Balík Do ruky
  • sPostPickupPoint - Slovenska pošta - Balík na poštu
  • sPostBalikobox - Slovenska pošta - Balík do BalíkoBOXu
  • sPost - Slovenska pošta - Balík na adresu
  • personalPickup - Osobní odběr bez výběru odběrného místa.
  • personalPickupAtPoint - Osobní odběr s výběrem odběrného místa
  • dpd - DPD
  • dpdPickupPoint - DPD Pickup Point
  • ppl - PPL
  • pplParcelShop - PPL ParcelShop
  • zasilkovna - Zásilkovna
  • zasilkovnaToAddress - Zásilkovna - doručení na adresu
  • geis - GEIS
  • gls - GLS
  • glsPickupPoint - GLS ShopDeliveryService
  • oneDelivery - One by Allegro - doručení na adresu (OneDelivery)
  • oneDeliveryPickupPoint - One by Allegro - výdejní místa (OneDelivery)
  • dbSchenker - DB Schenker
  • dhl - DHL
  • email - Typ dopravy, kdy není nutné dopravit zboží fyzicky, ale posílá se emailem
  • other - Jiný dopravce (např. doprava do zahraničí)

-

-

Zkopírovat odkaz na sekciserviceType

Kód služby dopravce.

Povinná hodnota.

Seznam povolených hodnot pro jednotlivé dopravy je možné získat zde: