Skip to main content

Data Delivery

Output Schema & Codes

Complete schema of the enriched output file delivered as GZIP (.gz) in ./output/. Source columns 0..N are preserved untouched with 32 standardized postal, spatial, and diagnostic match fields appended to the right (27 with [IN_FUN] NOR;, which omits the geocoding fields).

Output Delivery Schema​

<filename>_output_<timestamp>.gz

Compressed Delivery Archive
<filename>_output_<timestamp>

Delimited text file containing source fields followed by standardized postal data, WGS84 coordinates (with GEO;), and diagnostic codes.

Delivery Specifications

SFTP Delivery Channel
Target Path./output/ folder
CompressionGZIP format (.gz)
TimestampYYYYMMDDHHMM
DelimiterInherited from [IN_SEP]
Timestamped Delivery

Appends _output_<timestamp> (YYYYMMDDHHMM) to ensure unique file versions and prevent overwriting prior executions.

GZIP Compression (.gz)

Results are streamed into high-compression GZIP archives to minimize SFTP bandwidth and maximize transfer speeds.

Preserved Column Order

Original input columns remain verbatim at positions 0..N, enabling frictionless reconciliation and database updates.

Consistent Delimiter

Output files preserve the exact delimiter declared in [IN_SEP] (pipe or semicolon) across all columns.

Delivery AttributeValue / FormatDescription
Directory./output/Assigned customer delivery channel.
File Pattern<filename>_output_<timestamp>.gzTimestamp format: YYYYMMDDHHMM.
Archive FormatGZIP (.gz)Single compressed delimited text file.
DelimiterMatches [IN_SEP]Pipe (|) or semicolon (;).
EncodingMatches [IN_ENC]UTF-8 or declared byte encoding.
Line Count1:1 with InputHeader row (if enabled) + 1 output row per input row.

Record Composition & Enriched Output Dataset​

Every output row preserves all source columns 0..N untouched on the left, appending 32 standardized postal, spatial, persistent ID, and diagnostic fields to the right, or 27 with [IN_FUN] NOR;, which omits the 5 geocoding fields. The number of source columns depends on your input file: the example below has 12 and uses GEO;, for 44 columns in total. Use the category cards below to jump to detailed field specifications, or explore the complete 44-column dataset in the interactive spreadsheet preview. Use Copy Spreadsheet (Excel) to copy and paste directly into Excel or Copy Output CSV for raw delimited data:

Output Dataset (44 Columns · 3 Sample Records)
#Preserved Source Input (Cols 0..11) (12)Normalized Postal Fields (Cols 12..27) (16)WGS84 Geocoding & Census (Cols 28..32) (5)Persistent Egon IDs (Cols 33..37) (5)Diagnostic Match Flags (Cols 38..43) (6)
#
Col 0
ID
Col 1
COUNTRY
Col 2
REGION
Col 3
PROVINCE
Col 4
CITY
Col 5
LOCALITY
Col 6
ZIP
Col 7
STREET_TYPE
Col 8
STREET_NAME
Col 9
NUMBER
Col 10
EXPONENT
Col 11
CARE_OF
Col 12
DSXPLCUFF_DSXCNY
Col 13
DSXPLCUFF_DSXREG
Col 14
DSXPLCSIG_DSXDPT
Col 15
DSXPLCUFF_DSXDPT
Col 16
DSXPLCUFF_DSXCNL
Col 17
CDXSTA
Col 18
DSXPLCUFF_DSXDS1
Col 19
CDXZIP
Col 20
DSXSTRUFF_DSXADD
Col 21
DSXSTRABB_DSXADD
Col 22
DSXST1_DSXDUG
Col 23
DSXST1_DSXVIA
Col 24
CIVICOST1_NRPNUMCIV
Col 25
CIVICOST1_DSXESP
Col 26
DSXEXTURB
Col 27
DSXPREINR
Col 28
SEZIONE_2011
Col 29
ATT_VLXATT
Col 30
BES_VLXBES
Col 31
BES_1_X_G
Col 32
BES_1_Y_G
Col 33
CDPOBJDPT
Col 34
CDPOBJCNL
Col 35
CDPOBJDS1
Col 36
CDPOBJSTR
Col 37
CDPOBJCIV
Col 38
ERR_620_LOC_FLXSEG
Col 39
ERR_620_LOC_CDPSEG
Col 40
ERR_620_STR_FLXSEG
Col 41
ERR_620_STR_CDPSEG
Col 42
ERR_620_CIV_FLXSEG
Col 43
ERR_620_CIV_CDPSEG
11001ItaliaLombardiaMIMilano—20121ViaMonte Napoleone8AStudio RossiITALIALOMBARDIAMIMILANOMILANO015146—20121VIA MONTE NAPOLEONE 8 AVIA MONTE NAPOLEONE 8 AVIAMONTE NAPOLEONE8A—STUDIO ROSSI0151460000071117A419,1956926045,467921823800000006738000002491—3800005210838010019414863700001502
21002ItaliaLazioRMRom——P.zzadi Spagana1——ITALIALAZIORMROMAROMA058091—00187PIAZZA DI SPAGNA 1PIAZZA DI SPAGNA 1PIAZZADI SPAGNA1———0580911040006111A4112,4813197941,906598323800000009338000000243—380000871383801000116604011782189100
31003ItaliaVenetoVRVeronaSan Massimo37139CorsoMilano45B—ITALIAVENETOVRVERONAVERONA023091—37138CORSO MILANO 45 BCORSO MILANO 45 BCORSOMILANO45B——0230910001173111A4110,9718389345,443182443800000011538000004730—380000726553801000081753610018141503

