Branch export version 3

WARNING: This version of export is outdated. Please consider using latest version.

XML/JSON

The feed contains data about all the currently open branches. You can access the feed via following URLs:

https://www.zasilkovna.cz/api/v3/__API_KEY__/branch.xml
https://www.zasilkovna.cz/api/v3/__API_KEY__/branch.json

You can find the XML export's schema here:

https://www.zasilkovna.cz/api/v3/__API_KEY__/branch.xsd

CSV

You can also download a simplified CSV export which contains only basic fields. You can access it via following URL:

https://www.zasilkovna.cz/api/v3/__API_KEY__/branch.csv

Address delivery

The above exports only include standard branches, since they are primarily used to generate a list of options for the end user to pick from. However, if you wish to use our services for address delivery, whether just in the Czech Republic or in other countries as well, you will need to download a list of address delivery options.

Address delivery option is represented by a branch entry and is also treated like one when creating a packet entry in our system. You just use its ID as you would with a standard branch.

You can access the address delivery options using URL parameter type=address-delivery like this:

https://www.zasilkovna.cz/api/v3/API_KEY/branch.xml?type=address-delivery

NOTE: You can also use the parameter for the other export formats.

Export specification

<export xmlns="http://www.zasilkovna.cz/api/v3/branch" xmlns:ns="http://www.zasilkovna.cz/api/v3/branch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.zasilkovna.cz/api/v3/branch http://www.zasilkovna.cz/api/v3/branch.xsd">
    <contacts>
        <contact>
            <country>cz</country>
            <phone>+420 216 216 516</phone>
            <email>[email protected]</email>
            <businessHours>Po-Pá 08:00 – 20:00 hod.</businessHours>
        </contact>
    </contacts>
    <branches>
        <branch>
            <id>000</id>
            <name>Test Branch</name>
            <nameStreet>Test Branch, Prague, Teststreet 15</nameStreet>
            <special>The branch is situated right next to a giant purple chicken.</special> <!-- OPTIONAL -->
            <place>Zásilkovna s.r.o.</place>
            <street>Teststreet 15</street>
            <city>Prague</city>
            <zip>123 45</zip>
            <country>cz</country>
            <currency>CZK</currency>
            <exportedUntil>2016-09-16</exportedUntil> <!-- OPTIONAL -->
            <enterableUntil>2016-09-20</enterableUntil> <!-- OPTIONAL -->
            <openUntil>2016-09-30</openUntil> <!-- OPTIONAL -->
            <openSince>2016-07-01</openSince> <!-- OPTIONAL -->
            <wheelchairAccessible>no</wheelchairAccessible>
            <directions><p>Just go straight ahead.</p></directions> <!-- OPTIONAL -->
            <directionsCar><p>Just drive straight ahead.</p></directionsCar> <!-- OPTIONAL -->
            <directionsPublic><p>Get on a bus and exit on Terminal station.</p></directionsPublic> <!-- OPTIONAL -->
            <latitude>76.54321</latitude>
            <longitude>12.34567</longitude>
            <url>http://www.zasilkovna.cz/pobocky/test-branch</url>
            <dressingRoom>0</dressingRoom>
            <claimAssistant>1</claimAssistant>
            <packetConsignment>1</packetConsignment>
            <maxWeight>5</maxWeight>
            <holidayStart>2016-07-29</holidayStart> <!-- OPTIONAL -->
            <holidayEnd>2016-08-04</holidayEnd> <!-- OPTIONAL -->
            <noticeMessage>The branch is closed due to holiday.</noticeMessage> <!-- OPTIONAL -->
            <region>Hlavní město Praha</region>
            <district>Hlavní město Praha</district>
            <labelRouting>A--0--000</labelRouting>
            <labelName>Test Branch</labelName>
            <photos>
                <photo>
                    <thumbnail>http://www.zasilkovna.cz/images/branch/thumb/stub.jpg</thumbnail>
                    <normal>http://www.zasilkovna.cz/images/branch/normal/stub.jpg</normal>
                </photo>
            </photos>
            <openingHours>
                <compactShort><strong>Po–Pá</strong> 09:00–16:30</compactShort>
                <compactLong><strong>Po–Pá</strong> 09:00–16:30</compactLong>
                <tableLong>
                    <table class='packetery-hours'><tr><th>Po</th><td>09:00–16:30</td></tr> <tr><th>Út</th><td>09:00–16:30</td></tr> <tr><th>St</th><td>09:00–16:30</td></tr> <tr><th>Čt</th><td>09:00–16:30</td></tr> <tr><th>Pá</th><td>09:00–16:30</td></tr> <tr><th>So</th><td></td></tr> <tr><th>Ne</th><td></td></tr></table>
                </tableLong>
                <regular>
                    <monday>09:00–16:30</monday>
                    <tuesday>09:00–16:30</tuesday>
                    <wednesday>09:00–16:30</wednesday>
                    <thursday>09:00–16:30</thursday>
                    <friday>09:00–16:30</friday>
                    <saturday/>
                    <sunday/>
                </regular>
                <upcoming>
                    <monday>09:00–18:00</monday>
                    <tuesday>09:00–18:00</tuesday>
                    <wednesday>09:00–18:00</wednesday>
                    <thursday>09:00–18:00</thursday>
                    <friday>09:00–18:00</friday>
                    <saturday/>
                    <sunday/>
                    <startDate>2016-08-03</startDate>
                </upcoming>
                <exceptions>
                    <exception> <!-- OPTIONAL -->
                        <date>2016-08-02</date>
                        <hours>10:00–13:30, 16:00–17:30</hours> <!-- OPTIONAL -->
                    </exception>
                </exceptions>
            </openingHours>
        </branch>
    </branches>
