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 |
| 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.
