Branch export version 4

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/v4/__API_KEY__/branch.xml?lang=__LANGUAGE__
https://www.zasilkovna.cz/api/v4/__API_KEY__/branch.json?lang=__LANGUAGE__

You can find the XML export's schema here:

https://www.zasilkovna.cz/api/v4/__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/v4/__API_KEY__/branch.csv

Changes

The version 4 introduces following changes compared to version 3:

  • Attribute nameStreet is no longer supplied. Use name instead.
  • Attribute noticeMessage is no longer supplied. Refer to status instead.
  • Added attribute creditCardPayment.
  • Added container status in branch with attributes statusId and description in chosen language (language is set by GET parameter lang).
  • Added attribute displayFrontend in branch which indicates whether the branch is supposed to be shown to the end customer.
  • Carriers are now always displayed as carrier in separate XML container carriers, which is on the same level as branches. Carriers contain different set of attributes than branches.
  • GET parameter type is not needed anymore as it was removed.

Export specification

<?xml version="1.0" encoding="UTF-8" ?>
<export xmlns="http://www.zasilkovna.cz/api/v4/branch" xmlns:ns="http://www.zasilkovna.cz/api/v4/branch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.zasilkovna.cz/api/v4/branch http://www.zasilkovna.cz/api/v4/branch.xsd">
    <contacts>
        <contact>
            <country>cz</country>
            <phone>+420 123 123 123</phone>
            <email>[email protected]</email>
            <businessHours>Po-Pá 08:00 – 20:00 hod.</businessHours>
        </contact>
        <contact>
            <country>sk</country>
            <phone>+421 321 321 321</phone>
            <email>[email protected]</email>
            <businessHours>Po-Pi 9:00 – 19:00 hod.</businessHours>
        </contact>
    </contacts>
    <branches>
        <branch>
            <id>0</id>
            <name>Prague 1, Teststreet 1</name>
            <special>The branch is next to the big building on the right side.</special>
            <place>Zásilkovna</place>
            <street>Teststreet 1</street>
            <city>Prague</city>
            <zip>110 00</zip>
            <country>cz</country>
            <currency>CZK</currency>
            <status>
                <statusId>1</statusId>
                <description>In operation.</description>
            </status>
            <displayFrontend>0</displayFrontend>
            <exportedUntil>2017-07-01</exportedUntil>
            <enterableUntil>2017-08-01</enterableUntil>
            <openSince>2015-07-01</openSince>
            <openUntil>2017-07-01</openUntil>
            <directions>You walk straight from the bus station, the left.</directions>
            <directionsCar>You drive on the main street, then right.</directionsCar>
            <directionsPublic>Subway A, or tram 1</directionsPublic>
            <wheelchairAccessible>no</wheelchairAccessible>
            <creditCardPayment>yes</creditCardPayment>
            <dressingRoom>1</dressingRoom>
            <claimAssistant>1</claimAssistant>
            <packetConsignment>1</packetConsignment>
            <latitude>50.00000</latitude>
            <longitude>14.00000</longitude>
            <url>https://www.zasilkovna.cz/pobocky/prague1</url>
            <maxWeight>15</maxWeight>
            <holidayStart>2017-07-02</holidayStart>
            <holidayEnd>2017-07-03</holidayEnd>
            <region>Hlavní město Praha</region>
            <district>okres Hlavní město Praha</district>
            <labelRouting>A--0--000</labelRouting>
            <labelName>Prague 1, Teststreet 1</labelName>
            <photos>
                <photo>
                    <thumbnail>https://www.zasilkovna.cz/images/branch/thumb/img_1.jpg</thumbnail>
                    <normal>https://www.zasilkovna.cz/images/branch/normal/img_1.jpg</normal>
                </photo>
                <photo>
                    <thumbnail>https://www.zasilkovna.cz/images/branch/thumb/img_2.jpg</thumbnail>
                    <normal>https://www.zasilkovna.cz/images/branch/normal/img_2.jpg</normal>
                </photo>
            </photos>
            <openingHours>
                <compactShort>&lt;strong&gt;Po–Pá&lt;/strong&gt; 10:00–19:00</compactShort>
                <compactLong>&lt;strong&gt;Po–Pá&lt;/strong&gt; 10:00–19:00</compactLong>
                <tableLong>
                    &lt;table class=&#039;packetery-hours&#039;&gt;&lt;tr&gt;&lt;th&gt;Po&lt;/th&gt;&lt;td&gt;10:00–19:00&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;Út&lt;/th&gt;&lt;td&gt;10:00–19:00&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;St&lt;/th&gt;&lt;td&gt;10:00–19:00&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;Čt&lt;/th&gt;&lt;td&gt;10:00–19:00&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;Pá&lt;/th&gt;&lt;td&gt;10:00–19:00&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;So&lt;/th&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;
                    &lt;tr&gt;&lt;th&gt;Ne&lt;/th&gt;&lt;td&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
                </tableLong>
                <regular>
                    <monday>10:00–19:00</monday>
                    <tuesday>10:00–19:00</tuesday>
                    <wednesday>10:00–19:00</wednesday>
                    <thursday>10:00–19:00</thursday>
                    <friday>10:00–19:00</friday>
                    <saturday/>
                    <sunday/>
                </regular>
                <upcoming>
                    <monday>11:00–19:00</monday>
                    <tuesday>11:00–19:00</tuesday>
                    <wednesday>11:00–19:00</wednesday>
                    <thursday>11:00–19:00</thursday>
                    <friday>11:00–19:00</friday>
                    <saturday/>
                    <sunday/>
                    <startDate>2017-07-01</startDate>
                </upcoming>
                <exceptions>
                    <exception>
                        <date>2017-08-02</date>
                        <hours>10:00–13:30, 16:00–17:30</hours>
                    </exception>
                </exceptions>
            </openingHours>
        </branch>
    </branches>
    <carriers>
        <carrier>
            <id>0</id>
            <name>Czech Carrier</name>
            <pickupPoints>false</pickupPoints>
            <apiAllowed>false</apiAllowed>
            <country>cz</country>
            <currency>CZK</currency>
            <maxWeight>15</maxWeight>
            <labelRouting>A--0--000</labelRouting>
            <labelName>Carrier 1</labelName>
        </carrier>
    </carriers>