</export>

<export>

Root element of the document

<export xmlns="http://www.zasilkovna.cz/api/v3/branch" xmlns:ns="http://www.zasilkovna.cz/api/v3/branch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.zasilkovna.cz/api/v3/branch http://www.zasilkovna.cz/api/v3/branch.xsd">
    <contacts>
        See documentation for "<contacts>" element
    </contacts>
    <branches>
        See documentation for "<branches>" element
    </branches>
</export>
Name Type Description
contacts Container Container for <contact> elements.
branches Container Container for <branch> elements.

<contacts>

Contained exactly once by <export>.

Contains contacts for customer support for all countries.

<contacts>
    <contact>
        See documentation for "<contact>" element
    </contact>
</contacts>

<contact>

Contained one or many times by <contacts>.

Contains basic information about customer support for each country.

<contact>
    <country>cz</country>
    <phone>+420 216 216 516</phone>
    <email>[email protected]</email>
    <businessHours>Po-Pá 08:00 – 20:00 hod.</businessHours>
</contact>
Name Type Description
country String Country code of the customer support's country.
phone String Phone number of the customer support.
email String Email of the customer support.
businessHours String Customer support business hours.

<branches>

Contained exactly once by <export>.

<branches>
    <branch>
        See documentation for "<branch>" element
    </branch>
</branches>

<branch>

Contained many times by <branches>.

Represents a branch.

<branch>
    <id>000</id>
    <name>Test Branch</name>
    <nameStreet>Test Branch, Prague, Teststreet 15</nameStreet>
    <special>The branch is situated right next to a giant purple chicken.</special> <!-- OPTIONAL -->
    <place>Zásilkovna s.r.o.</place>
    <street>Teststreet 15</street>
    <city>Prague</city>
    <zip>123 45</zip>
    <country>cz</country>
    <currency>CZK</currency>
    <exportedUntil>2016-09-16</exportedUntil> <!-- OPTIONAL -->
    <enterableUntil>2016-09-20</enterableUntil> <!-- OPTIONAL -->
    <openUntil>2016-09-30</openUntil> <!-- OPTIONAL -->
    <openSince>2016-07-01</openSince> <!-- OPTIONAL -->
    <wheelchairAccessible>no</wheelchairAccessible>
    <directions><p>Just go straight ahead.</p></directions> <!-- OPTIONAL -->
    <directionsCar><p>Just drive straight ahead.</p></directionsCar> <!-- OPTIONAL -->
    <directionsPublic><p>Get on a bus and exit on Terminal station.</p></directionsPublic> <!-- OPTIONAL -->
    <latitude>76.54321</latitude>
    <longitude>12.34567</longitude>
    <url>http://www.zasilkovna.cz/pobocky/test-branch</url>
    <dressingRoom>0</dressingRoom>
    <claimAssistant>1</claimAssistant>
    <packetConsignment>1</packetConsignment>
    <maxWeight>5</maxWeight>
    <holidayStart>2016-07-29</holidayStart> <!-- OPTIONAL -->
    <holidayEnd>2016-08-04</holidayEnd> <!-- OPTIONAL -->
    <noticeMessage>The branch is closed due to holiday.</noticeMessage> <!-- OPTIONAL -->
    <region>Hlavní město Praha</region>
    <district>Hlavní město Praha</district>
    <labelRouting>A--0--000</labelRouting>
    <labelName>Test Branch</labelName>
    <photos>
        See documentation for "<photos>" element
    </photos>
    <openingHours>
        See documentation for "<openingHours>" element
    </openingHours>
