البرتغال

Q: In what language are the data and documentation provided?

The dataset retains the official Portuguese column headers (e.g., concelhos, artery, cpalf) to ensure compatibility with CTT (Correios de Portugal) standards.
Note: The data is encoded in UTF-8 to correctly display Portuguese characters such as ç, ã, é, í, ó.

Q: What is the format of the postal code?

Portugal uses a 7-digit hyphenated postal code (format: NNNN-NNN), found in the cp column.
Example: 3750-043.
The first four digits represent the general area, while the last three digits designate a specific street block, building, or delivery point.

Q: What is the difference between 'localidade' and 'cpalf'?

This is a common source of confusion in Portuguese addressing:
· localidade: The physical Name of the Locality or village (e.g., "Aguada de Cima"). Use this for geocoding or identifying the actual settlement.
· cpalf (Código Postal Alfanumérico): The official postal town name required for mail sorting (e.g., "AGUADA DE CIMA"). This name is standardized (usually uppercase) and is linked to the first 4 digits of the postal code.

Q: What does the 'artery' column represent?

The term artery refers to the street name or Thoroughfare (e.g., "Rua das Almas", "Praça de Santa Eulália").
Because Portugal uses the precise 7-digit system, postal codes are often assigned to specific streets or segments of streets. This allows for very high-precision address validation.

Q: Why are 'nome_do_cliente' and 'número_da_porta_do_cliente' often empty?

These columns are populated only for special postal codes assigned to large volume receivers or post offices.
· Standard Streets: For regular street addresses (e.g., "Rua das Almas"), these fields will typically contain a placeholder (like / or be empty), as the code applies to the street segment generally.
· Special Codes: For a Post Office (e.g., "PC AGUADA DE BAIXO"), these fields will list the entity name and door number.

Q: What file formats are included in the delivery?

The package includes CSV, Excel (.xlsx), and TXT formats. All files are encoded in UTF-8.

Q: Is this a one-time purchase or a subscription?

This is a one-time purchase. The license grants perpetual use for personal and internal business purposes.

Q: What is the refund policy?

Due to the digital nature of the product, all sales are final and non-refundable. We strongly recommend downloading the Free Sample before purchasing.

For any further inquiries, please reach out to us via our contact form.