Vous consultez ce guide parce que vous avez déjà une intégration NetSuite active et que vous rencontrez des problèmes, comme des échecs d'exportation ou des problèmes de synchronisation. Ceux-ci sont habituellement causés par des permissions manquantes dans votre rôle NetSuite, dont Float a besoin.
Ce guide vous explique comment migrer vers le rôle géré de Float, que Float crée et met à jour dorénavant, afin que vous n'ayez plus à modifier manuellement les permissions à chaque changement.
Est-ce le bon guide?
Utilisez ce guide seulement si vous avez déjà une intégration NetSuite active. Si vous connectez Float à NetSuite pour la première fois, utilisez plutôt le Guide d'intégration NetSuite.
Veuillez noter : cette migration garde votre connexion actuelle active tout au long du processus. Vous ne perdrez pas l'accès aux exportations ou aux synchronisations NetSuite pendant que vous complétez ces étapes.
Aperçu du guide
Comment migrer vers le rôle géré
- Mettre à jour votre SuiteBundle
- Ajouter le rôle d'intégration Float (géré) à votre utilisateur
- Créer une intégration
- Créer un jeton d'accès
- Soumettre le formulaire de connexion Float
Comment vérifier votre nouvelle connexion
Comment nettoyer votre ancienne connexion
Avant de commencer
Assurez-vous d'avoir :
- Un utilisateur ayant un niveau d'accès administrateur dans NetSuite
- Le rôle d'utilisateur d'administrateur ou de teneur de livres dans Float
- L'accès à votre intégration NetSuite actuelle dans Float (Paramètres > Synchronisation comptable)
Veuillez noter : gardez votre intégration et votre rôle actuels en place jusqu'à ce que vous ayez entièrement vérifié que le nouveau fonctionne. Ne retirez ni ne modifiez rien sur votre connexion existante pendant ce processus — celle-ci constitue votre filet de sécurité en cas de problème.
Comment migrer vers le rôle géré
Mettre à jour votre SuiteBundle :
- Accédez à Paramètres dans le panneau de navigation de gauche
- Cliquez sur Synchronisation comptable > NetSuite
- En haut de la page, vous verrez une invite « Installer maintenant »
- Vous pourriez devoir vous connecter à votre compte NetSuite d'abord avant de pouvoir passer à l'étape suivante
- Cliquez sur Installer dans NetSuite
- Attendez que le statut du bundle s'affiche en vert
Quelques considérations importantes :
- Pendant l'installation, vous pourriez voir le champ « Installé depuis » afficher « Sandbox » ou « Production »
- Ce champ n'affecte pas votre configuration; aucune action n'est donc requise, peu importe ce qui s'affiche à l'écran
- Si vous ne voyez pas cette option, c'est que votre SuiteBundle a déjà été mis à jour, et vous pouvez passer à l'étape suivante
Ajouter le rôle d'intégration Float (géré) à votre utilisateur :
- Dans NetSuite, accédez à Configuration > Utilisateurs/Rôles > Gérer les utilisateurs
- Cliquez sur votre utilisateur et attendez que la page se charge
- Cliquez sur Modifier > accédez à l'onglet Accès dans la barre de navigation du bas
- Accédez à Rôles > ajoutez le rôle d'intégration Float (géré)
- Cliquez sur Sauvegarder
Veuillez noter : vous aurez maintenant deux rôles d'intégration Float. Gardez également votre rôle d'intégration Float existant sur votre utilisateur. Ne le retirez pas, car vous en aurez besoin si vous devez revenir à votre connexion actuelle.
Créer une intégration :
- Dans NetSuite, accédez à Configuration > Intégrations > Gérer les intégrations > Nouveau
- Sous Nom, utilisez un nom distinct de votre intégration existante, comme « Float Integration Role (Managed) », afin de bien distinguer les deux (veuillez vous assurer de ne pas utiliser le même nom que votre « Float Integration Role » actuel)
- Sous Authentification :
- Cochez Authentification basée sur un jeton
- Décochez TBA : flux d'autorisation
- Sous Oauth 2.0, décochez Octroi de code d'autorisation
- Cliquez sur Sauvegarder et ne quittez pas la page
- Copiez la clé consommateur et le secret consommateur
Créer un jeton d'accès :
- Accédez à Configuration > Utilisateurs/Rôles > Jetons d'accès > Nouveau
- Pour Nom de l'application, sélectionnez l'intégration que vous venez de créer (p. ex., « Float Integration (Managed) »)
- Pour Utilisateur, sélectionnez votre utilisateur
- Pour Rôle, sélectionnez « Float Integration Role (Managed) »
- Le nom du jeton sera généré automatiquement
- Cliquez sur Sauvegarder et ne quittez pas la page
- Copiez l'ID du jeton et le secret du jeton
Soumettre le formulaire de connexion Float :
- Retournez au formulaire Float > saisissez la nouvelle clé consommateur, le nouveau secret consommateur, l'ID du jeton et le secret du jeton
- Cliquez sur Connecter et attendez quelques secondes que la connexion se termine
Comment vérifier votre nouvelle connexion
- Une fois connecté, retournez à Float > Paramètres > Synchronisation comptable
- Cliquez sur Synchroniser et confirmez que vos données NetSuite se transfèrent dans Float sans erreur
Veuillez noter : ne procédez pas au nettoyage tant que vous n'avez pas confirmé que la nouvelle connexion fonctionne de bout en bout. Si quoi que ce soit semble incorrect, votre connexion d'origine demeure active et intacte.
Comment nettoyer votre ancienne connexion
Une fois que vous avez vérifié que la nouvelle connexion fonctionne de façon fiable, vous pouvez retirer l'ancienne :
- Dans NetSuite, accédez à Configuration > Utilisateurs/Rôles > Jetons d'accès, trouvez votre jeton d'origine, et révoquez-le
- Accédez à Configuration > Intégrations > Gérer les intégrations, trouvez votre dossier d'intégration d'origine, et désactivez-le
- Accédez à Configuration > Utilisateurs/Rôles > Gérer les utilisateurs, modifiez votre utilisateur, et retirez le rôle d'intégration Float d'origine de l'onglet Accès
Veuillez noter : nous recommandons de garder votre connexion d'origine en place pendant une période après la migration, afin d'avoir un filet de sécurité pendant que vous confirmez que tout est stable. Ne procédez à ce nettoyage qu'une fois que vous êtes certain que le rôle géré gère correctement les exportations et les synchronisations.