> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/autres/via-cep.md).

# Via CEP

### Vue d'ensemble

Le **Composant d’intégration ViaCEP** (identifié dans l’interface par le nom technique descriptif `via_cep`) est un nœud d’action axé sur l’enrichissement des données (*enrichissement des données*) et la consultation d’API externes d’utilité publique. Sa fonction principale est d’automatiser la localisation des adresses postales brésiliennes dans le flux de service. Il capture un code postal (CEP) fourni par l’utilisateur et effectue, nativement et en arrière-plan, une requête HTTP de type `GET` aux serveurs du service ViaCEP, en renvoyant la structure complète de la rue, du quartier, de la ville et de l’État.

### Paramètres de configuration

La configuration du bloc gère la chaîne d’entrée pour la requête au webservice à travers un seul critère obligatoire :

* **CEP (\* Champ obligatoire) :** Champ de saisie texte destiné à recevoir la numérotation du code postal qui sera consulté. Il accepte la saisie de valeurs statiques ou l’injection de variables dynamiques du flux qui stockent la réponse saisie par le client (ex : `{{response}}` ou `{{cliente.cep_bruto}}`).<br>

### Constructeur visuel

L’interface du constructeur a été conçue selon un modèle épuré et direct, afin d’abstraire les configurations complexes d’en-têtes ou de jetons de requête :

* **Panneau de saisie directe :** Affiche une interface épurée composée exclusivement du champ de saisie du CEP. L’indicateur astérisque (`*`) agit comme un verrou de sécurité visuel, empêchant l’administrateur d’enregistrer le composant sans définir un paramètre de recherche. S’agissant d’un bus de requête publique natif, le nœud dispense de sélecteurs d’identifiants, d’authentifications API ou de téléversements de médias.<br>
* **Mise à disposition du payload de sortie :** Sur la carte visuelle d’automatisation, le bloc présente des connecteurs traditionnels d’entrée et de sortie continue. Une fois raccordé à l’arborescence, le système expose automatiquement l’objet de données résultant de ViaCEP afin que les nœuds voisins puissent lire et consommer les propriétés de l’adresse localisée.<br>

### Opérateurs spéciaux

Les propriétés logiques de ce composant gèrent le nettoyage des données en temps réel, le traitement des erreurs de requête et le mappage des payloads JSON :

* **Traitement automatique du masque (sanitization) :** Le moteur interne du composant nettoie automatiquement la chaîne saisie dans le champ *CEP* avant de déclencher l’endpoint. Il applique des expressions régulières pour supprimer les caractères spéciaux, les tirets (`-`) ou les espaces vides, garantissant l’envoi correct du format standard à 8 chiffres exigé par ViaCEP.<br>
* **Mappage de la structure de réponse (objet JSON) :** Après avoir traité avec succès l’appel synchrone, le moteur de la plateforme injecte les propriétés renvoyées directement dans le champ de données du contact (`$data`). Le payload renvoyé suit le standard du service et inclut les sous-variables suivantes prêtes à l’emploi :
  * `via_cep.logradouro`: Nom de la rue, avenue, place, etc.<br>
  * `via_cep.bairro`: Quartier ou district correspondant.<br>
  * `via_cep.localidade`: Nom de la commune/de la ville.<br>
  * `via_cep.uf`: Code de l’État (Unité de la Fédération).<br>
  * `via_cep.complemento`: Informations complémentaires sur le lotissement ou la région (le cas échéant).<br>
* **Gestion du chemin d’échec (CEP inexistant) :** Si le webservice renvoie que le CEP consulté est invalide ou inexistant (retour `{ "erro": true }`), le composant empêche l’enregistrement de données vides et permet au flux d’emprunter des chemins alternatifs de correction.<br>

### Exemples pratiques

Le tableau ci-dessous présente des scénarios d’utilisation de ce composant pour optimiser les inscriptions et les livraisons dans le parcours du bot :

| **CEP indiqué dans le constructeur** | **Réponse du serveur ViaCEP**      | **Propriétés injectées dans le flux**                                                                                                                                                                                   | **Cas d'utilisation pratique**                                                                                                                                                                                                                                                                           |
| ------------------------------------ | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `70040-010`                          | Succès de la requête.              | <p><code>via\_cep.logradouro</code> = "SBN Quadra 1 Bloc A"<br><br><br><br><code>via\_cep.localidade</code> = "Brasília"<br><br><br><br><code>via\_cep.uf</code> = "DF"</p>                                             | Le client saisit le CEP avec un tiret dans le chat. Le bloc traite la chaîne, recherche les données et renseigne automatiquement l’adresse à des fins de facturation.                                                                                                                                    |
| `{{resposta_cep}}`                   | Succès de la requête.              | <p><code>via\_cep.logradouro</code> = "Praça da Sé"<br><br><br><br><code>via\_cep.bairro</code> = "Sé"<br><br><br><br><code>via\_cep.localidade</code> = "São Paulo"<br><br><br><br><code>via\_cep.uf</code> = "SP"</p> | Dans un flux de livraison e-commerce, le bot demande le CEP du client. Ce composant traite la réponse et affiche ensuite un message de confirmation : *"Vous habitez dans la `{{via_cep.logradouro}}`, dans le quartier `{{via_cep.bairro}}` à `{{via_cep.localidade}}`/`{{via_cep.uf}}`? Oui ou non ?"* |
| `00000000`                           | Réponse d’erreur (CEP non trouvé). | Aucune propriété d’adresse n’est injectée.                                                                                                                                                                              | L’utilisateur saisit un numéro invalide dans le chat. Le système identifie l’échec dans le retour du bloc et l’oriente vers un nœud de question lui demandant de ressaisir le code postal.                                                                                                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/autres/via-cep.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.