</branch>
Name Type Description
id Integer A unique id.
name String Short name for the branch. Usage of this name in listings is dicouraged as the name does not fully specify the location of the branch.
nameStreet String Fully qualified name of the branch containing a full address.
special String Special orientation feature of the location.
place String Name of the place hosting the branch i.e. Baker & Sons bakery.
street String Street name and number.
city String City.
zip String Zip code. Contains spaces based on standard country format.
country String Country code.
currency String Currency accepted by the branch.
exportedUntil Date If the branch is scheduled to close, the field contains date when the branch is last contained in the export. The format is YYYY-MM-DD.
enterableUntil Date If the branch is scheduled to close, the field contains last date when our system will accept packet data for this branch. The format is YYYY-MM-DD.
openUntil Date If the branch is scheduled to close, the field contains last date of the branch being open for pick up of delivered packets. The format is YYYY-MM-DD.
openSince Date If the branch is scheduled to open, the field contains the first date of the branch being open for pick up of delivered packets. The format is YYYY-MM-DD.
wheelchairAccessible Integer Indicates whether the branch is wheelchair accessible.
directions String HTML directions to the branch.
directionsCar String HTML directions to the branch when travelling by car.
directionsPublic String HTML directions to the branch when travelling via public transport.
latitude Decimal Latitude.
longitude Decimal Longitude.
url String URL with branch information
dressingRoom Integer Indicates whether the branch has a dressing room.
claimAssistant Integer Indicates whether the branch accepts Claim Assistant packets.
packetConsignment Integer Indicates whether the branch accepts packet consignment.
maxWeight Integer Maximal weight of the packet the branch is able to handle.
holidayStart Date The date of the start of the holiday. If the branch is contiuously closed for at least 7 days, the time is considered a holiday. This field is present at most 14 days before the start of the holiday.
holidayEnd Date The date of the end of the holiday.
noticeMessage String Optional HTML information about the holiday. Can be present only in combination with <holidayStart>
region String Country region.
district String Country district.
labelRouting String Routing code of the branch. Used for custom labels.
labelName String Branch name for printing on custom labels.
photos Container Container for <photo> elements.
openingHours Container Container for opening hours information. See <openingHours> documentation.

<photo>

Contained one or many times by <photos> element.

<photo>
    <thumbnail>http://www.zasilkovna.cz/images/branch/thumb/stub.jpg</thumbnail>
    <normal>http://www.zasilkovna.cz/images/branch/normal/stub.jpg</normal>
</photo>
Name Type Description
thumbnail String URL of a thumbnail image 160px*120px.
normal String URL of a image 720px*540px.

<openingHours>

Contained once by <branch> element.

<openingHours>
    <compactShort><strong>Po–Pá</strong> 09:00–16:30</compactShort>
    <compactLong><strong>Po–Pá</strong> 09:00–16:30</compactLong>
    <tableLong>
        <table class='packetery-hours'><tr><th>Po</th><td>09:00–16:30</td></tr> <tr><th>Út</th><td>09:00–16:30</td></tr> <tr><th>St</th><td>09:00–16:30</td></tr> <tr><th>Čt</th><td>09:00–16:30</td></tr> <tr><th>Pá</th><td>09:00–16:30</td></tr> <tr><th>So</th><td></td></tr> <tr><th>Ne</th><td></td></tr></table>
    </tableLong>
    <regular>
        See documentation for "<regular>" element
    </regular>
    <upcoming>
        See documentation for "<upcoming>" element
    </upcoming>
    <exceptions>
        See documentation for "<exceptions>" element
    </exceptions>
</openingHours>
Name Type Description
compactShort String HTML range representation of opening hours.
compactLong String Contains value of <compactShort> possibly with some additional info.
tableLong String HTML table with packetery-hours class containing the opening hours.
regular Container Container for opening hours by day. See documentation for <regular> element.
upcoming Container Container for upcoming opening hours by day. See documentation for <upcoming> element.
exceptions Container Container for <exception> elements.

<regular>

Contained once by <openingHours> element.

Contains opening hours for each day in day-named elements. In the table below we only show <monday> since the same applies for other week days.

<regular>
    <monday>09:00–16:30</monday>
    <tuesday>09:00–16:30</tuesday>
    <wednesday>09:00–16:30</wednesday>
    <thursday>09:00–16:30</thursday>
    <friday>09:00–16:30</friday>
    <saturday/>
    <sunday/>
</regular>
Name Type Description
monday String Range representation of opening hours for the day.

<upcoming>

Contained once by <openingHours> element.

Contains upcoming opening hours for each day in day-named elements along with an element indicating when the new opening hours start. In the table below we only show <monday> since the same applies for other week days.

<upcoming>
    <monday>09:00–18:00</monday>
    <tuesday>09:00–18:00</tuesday>
    <wednesday>09:00–18:00</wednesday>
    <thursday>09:00–18:00</thursday>
    <friday>09:00–18:00</friday>
    <saturday>09:00-12:00</saturday>
    <sunday>09:00-12:00</sunday>
    <startDate>2016-08-03</startDate>
</upcoming>
Name Type Description
monday String Range representation of opening hours for the day.
startDate Date The day on which the new opening hours come to effect.

<exceptions>

Contained once by <openingHours> element.

<exceptions>
    <exception> <!-- OPTIONAL -->
        See documentation for "<exception>" element
    </exception>
</exceptions>

<exception>

Contained none or many times by <exceptions> element.

<exception>
    <date>2016-08-02</date>
    <hours>10:00–13:30, 16:00–17:30</hours> <!-- OPTIONAL -->
</exception>
Name Type Description
date Date Date of the opening hours exception.
hours String Range representation of opening hours for the day. If omitted, the branch is closed on that day.