Résoudre les problèmes liés au connecteur

Utilisez ce guide pour résoudre les problèmes liés à Stripe Connector for NetSuite, notamment pour identifier et résoudre les erreurs lors de la synchronisation des enregistrements ou du chargement des pages de paiement.

Pour obtenir de l’aide, contactez votre partenaire de mise en œuvre ou le service Support de Stripe.

Synchroniser les enregistrements de Stripe vers NetSuite

Le tableau suivant décrit les erreurs de données que vous pouvez rencontrer lors de la synchronisation d’enregistrements de Stripe vers NetSuite. Vous pouvez afficher toutes les erreurs dans la fenêtre des enregistrements de synchronisation de l’application de connecteur.

invoice: {
   "department_id": 2
}

Synchroniser les virements avec NetSuite

Les erreurs suivantes peuvent survenir lors de la synchronisation des versements de Stripe vers NetSuite. Vous pouvez consulter les erreurs de synchronisation directement sur la page de détails des versements dans l’application connector.

Compte bancaire de dépôt manquant

Le code d’erreur bank_deposit_account_missing indique que connector n’a pas pu récupérer le compte de dépôt bancaire dans NetSuite. Cela peut se produire si le compte bancaire a été supprimé dans NetSuite, si l’identifiant interne configuré dans les paramètres de connector est incorrect, ou si le rôle Stripe Limited Access ne dispose pas des autorisations nécessaires pour consulter ce compte.

Pour résoudre ce problème :

1. Connectez-vous à votre compte NetSuite.
2. Accédez à Listes > Comptabilité > Comptes.
3. Vérifiez que le compte de dépôt bancaire existe et notez son identifiant interne.
4. Vérifiez que le rôle Stripe Limited Access dispose de l’autorisation pour consulter le compte.
5. Dans l’application Stripe Connector pour NetSuite, accédez à : App settings.
6. Accédez à l’onglet Account Mapping et mettez à jour l’association du compte de dépôt bancaire avec l’identifiant interne correct.

Transactions non synchronisées détectées

Le code d’erreur inventorying_waiting_on_child_records indique qu’une ou plusieurs transactions du virement ne sont pas encore synchronisées avec NetSuite. Le versement virement ne peut pas être créé tant que toutes les transactions associées ne sont pas synchronisées avec succès. Il s’agit d’un état d’attente, pas nécessairement d’une erreur.

Pour résoudre ce problème :

1. Dans l’application du connecteur, accédez à la page de détails du versement.
2. Passez en revue la liste des transactions présentant des problèmes de synchronisation.
3. Pour chaque transaction non synchronisée, vérifiez son statut de synchronisation et le message d’erreur associé.
4. Corrigez toutes les erreurs empêchant la synchronisation (par exemple, client manquant ou problèmes d’association de compte).
5. Relancez la synchronisation si nécessaire. Une fois que toutes les transactions sont synchronisées, le dépôt du versement se poursuivra automatiquement.

Association de compte NetSuite non configurée

Le code d’erreur missing_netsuite_account_mapping indique qu’une association de compte NetSuite requise n’a pas été configurée. Le message d’erreur précise le type de compte manquant (par exemple : comptes de revenus, de frais, de remboursement ou d’ajustement).

Pour résoudre ce problème :

1. Consultez le message d’erreur pour identifier quelle association de compte est manquante.
2. Dans l’application connector, accédez à : Paramètres d’application > Mappage de comptes.
3. Configurez l’association de compte requise et enregistrez vos modifications.
4. Relancez la synchronisation du versement.

Compte de dépôt bancaire NetSuite non configuré

Le code payout_currency_account_missing indique qu’aucun compte de dépôt bancaire n’est configuré pour la devise du versement. Chaque devise dans laquelle vous recevez des versements (USD, EUR, GBP, etc.) nécessite un compte de dépôt bancaire correspondant.

Pour résoudre ce problème :

1. Dans l’application connector, accédez à : Paramètres d’application > Mappage de comptes.
2. Trouvez la section compte de dépôt bancaire.
3. Ajoutez une association de compte de dépôt bancaire pour la devise du versement.
4. Enregistrez vos modifications et relancez la synchronisation du versement.

Filiale NetSuite indisponible

