--- title: Déclarer une box Somfy et enregistrer les équipements découverts dans Link’nX description: "Déclarer une box Somfy et enregistrer les équipements découverts dans Link’nX. Link’nX : déclarer une box Somfy avec hôte ou PIN port8443 et jeton développeur, enregistrer puis…" canonical: https://wiki.can-nx.com/guides/link-somfy-devices/ language: fr product: Link’nX audience: - administrateur - installateur context: Link’nX dans un projet et une gateway autorisés ; licence Nuki ou Somfy ; FR/EN et navigation mobile --- # Déclarer une box Somfy et enregistrer les équipements découverts dans Link’nX Contexte : Link’nX dans un projet et une gateway autorisés ; licence Nuki ou Somfy ; FR/EN et navigation mobile Pour les administrateurs et installateurs autorisés à configurer la gateway. Préparez les paramètres de la box et son **Jeton Mode Développeur**. Le jeton est confidentiel : saisissez-le uniquement dans le formulaire prévu et masquez-le dans toute capture. ## Déclarer la box 1. Vérifiez le projet et la gateway dans l’en-tête Link’nX. Dans **Appareils**, ouvrez **Maison intelligente**, puis **Somfy**, ou cherchez Somfy dans **Rechercher un appareil...**. Sur mobile, [ouvrez d’abord la navigation](https://wiki.can-nx.com/guides/link-navigation/). 2. Si un cadenas ou un message d’activation apparaît, vérifiez le contexte et l’option Somfy. Pour un accès manquant, contactez votre distributeur ou **support@can-nx.com**. 3. Cliquez sur **Ajouter** pour ouvrir **Déclaration d’une box Somfy**. 4. Renseignez **Nom**, obligatoire, 64 caractères maximum. « Box séjour » est un exemple fictif. 5. Renseignez **Hôte (nom d’hôte ou IP)**, ou **PIN de la box**. Au moins l’un des deux doit être fourni. L’hôte accepte jusqu’à 128 caractères et le PIN jusqu’à 64. Utilisez les paramètres confirmés de la box. Le PIN permet de déduire l’hôte lorsque le champ Hôte est vide ; si l’hôte est renseigné, c’est lui qui est utilisé. 6. Vérifiez **Port**, initialement **8443**, avec l’installateur. Renseignez **Jeton Mode Développeur**, obligatoire. Un mot de passe de compte Somfy ne remplace pas ce jeton. 7. Cliquez sur la disquette ronde en bas à droite. Attendez **Succès !**, puis retrouvez la box dans la liste avec son hôte ou son PIN et son port. Si la disquette est grisée, contrôlez Nom, Hôte ou PIN, Port et Jeton. Pour obtenir un paramètre ou le jeton adapté à votre modèle et à votre application, contactez **support@can-nx.com** si la procédure n’est pas connue. Ne transmettez pas le jeton au support. Les modèles, versions et écrans fournisseur ne sont pas interchangeables. ## Découvrir puis enregistrer les équipements 1. Après la première sauvegarde, cliquez sur le crayon **Éditer** de la box. Une recherche démarre dans **Équipements de la box**. Lors d’une création non encore enregistrée, **Découvrir les équipements** est désactivé : enregistrez la box puis rouvrez-la. 2. Examinez les colonnes **Nom**, **Type**, **URL du sous-équipement** et **Dispo**. Les volets, stores ou capteurs sont des équipements de cette box, distincts de la déclaration de la box elle-même. 3. Pour relancer la recherche, cliquez sur **Actualiser** et attendez son résultat. **Disponible** et **Hors ligne** décrivent le résultat présenté ; ils ne garantissent pas un état permanent. 4. **Après une découverte réussie, cliquez sur la disquette pour enregistrer la liste.** Attendez **Mis à jour !**. Une liste simplement affichée après découverte n’est pas encore enregistrée pour les autres formulaires ; ne comptez pas sur une confirmation de départ pour la sauvegarder. 5. Ouvrez ensuite une [action Somfy](https://wiki.can-nx.com/guides/link-somfy-actions/), un [déclencheur Somfy](https://wiki.can-nx.com/guides/link-somfy-triggers/) ou [la passerelle KNX Somfy](https://wiki.can-nx.com/guides/link-somfy-knx/). Sélectionnez la box : ses équipements enregistrés deviennent disponibles dans **Équipement**. ## Si la découverte échoue **« La box n’a pas répondu… »** Vérifiez qu’il s’agit de la bonne box et qu’elle est en ligne. Relisez l’hôte ou le PIN, le port et le jeton dans la déclaration, sans les communiquer dans le chat. Cliquez sur **Actualiser** après ces vérifications. **« La box n’a renvoyé aucun équipement — liste enregistrée conservée… »** La liste précédente est conservée. Le badge **Liste enregistrée** indique qu’elle ne provient pas d’une nouvelle découverte réussie ; il ne confirme pas que l’équipement est actuellement disponible. N’effacez pas les anciennes associations pour résoudre ce seul message. Si vous connaissez déjà l’URL exacte du sous-équipement, les formulaires d’action, de déclencheur et de passerelle proposent **✎ Saisie manuelle de l’URL…**. Utilisez uniquement une URL confirmée de l’équipement de cette box ; l’adresse IP de la box ne la remplace pas. Cette saisie ne rétablit pas une connexion indisponible. **« Je vois le volet dans la déclaration, mais pas dans Actions. »** Enregistrez la déclaration après la découverte, puis rouvrez le formulaire d’action et sélectionnez la bonne box. Si le volet manque toujours malgré ces étapes, contactez **support@can-nx.com**. Si le problème persiste après les vérifications, contactez **support@can-nx.com** avec Link’nX, le projet et la gateway concernés, le modèle de box, le message exact et les essais réalisés. Une capture de la liste sans jeton ni données sensibles peut aider. N’annoncez pas un défaut de l’équipement sur la seule base d’un échec de découverte. ## Modifier ou supprimer la déclaration Ouvrez son crayon **Éditer**, corrigez les paramètres et enregistrez avec la disquette ; attendez **Mis à jour !**. Relisez les changements non enregistrés si une confirmation apparaît au départ du formulaire. Avant de supprimer la box, vérifiez ses actions, déclencheurs et associations KNX. Cliquez sur sa corbeille **Supprimer**, relisez le nom dans la confirmation du navigateur puis annulez pour la conserver, ou confirmez et vérifiez sa disparition après **Supprimé !**. Aucun bouton de restauration de la déclaration n’est proposé. En anglais : **Somfy box declaration**, **Host (hostname or IP)**, **Gateway PIN**, **Developer-Mode token**, **Refresh**, **Saved list**, **Device**, **Sub-device URL**, **✎ Enter the URL manually…**. Articles associés : [actions](https://wiki.can-nx.com/guides/link-somfy-actions/), [déclencheurs](https://wiki.can-nx.com/guides/link-somfy-triggers/), [associations KNX](https://wiki.can-nx.com/guides/link-somfy-knx/).