Overview
This node queries the ViaCEP service to retrieve address information based on a Brazilian postal code (CEP). It is useful for applications that need to validate or fetch address details from a CEP, such as form autofill, address verification, or logistics planning. For example, given a CEP, the node returns the corresponding address data from ViaCEP.
Use Case Examples
- Given a CEP '01001000', the node fetches the address details from ViaCEP and outputs the JSON response containing street, neighborhood, city, and state information.
- In a workflow, this node can be used to automatically enrich user data by converting postal codes into full addresses.
Properties
| Name | Meaning |
|---|---|
| CEP | The Brazilian postal code (CEP) to query, must be 8 digits. |
Output
JSON
json- The JSON response from ViaCEP containing address details for the provided CEP.
Dependencies
- Requires internet access to call the ViaCEP public API endpoint at https://viacep.com.br/ws/{cep}/json/.
Troubleshooting
- If the CEP is invalid or not found, the ViaCEP API may return an error or empty response; ensure the CEP is exactly 8 digits and correctly formatted.
- Network issues or API downtime can cause request failures; verify internet connectivity and ViaCEP service status.
Links
- ViaCEP Official Website - Official site for the ViaCEP service providing postal code lookup in Brazil.