Le code d’erreur subsidary_not_found_likely_permission_issue indique que connector ne peut pas accéder à la filiale NetSuite. Cela est le plus souvent dû à l’une des causes suivantes : le rôle Stripe Limited Access n’a pas l’autorisation de consulter les filiales, la fiche de la filiale a été supprimée ou désactivée, ou aucune filiale n’est configurée pour le compte de dépôt bancaire.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite en tant qu’administrateur et accédez à : Paramètres > Utilisateurs/Rôles > Gérer les rôles.
2. Modifiez le rôle Stripe Limited Access.
3. Dans l’onglet Filiales, assurez-vous que le rôle a accès à toutes les filiales requises.
4. Vérifiez que l’autorisation Listes > Filiales est définie sur au moins sur Affichage.
5. Enregistrez les modifications du rôle et relancez la synchronisation du versement.

Échec de la recherche de filiale NetSuite

Le code d’erreur subsidary_search_failed indique que connector a rencontré une erreur lors de la recherche de filiales enfants dans NetSuite. Cela indique généralement une expiration du réseau, une limitation de débit ou que le rôle Stripe Limited Access n’a pas l’autorisation d’effectuer des recherches subsidiaires.

Pour résoudre ce problème :

1. Patientez quelques minutes, puis relancez la synchronisation du versement.
2. Si l’erreur persiste, connectez-vous à NetSuite en tant qu’administrateur et accédez à Configuration > Utilisateurs/Rôles > Gérer les rôles.
3. Vérifiez que le rôle Stripe Limited Access dispose des autorisations suivantes : Listes > Filiales permission définie sur Complet et Rapports > Rechercher permission activée.
4. Vérifiez que les filiales sont correctement configurées sur le compte de dépôt bancaire.
5. Contactez le service de support Stripe si le problème persiste.

Compte de fonds non déposés NetSuite indisponible

Le code d’erreur undep_fonds_compte_fetch_error indique que connector n’a pas pu récupérer les fonds non déposés du compte NetSuite. Cela peut se produire en raison de problèmes de réseau, ou de problèmes d’autorisation d’accès au compte.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite et accédez à Listes > Comptabilité > Comptes.
2. Recherchez votre compte de fonds non déposés et vérifiez qu’il existe et qu’il est actif.
3. Vérifiez que le rôle Stripe Limited Access dispose de l’autorisation pour consulter ce compte.
4. Dans l’application Connect, accédez à Paramètres application > Mappage des comptes et mettez à jour l’association du compte de fonds non déposés si nécessaire.
5. Relancez la synchronisation du versement.

Compte de fonds non déposés NetSuite non configuré

Le code d’erreur undep_funds_account_not_found indique qu’aucun compte de fonds non déposés n’est configuré dans les paramètres de connector, ou que l’association de compte configurée est vide. Ce compte est nécessaire pour traiter les dépôts de versements.

Pour résoudre ce problème :

1. Dans l’application connector, accédez à : Paramètres d’application > Mappage de comptes.
2. Trouvez le paramètre Compte fonds non déposés.
3. Choisissez le compte de fonds non déposés approprié dans votre plan comptable NetSuite.
4. Enregistrez vos modifications et relancez la synchronisation du versement.

Erreur temporaire NetSuite

Le code d’erreur transient_netsuite_error indique qu’une erreur temporaire s’est produite lors de la communication avec NetSuite, par exemple, un délai d’attente réseau, une limitation de débit ou une indisponibilité temporaire. Connector réessaie automatiquement ces opérations.

Pour résoudre ce problème :

Aucune action requise. Connecteur réessaie automatiquement avec un délai exponentiel. Si l’erreur persiste pendant plus de 24 heures, contactez le support Stripe.

Transactions invalides détectées

Le code d’erreur validating_waiting_on_child_records indique qu’une ou plusieurs transactions du versement ont échoué aux contrôles de validation. Le dépôt du versement ne peut pas être créé tant que toutes les erreurs de validation ne sont pas résolues. Il s’agit d’un état d’attente pendant que vous corrigez les problèmes liés aux transactions.

Pour résoudre ce problème :

1. Dans l’application du connecteur, accédez à la page de détails du versement.
2. Passez en revue la liste des transactions présentant des erreurs de validation.
3. Chaque transaction affiche son erreur de validation spécifique (par exemple : montant incorrect, déjà déposé, enregistrement supprimé ou filiale invalide).
4. Corrigez chaque erreur de validation en suivant les instructions de la section Validation des transactions de versement.
5. Une fois que toutes les erreurs de validation sont résolues, le dépôt du versement se poursuivra automatiquement.

Validation des transactions de versement

Les erreurs de validation suivantes peuvent survenir pour des transactions individuelles dans un versement. Chaque transaction est validée avant que le dépôt ne puisse être créé. Vous pouvez consulter ces erreurs sur la page de détails du versement dans l’application connector.