</export>

<export>

Root element of the document

<export xmlns="http://www.zasilkovna.cz/api/v4/branch" xmlns:ns="http://www.zasilkovna.cz/api/v4/branch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.zasilkovna.cz/api/v4/branch http://www.zasilkovna.cz/api/v4/branch.xsd">
    <contacts>
        See documentation for "<contacts>" element
    </contacts>
    <branches>
        See documentation for "<branches>" element
    </branches>
    <carriers>
        See documentation for "<carriers>" element
    </carriers>
</export>
Name Type Description
contacts Container Container for <contact> elements.
branches Container Container for <branch> elements.
carriers Container Container for <carrier> 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 once 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>0</id>
    <name>Prague 1, Teststreet 1</name>
    <special>The branch is next to the big building on the right side.</special> <!--OPTIONAL-->
    <place>Zásilkovna</place>
    <street>Teststreet 1</street>
    <city>Prague</city>
    <zip>110 00</zip>
    <country>cz</country>
    <currency>CZK</currency>
    <status>
        See documentation for "<status>" element
    </status>
    <displayFrontend>0</displayFrontend>
    <exportedUntil>2017-07-01</exportedUntil> <!--OPTIONAL-->
    <enterableUntil>2017-08-01</enterableUntil> <!--OPTIONAL-->
    <openSince>2015-07-01</openSince> <!--OPTIONAL-->
    <openUntil>2017-07-01</openUntil> <!--OPTIONAL-->
    <directions>You walk straight from the bus station, the left.</directions> <!--OPTIONAL-->
    <directionsCar>You drive on the main street, then right.</directionsCar> <!--OPTIONAL-->
    <directionsPublic>Subway A, or tram 1</directionsPublic> <!--OPTIONAL-->
    <wheelchairAccessible>no</wheelchairAccessible>
    <dressingRoom>1</dressingRoom>
    <claimAssistant>1</claimAssistant>
    <packetConsignment>1</packetConsignment>
    <latitude>50.00000</latitude>
    <longitude>14.00000</longitude>
    <url>https://www.zasilkovna.cz/pobocky/prague1</url>
    <maxWeight>15</maxWeight>
    <holidayStart>2017-07-02</holidayStart> <!--OPTIONAL-->
    <holidayEnd>2017-07-03</holidayEndt> <!--OPTIONAL-->
    <region>Hlavní město Praha</region> <!--OPTIONAL-->
    <district>okres Hlavní město Praha</district> <!--OPTIONAL-->
    <labelRouting>A--0--000</labelRouting> <!--OPTIONAL-->
    <labelName>Prague 1, Teststreet 1</labelName> <!--OPTIONAL-->
    <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 Branch name.
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 code accepted by the branch.
status Container Container for the status code and status message of the branch. See <status>.
displayFrontend Integer Indicates whether the branch is supposed to be shown to the end customer. If the value equals '0', the branch is intended to be used only for your administrative purposes.
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.
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.
wheelchairAccessible String Indicates whether the branch is wheelchair accessible.
creditCardPayment String Indicates whether the branch accepts credit card as payment option.
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.
latitude Decimal Latitude.
longitude Decimal Longitude.
url String URL with branch information.
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.
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.

