XML import

Basic guidelines

In Client section there is an option to upload a XML file containing packet data. It is suitable for import complete packet data including customs declaration.

The file needs to conform to the following rules:

  • The structure of the file has to correspond to the XML schema definition which contains brief descriptions of particular fields.
  • Currently supported version is 1.
  • Accepted file encoding is UTF-8.

XML file example

<parcels version="1">
    <parcel> <!-- address delivery example -->
        <orderNumber>123abc</orderNumber>
        <senderLabel>my-eshop</senderLabel>
        <name>John</name>
        <surname>Doe</surname>
        <emailAddress>john@doe.com</emailAddress>
        <phoneNumber>666555666</phoneNumber>
        <currency>CZK</currency>
        <cod>132.00</cod>
        <value>100.00</value>
        <weightKg>1.5</weightKg>
        <destination>
            <pickupPointOrCarrier>13</pickupPointOrCarrier>
            <street>Yellow street</street>
            <houseNumber>12</houseNumber>
            <city>Sun city</city>
            <zip>10101</zip>
        </destination>
    </parcel>
    <parcel> <!-- address delivery incl. customs declaration data example -->
        <orderNumber>246def</orderNumber>
        <senderLabel>my-eshop</senderLabel>
        <name>Jane</name>
        <surname>Doe</surname>
        <emailAddress>jane@doe.com</emailAddress>
        <phoneNumber>555666555</phoneNumber>
        <currency>CZK</currency>
        <cod>264.00</cod>
        <value>1</value>
        <weightKg>3.5</weightKg>
        <userNote>Note</userNote>
        <destination>
            <pickupPointOrCarrier>3294</pickupPointOrCarrier>
            <street>Rocky street</street>
            <houseNumber>2244</houseNumber>
            <city>Swiss city</city>
            <zip>50505</zip>
        </destination>
        <attributes>
            <attribute name="ead" value="create"/>
            <attribute name="deliveryCost" value="32"/>
            <attribute name="invoiceNumber" value="1234"/>
            <attribute name="invoiceIssueDate" value="2021-06-01"/>
            <attribute name="isDocument" value="true"/>
            <attribute name="mrn" value="32"/>
        </attributes>
        <documents>
            <document type="eadFile" filename="ead-2021-06-01.pdf">Base64 encoded file content</document>
            <document type="invoiceFile" filename="invoice-1234.pdf">Base64 encoded file content</document>
        </documents>
        <items>
            <item>
                <attributes>
                    <attribute name="countryOfOrigin" value="CZ"/>
                    <attribute name="customsCode" value="01012100"/>
                    <attribute name="productName" value="Kniha"/>
                    <attribute name="productNameEn" value="Book"/>
                    <attribute name="unitsCount" value="2"/>
                    <attribute name="value" value="100.0"/>
                    <attribute name="weight" value="2.5"/>
                    <attribute name="isFoodBook" value="true"/>
                    <attribute name="isVoc" value="false"/>
                </attributes>
            </item>
          <item>
            <attributes>
                <attribute name="customsCode" value="800800800"/>
                <attribute name="value" value="140"/>
                ...
            </attributes>
          </item>
        </items>
    </parcel>
    <parcel>
    ...
    </parcel>
</parcels>