Résolution des erreurs

Comment gérer les erreurs avec le Stripe Connector for NetSuite.

Si vous rencontrez des problèmes lors de la synchronisation des enregistrements de Stripe vers NetSuite, vous pouvez utiliser la liste ci-dessous pour identifier et résoudre les erreurs. Il se peut que vous deviez modifier NetSuite, Stripe ou le connecteur, puis synchroniser manuellement l’enregistrement.

Vous pouvez consulter toutes les erreurs dans la fenêtre des enregistrements de synchronisation de l’application du connecteur.

Erreurs de données

Le tableau suivant répertorie les erreurs qui peuvent survenir lors de la synchronisation des enregistrements avec NetSuite.

Erreur	Source	Description	Résolution
NetSuite System Error: Unable to find a matching line for sub-list apply with key: [doc,line] and value: [12345,null].	NetSuite	Le connecteur ne peut pas créer un enregistrement en tant qu’entrée de paiement (sous-liste) dans un enregistrement NetSuite existant. Par exemple, le connecteur ne peut pas créer et appliquer un paiement à une facture existante qui a déjà été entièrement payée. Cette erreur peut également se produire si le montant du mémo de crédit est inférieur au montant du remboursement, ce qui peut arriver si la taxe ou un autre montant modifie la configuration de l’automatisation dans NetSuite.	Inspectez l’enregistrement NetSuite dans le message d’erreur pour voir pourquoi l’entrée de paiement n’a pas abouti. Si la raison n’est toujours pas claire, vous pouvez créer manuellement l’entrée de paiement pour aider à identifier la cause première.
Please enter value(s) for: [Field Name].	NetSuite	Le connecteur ne peut pas créer ou mettre à jour un enregistrement NetSuite en raison de l’absence d’un champ obligatoire dans cet enregistrement. Par exemple, si le connecteur tente de créer une facture pour laquelle le champ `Department` est obligatoire, NetSuite n’autorisera pas le connecteur à terminer l’action tant qu’il n’y aura pas de valeur pour `Department` dans la demande de création de la facture.	Ajoutez une valeur par défaut pour le champ. Pour ce faire, accédez à la page Paramètres de l’application > Mappages de champs > Valeurs par défaut des champs dans le connecteur. Celui-ci utilise les valeurs par défaut lors de la création d’enregistrements de ce type. Les valeurs par défaut des champs utilisent le format JSON. Par exemple, pour ajouter une valeur par défaut de 2 pour `Department` sur vos factures, ajoutez ce qui suit : `invoice: { "department_id": 2 }`
You have entered an Invalid Field Value [value] for the following field: [field].	NetSuite	Le connecteur ne peut pas créer ou mettre à jour un enregistrement NetSuite en raison d’une ou de plusieurs valeurs de champ non valides. Cela peut se produire si un champ par défaut utilise une valeur qui a été supprimée ou rendue indisponible pour une raison quelconque. Par exemple, `Class` peut être un champ obligatoire pour les versements. Lors de l’inscription des utilisateurs, vous ajoutez un champ Corporate (entreprise) par défaut avec un ID interne de 5 pour répondre à cette exigence. Au bout d’un certain temps, la valeur Corporate (ID : 5) est supprimée. Lorsque le connecteur tente de créer un autre versement bancaire, il échoue en affichant le message d’erreur suivant : `You have entered an Invalid Field Value 'Corporate' for the following field: Class` (Vous avez saisi une valeur ‘Corporate’ non valide pour le champ : Class)	Modifiez la valeur par défaut pour utiliser un identifiant de champ valide. Pour ce faire, accédez à la page Paramètres de l’application > Mappages de champs > Valeurs par défaut des champs dans le connecteur.
Invalid record referenced in metadata key `netsuite_metadata_id` (012345).	Connecteur	Le connecteur ne peut pas synchroniser l’enregistrement en raison d’un enregistrement NetSuite supprimé que vous avez précédemment synchronisé ou lié. Par exemple, si vous liez un remboursement Stripe à une note de crédit et que vous supprimez ensuite cette note, vous devez mettre à jour la clé de métadonnées du remboursement Stripe (`netsuite_credit_memo_id`) pour qu’elle pointe vers le bon ID interne de note de crédit NetSuite.	Mettez à jour la clé de métadonnées de remboursement `netsuite_credit_memo_id` pour qu’elle pointe vers le nouvel ID interne du mémo de crédit.
Charge amount 100.0 is different than the amount due on the corresponding invoice. Transaction ID:INV12345 (ID 1234567) amount due: 99.0.	Connecteur	Le paiement de la facture dépasse le montant dû indiqué sur la facture NetSuite. Cela peut se produire si le connecteur synchronise de manière incorrecte la facture Stripe avec NetSuite et que vous n’avez pas encore configuré la gestion des taxes. Cela peut également se produire si vous modifiez le total de la facture NetSuite entre le moment où vous avez envoyé la facture et le moment où le client a soumis le paiement.	Si votre compte de connecteur n’est pas configuré pour gérer les taxes, contactez votre partenaire d’implémentation pour la configuration. Si vous avez modifié manuellement une facture NetSuite créée par le connecteur, vous devez mettre à jour la facture pour utiliser le montant d’origine.

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 paiement en double 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é.