Déjà versé

Le code d’erreur already_deposited indique que l’enregistrement NetSuite (Cash Sale, Customer Payment, etc.) a le statut « Versé », ce qui signifie qu’il a déjà été inclus dans un dépôt bancaire créé manuellement dans NetSuite, ou que l’enregistrement de paiement a été mis à jour vers un compte comptable différent des Undeposited Funds. NetSuite n’autorise pas qu’un même enregistrement soit déposé deux fois.

Pour résoudre ce problème :

1. Connectez-vous à votre compte NetSuite.
2. Accédez à l’un des paiements clients marqués comme already_deposited.
3. Vérifiez que le compte du paiement est défini sur Undeposited Funds.
   • Si c’est le cas, vérifiez le champ ID de versement pour identifier le dépôt bancaire dans lequel il a été inclus manuellement.
     • Accédez à ce dépôt bancaire et supprimez cette transaction du dépôt.
   • Sinon, mettez à jour le compte du paiement client pour qu’il soit sur Fonds non déposés.
4. Relancez la synchronisation du versement.
5. Si l’enregistrement a été correctement déposé dans un virement précédent :
   • La transaction Stripe pourrait devoir être exclue de la synchronisation des versements.
   • Contactez le [service de support Stripe](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D) pour obtenir de l’aide sur le rapprochement.

Enregistrement NetSuite supprimé

Le code d’erreur deleted_netsuite_record indique que l’enregistrement NetSuite lié à cette transaction Stripe a été supprimé, désactivé ou est introuvable. Cela peut se produire si quelqu’un a supprimé manuellement l’enregistrement, si un script ou un workflow l’a supprimé, si l’enregistrement appartient à une autre filiale, ou si l’enregistrement a été annulé.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite et vérifiez si l’enregistrement a été supprimé intentionnellement en consultant les System Notes ou les pistes d’audit.
2. Si la suppression est accidentelle, recréez manuellement l’enregistrement dans NetSuite avec le bon montant et les informations correctes.
3. Contactez le [service de support Stripe](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D) pour relier la transaction Stripe au bon enregistrement NetSuite.
4. Relancez la synchronisation du versement.

Enregistrement NetSuite déjà lié à une autre transaction

Le code d’erreur duplicate_netsuite_record_in_payout indique que le même identifiant interne d’enregistrement NetSuite est lié à plusieurs transactions Stripe dans ce versement. Chaque transaction Stripe doit être associée à un enregistrement NetSuite unique. Cela se produit généralement lorsqu’un enregistrement est lié manuellement de manière incorrecte ou lorsque des synchronisations en double créent des associations en double. Le message d’erreur indique quel ID de ressource Stripe est en conflit et l’ID de l’enregistrement NetSuite partagé.

Pour résoudre ce problème :

1. Consultez le message d’erreur pour identifier la transaction Stripe en conflit et l’ID de l’enregistrement NetSuite partagé.
2. Déterminez quelle transaction Stripe doit rester liée à l’enregistrement NetSuite existant.
3. Pour les autres transactions :
   • Créez de nouveaux enregistrements dans NetSuite correspondant aux détails de la transaction Stripe.
4. Utilisez l’outil de remplacement manuel dans le menu de l’application SCN pour lier la transaction au bon enregistrement NetSuite.
5. Si cela ne fonctionne pas, contactez le service de support Stripe pour mettre à jour les associations d’enregistrements.
6. Relancez la synchronisation du versement.

Filiale non valide

ici une traduction claire et orientée support :le code d’erreur invalid_subsidiary indique que la filiale de l’enregistrement NetSuite ne correspond pas aux filiales valides pour le compte de dépôt bancaire. Cela peut se produire dans des comptes NetSuite à filiales multiples lorsque l’enregistrement est créé sous une filiale différente, que la configuration des filiales du compte de dépôt bancaire change, ou qu’un workflow modifie la filiale de l’enregistrement.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite et localisez l’enregistrement NetSuite lié à cette transaction.
2. Contrôlez le champ Filiale de l’enregistrement.
3. Comparez-le avec les filiales configurées sur votre compte de dépôt bancaire.
4. Modifiez soit l’enregistrement NetSuite pour utiliser une filiale valide, soit mettez à jour le compte de dépôt bancaire pour inclure cette filiale.
5. Modifier la filiale d’un enregistrement peut avoir des conséquences comptables. Consultez votre équipe comptable.
6. Relancez la synchronisation du versement.