Normalized Postal Fields​

Official address elements standardized against national postal authorities and Universal Postal Union (UPU) guidelines:

Field NameTypeDescriptionExample Value
DSXPLCUFF_DSXCNYStringOfficial country nameITALIA
DSXPLCUFF_DSXREGStringOfficial region / administrative territoryLOMBARDIA
DSXPLCSIG_DSXDPTStringOfficial province two-letter abbreviation (Sigla)MI
DSXPLCUFF_DSXDPTStringOfficial province nameMILANO
DSXPLCUFF_DSXCNLStringOfficial municipality name (Comune)MILANO
CDXSTAStringOfficial national statistical code (e.g. ISTAT municipality code)015146
DSXPLCUFF_DSXDS1StringOfficial locality / hamlet / district (Frazione)—
CDXZIPStringStandardized postal code (CAP / ZIP)20121
DSXSTRUFF_DSXADDStringComplete official street address lineVIA MONTE NAPOLEONE 8 A
DSXSTRABB_DSXADDStringStandard abbreviated street line (optimized for envelope windows)VIA MONTE NAPOLEONE 8 A
DSXST1_DSXDUGStringStandardized street type / urban designation (DUG)VIA
DSXST1_DSXVIAStringStandardized street nameMONTE NAPOLEONE
CIVICOST1_NRPNUMCIVStringNormalized house number8
CIVICOST1_DSXESPStringNormalized house number exponent / suffix (Esponente / Barrato)A
DSXEXTURBStringExtra-urban metric or kilometer milestone marker—
DSXPREINRStringNormalized building, interior, or care-of reference (Presso / Interno)—

Geocoding & Census Data​

Appended only when [IN_FUN] is GEO;: with NOR; these 5 columns are omitted from the file. See Geocoding Quality Indicators for the values of ATT_VLXATT and BES_VLXBES:

Field NameTypeDescriptionExample Value
SEZIONE_2011StringOfficial national census tract code (e.g. ISTAT 2011 section)0151460000071
ATT_VLXATTStringCoordinate approximation level117
BES_VLXBESStringCoordinate sourceA41
BES_1_X_GDecimalLongitude in WGS84 decimal degrees, with a comma as the decimal separator9,19569260
BES_1_Y_GDecimalLatitude in WGS84 decimal degrees, with a comma as the decimal separator45,46792182

Persistent Egon Identifiers​

Immutable surrogate numeric keys assigned to territorial entities in the Egon master database:

Field NameTypeEntity LevelPurposeExample Value
CDPOBJDPTLongProvinceGrouping by administrative province38000000067
CDPOBJCNLLongMunicipalityGrouping by city (Comune)38000002491
CDPOBJDS1LongLocalityGrouping by hamlet (Frazione)—
CDPOBJSTRLongStreetExact street entity deduplication38000052108
CDPOBJCIVLongHouse NumberBuilding-level deduplication and clustering380100194148637

Quality & Diagnostic Indicators​

Validation flags evaluating match outcome and changes across administrative tiers. See Address Quality Indicators for the meaning of each flag and code:

Field NameTypeEvaluated LevelDescriptionExample Value
ERR_620_LOC_FLXSEGStringLocality / CityReporting flag for the locality0
ERR_620_LOC_CDPSEGStringLocality / CityReporting code for the locality0
ERR_620_STR_FLXSEGStringStreetReporting flag for the street0
ERR_620_STR_CDPSEGStringStreetReporting code for the street0
ERR_620_CIV_FLXSEGStringHouse NumberReporting flag for the house number1
ERR_620_CIV_CDPSEGStringHouse NumberReporting code for the house number502

Next Steps​