<status>

Contained once by <branches>.

Contains a status code and a message. The language of the status message is determined by the lang GET parameter. If no lang parameter is supplied, default value en is used.

<statusId>1</statusId>
<description>In operation.</description>
Name Type Description
statusId Integer Numeric code of branch status.
description String Text message of the branch status in chosen language.

Statuses

Status code Description
1 In operation.
2 Temporarily closed due to holiday.
3 Temporarily does not receive packets due to exceeded capacity.
4 Temporarily does not receive packets due to technical reasons.
5 The branch has ended cooperation and no longer accepts new packets.

<photo>

Contained zero to many times by <photos> element.

<photo> <!--OPTIONAL-->
    <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> <!--OPTIONAL-->
    <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.

<carriers>

Contained exactly once by <export>.

<carriers>
    <carrier> <!--OPTIONAL-->
        See documentation for "<carrier>" element
    </carrier>
</carriers>

<carrier>

Contained none or many times by <carriers>.

Represents a carrier.

<carrier> <!--OPTIONAL-->
    <id>0</id>
    <name>Czech Carrier</name>
    <pickupPoints>false</pickupPoints>
    <apiAllowed>false</apiAllowed>
    <country>cz</country>
    <currency>CZK</currency>
    <maxWeight>15</maxWeight>
    <labelRouting>A--0--000</labelRouting> <!--OPTIONAL-->
    <labelName>Carrier 1</labelName> <!--OPTIONAL-->
</carrier>
Name Type Description
id Integer A unique id.
name String Carrier name.
pickupPoints Boolean Indicates whether the carrier offers its own pickup points. Please refer to our carrier pick up points documentation for more information.
apiAllowed Boolean Indicates whether the carrier supports direct label printing, ie. whether the label is available via packetCourierLabelPdf(), packetCourierLabelPng() and packetsCourierLabelsPdf() methods.
country String Country code.
currency String Currency code accepted by the carrier.
maxWeight Integer Maximal weight of the packet the carrier is able to handle.
labelRouting String Routing code of the carrier. Used for custom labels.
labelName String Carrier name for printing on custom labels.