Incohérence du compte de fonds non déposés

Le code d’erreur undep_funds_account_mismatch indique que le compte de fonds non déposés de l’enregistrement NetSuite ne correspond pas au compte configuré dans vos paramètres connector. Tous les enregistrements d’un dépôt de versement doivent être associés au même compte de fonds non déposés pour que le dépôt soit correctement équilibré.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite et localisez l’enregistrement NetSuite lié à cette transaction.
2. Vérifiez le champ Compte sur la ligne de l’enregistrement.
3. Comparez-le au compte de fonds non déposés configuré dans vos paramètres connector.
4. Modifiez soit l’enregistrement NetSuite pour utiliser le compte de fonds non déposés correct, soit mettez à jour vos paramètres connector pour correspondre au compte utilisé sur les enregistrements.
5. Modifier le compte d’un enregistrement peut nécessiter des écritures comptables pour corriger les soldes. Consultez votre équipe comptable.
6. Relancez la synchronisation du versement.

Incohérence du montant de la transaction

Le code d’erreur unequal_amounts indique que le montant de la transaction dans Stripe ne correspond pas au montant de l’enregistrement NetSuite associé. Les montants doivent correspondre exactement pour que le dépôt du versement soit équilibré. Les causes fréquentes incluent des modifications manuelles du montant de l’enregistrement NetSuite, des workflows ou scripts qui modifient les montants, des différences liées à la conversion de devises, ainsi que des ajustements de taxes ou de frais appliqués dans NetSuite.

Pour résoudre ce problème :

1. Dans l’application Connector, notez le montant exact de la transaction Stripe.
2. Connectez-vous à NetSuite et localisez l’enregistrement NetSuite lié à cette transaction.
3. Comparez le champ Total ou Montant avec le montant indiqué dans Stripe.
4. Identifiez la source de l’écart en vérifiant les System Notes pour les modifications manuelles, ou en consultant les journaux de workflows et de scripts pour les changements automatisés.
5. Corrigez l’enregistrement NetSuite pour qu’il corresponde au montant Stripe, ou si le montant NetSuite est intentionnellement différent, contactez le support Stripe pour obtenir des conseils.
6. Relancez la synchronisation du versement.

Échec de la recherche de dépôt

Le code d’erreur deposit_search_failed indique que connector n’a pas pu rechercher les enregistrements de dépôt dans NetSuite pour vérifier si un enregistrement a déjà été déposé. Cela peut être causé par des problèmes d’autorisation ou de connectivité.

Pour résoudre ce problème :

1. Connectez-vous à NetSuite en tant qu’administrateur et accédez à : Paramètres > Utilisateurs/Rôles > Gérer les rôles.
2. Modifiez le rôle Stripe Limited Access.
3. Vérifiez que le rôle dispose de l’autorisation Transactions > Effectuer des dépôts définie au minimum sur Affichage.
4. Vérifiez que l’autorisation Rapports > Rechercher est activée.
5. Relancez la synchronisation du versement. Si l’erreur persiste, contactez le support Stripe.

Autres erreurs de versement

Si vous rencontrez l’un des codes d’erreur suivants, ils indiquent des problèmes internes que le connecteur tentera soit de résoudre automatiquement, soit qui nécessitent l’intervention du support Stripe :

• unexpected_breakage_error : une erreur interne inattendue s’est produite.
• unexpected_subsidiary_initialization_error : une erreur s’est produite lors de l’initialisation des données de filiale.
• multiple_successful_translations_found : un problème d’intégrité des données où la même transaction a été synchronisée plusieurs fois.

Pour ces erreurs, contactez le support Stripe avec votre ID de versement (par exemple, po_xxx) et le code d’erreur.

Charger la page de paiement de facture ou la page de paiement client

Le tableau suivant décrit les erreurs que vous pouvez rencontrer lorsque vous tentez de charger une page de paiement de facture ou une page de paiement client. Vous pouvez afficher toutes les erreurs dans la fenêtre des enregistrements de synchronisation de l’application du connecteur.

Paiements en double

Stripe et NetSuite gèrent différemment les paiements en double. Alors que Stripe autorise le trop-perçu sur une facture, NetSuite renvoie une erreur si un client tente d’effectuer un paiement sur une facture entièrement payée. Par défaut, si un paiement en double se produit dans Stripe, le connecteur ne synchronisera pas le paiement car NetSuite n’autorise pas un deuxième paiement.

