PARTNER EXTRA

Description

Click here to download the .pdf version.

1. Abbreviations

PE: Partner Extra
XML: Extensible Markup Language
SZEAZ: Szervezeti Egység Azonosító (Organisational Unit ID)

2. Use and requirements of the service

To use the service, only the xml files on the page https://www.posta.hu/partnerextra need to be downloaded. The xml files contain the most important information grouped together about each delivery option and the data providing support when addressing. To view the page, we recommend the use of one of the following browsers: Mozilla Firefox, Google Chrome, Opera, Safari.

3. Logical structure of the service

The files in the service can be placed in three main groups: PostInfo, address support, other files.

3.1 PostInfo files

Download file Name of link Description
PostInfo.xml Post Offices, MOL, Coop and Parcel Terminal Points A complete list containing the most important information on each post office, Postal Point and Parcel Terminal
PostInfo_PM.xml Post Offices File containing information about post offices
PostInfo_PP.xml MOL and Coop Points File containing information about Magyar Posta’s contracted partners (MOL, Coop)
PostInfo_CS.xml Parcel Terminals File containing the Parcel Terminal points

 

Download file Name of link Description
PostInfo2.xml Post Offices, MOL, Coop and Parcel Terminal Points File containing information on all parcel pick-up points, including additional indication of Budapest districts.
PostInfo_PM2.xml Post Offices Data file including post offices and MPL Holiday Parcel Points. Additional indication of Budapest districts.
PostInfo_PP2.xml MOL and Coop Points Data file including pick-up points at gas stations and shops. Additional indication of Postal Point type (partner network ID) and districts of Budapest.
PostInfo_CS2.xml Parcel Terminals Data file including parcel terminals. Additional indication of Budapest districts.

3.2 Address support files

Download file Name of link Description
StreetTypes.xml Street types List of possible street types (e.g. utca, tér, sor, etc.)
StreetNames.xml Street names Street names and types for each town
ZipCodes.xml Hungarian postcodes Towns and the postcodes attributed to them

3.3 Other files

Download file Name of link Description
AreaCodes.xml Area codes The file contains the area codes for the landlines phone numbers in Hungary and the respective maximum length of the numbers (e.g. 26, 6 = 06-26-xxxxxx; 1, 7 = 06-1-xxxxxxx)
TimeWindow.xml Time-window delivery at post offices A list of the potential delivery time windows
WorkBreaks.xml Non-working days in the year in Hungary A list of the non-working days in the year in Hungary

4. File structure

4.1 4.1 PostInfo.xml, PostInfo2.xml, PostInfo_PM.xml, PostInfo_PM2.xml, PostInfo_PP.xml, PostInfo_PP2.xml, PostInfo_CS.xml, PostInfo_CS2.xml

Name of parameter Level Type Description
isPostPoint post bool 0 = the post office, partner or parcel terminal is currently not operating; 1 = available, operating
zipCode post string postcode
ID post string record identifier (SZEAZ)
name post string name of post office, partner or parcel terminal
city post string name of town
name street string street name
type street string street type
houseNumber street string house number
EOVx gpsData string service point EOV geocode; X coordinate
EOVx gpsData string service point EOV geocode; Y coordinate
WGSLat gpsData string service point WGS geocode; X coordinate
WGSLon gpsData string service point WGS geocode; Y coordinate
phoneArea post string contact: phone number
workingHours culture post    
day workingHours string a given day of the week
From [1,2,3 .. n] workingHours int time of opening for a given day
To [1,2,3 .. n] workingHours int time of closing for a given day
description post string further description, comment
email post string contact: e-mail address
ServicePointType post string PM = post office; PP = postal point (MOL, Coop); CS = parcel terminal
district post string district
service_provider post string partner network ID (1 – MOL, 2 – Coop, 3 – Trendmaker, 4 – Media Markt)

4.2 StreetTypes.xml

Name of parameter Level Type Description
streetType streetTypes string street type (e.g. út, utca, tér, etc.)

4.3 StreetNames.xml

Name of parameter Level Type Description
ZipCode street string postcode
city street string town
name street string street name (e.g. Kossuth Lajos)
type street string street type (e.g. út, utca, tér, etc.)

4.4 ZipCodes.xml

Name of parameter Level Type Description
Code zipCode string postcode
city zipCode string town
TimeWindowID zipCode string identifier of time window for the town

4.5 AreaCodes.xml

Name of parameter Level Type Description
area_number area int (landline) area code
length area int maximum length of telephone number for the given area code
note area string  

4.6 TimeWindow.xml

Paraméter neve Level Type Description
ID TimeWindow string record identifier
Intervall TimeWindow string delivery interval
TimeWindowID TimeWindow string delivery time window identifier

4.7 WorkBreaks.xml

Name of parameter Level Type Description
dateFrom Break datetime starting date of non-working day
dateTo Break datetime closing date of non-working day
culture Break string  

5. Xml file connection

5.1 PostInfo connection

PostInfo.xml     PostInfo_PM.xml
ID 1, 2, 3 1 ID
       
       
      PostInfo_PP.xml
    2 ID
       
       
      PostInfo_CS.xml
    3 ID
       
       

The post offices, postal points and parcel terminals in the PostInfo.xml file have been divided into three further xml files based on the ServicePointType field; the values of the ID fields of the PM, PP and CS ending xml files can be derived from the source table (PostInfo.xml).

5.2 Connection between towns and time-window delivery

TimeWindow.xml     ZipCodes.xml
TimeWindowID 1 1 TimeWindowID
       
       

The TimeWindow.xml file lists the time-window delivery options at post offices identified by an index field (TimeWindowID). Based on this field, a connection can be established with the ZipCodes.xml file, which lists each town and the postcodes attributed to them. By creating the connection, the time-window service at post offices for each town is obtained.

6. Updates

The database of the PE service is updated daily, which can be accessed by visitors through the files detailed in the previous sections. Further information about the current development is given on the https://www.posta.hu/partnerextra page.