Si un doublon de paiement entraîne une erreur lorsque le connecteur tente de rapprocher le paiement pendant l’automatisation des versements, vous pouvez résoudre le problème en supprimant manuellement le premier paiement de la facture pour autoriser le second paiement.

Vous pouvez également permettre au connecteur de gérer les doublons de paiement pour vous. Si vous avez une facture NetSuite entièrement payée, le connecteur transfère les paiements en double sous forme de paiements non appliqués dans NetSuite. Le paiement non appliqué comprend la note suivante : Stripe Payment Error: could not apply to invoice XYZ. (Erreur de paiement Stripe : impossible d’appliquer à la facture XYZ.) Vous pouvez ensuite utiliser ces paiements non appliqués sur une autre facture, ou rembourser les paiements manuellement dans Stripe. Pour rechercher les paiements en double dans NetSuite, créez une recherche enregistrée en utilisant la note comme critère.

Vous pouvez permettre au connecteur de gérer les paiements en double de la manière suivante :

• Autorisez par défaut tous les paiements en double dans le connecteur. Pour ce faire, allez dans les paramètres de votre connecteur et activez Autoriser les paiements de facture en double dans les paramètres de votre application Stripe. Contactez votre partenaire d’implémentation pour comprendre toutes les implémentations comptables et techniques avant qu’il n’active cette fonctionnalité pour vous.

• À l’aide de l’API Stripe, ajoutez le champ netsuite_allow_duplicate: true dans les métadonnées d’un paiement Stripe dupliqué.

Champs de liens de paiement Stripe

Assurez-vous de configurer correctement les champs suivants.

Champ GUID masqué

Le champ Hidden GUID ne crée pas automatiquement des ID aléatoires pour les factures créées avant l’installation des liens de paiement groupés. Cela inclut les factures créées à partir de commandes client précédentes.

Si vous recevez un grand nombre d’erreurs en raison de cette fonctionnalité par défaut, contactez votre représentant Stripe.

Mises à jour groupées

Lorsque vous exécutez des mises à jour groupées, la configuration Default Value est réinitialisée aux paramètres par défaut. Vous devez reconfigurer la configuration Default Value pour qu’elle fonctionne à nouveau correctement pour vos clients.

Autorisations

Si vous avez besoin d’autorisations spécifiques pour accéder aux factures, assurez-vous d’ajouter ces autorisations au rôle Stripe Limited Access (par exemple, en accédant à Listes > Informations fiscales > Complet). Le connecteur peut ainsi accéder aux informations de facture pour créer une page de paiement de facture.

Accéder aux rôles

Le GUID peut disparaître après l’enregistrement pour certains rôles d’accès disposant de moins d’autorisations qu’un administrateur. Par exemple, l’accès View est insuffisant. Pour attribuer les autorisations appropriées, rendez-vous dans le champ personnalisé Stripe Payment Page Guid (custbody_stripe_payment_link_guid), sélectionnez Access, ajoutez le rôle et accordez-lui l’accès Edit dans le champ personnalisé.

Synchronisation en masse des enregistrements

Utilisez l’outil de support pour ajouter les enregistrements Stripe à resynchroniser et suivre l’avancement du processus.

État de synchronisation

1. Dans le Dashboard, accédez à Paramètres > Applications installées > Stripe Connector for NetSuite > Outils de service de support.

2. Cliquez sur Synchroniser les enregistrements.

3. Collez un ou plusieurs identifiants de ressources Stripe, séparés par des virgules. Le nombre maximal d’identifiants que vous pouvez soumettre en une seule fois est indiqué dans l’interface utilisateur.

4. Cliquez sur Envoyer.

Après avoir cliqué sur Envoyer, les ID acceptés sont immédiatement ajoutés à la file d’attente. Les ID rejetés apparaissent dans une liste d’erreurs pour l’une des raisons suivantes :

• Résolvez le problème (par exemple, corrigez un ID non valide).
• Soumettez à nouveau les ID qui ont échoué, si nécessaire.

Afficher l’état de synchronisation

Pour afficher l’état de synchronisation, depuis la page Outils de service de support, cliquez sur Afficher l’état de synchronisation, puis collez les ID séparés par des virgules que vous souhaitez vérifier, et cliquez sur Envoyer.

Vérifier les sections suivantes pour comprendre les états des files d’attente, les états de synchronisation et les types d’erreurs.

États des files d’attente

État de synchronisation

Types d’erreur

Priorisé

La colonne Priorisé indique que la synchronisation de l’enregistrement concerne l’ID fourni et est prioritaire par rapport aux autres synchronisations d’enregistrement.