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

Découvrez comment résoudre les erreurs liées à Stripe Connector for NetSuite.

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.

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.
Veuillez saisir des valeurs pour le champ : [Nom du champ].	NetSuite	Le connecteur ne peut pas créer ou mettre à jour un enregistrement NetSuite en raison d’un champ obligatoire manquant sur cet enregistrement. Par exemple, si le connecteur tente de créer une facture qui nécessite le champ `Department`, NetSuite n’autorisera pas le connecteur à exécuter l’action tant qu’il n’y aura pas de valeur pour `Department` dans la demande de création de 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 plusieurs valeurs de champ non valides. Cela peut se produire si la valeur par défaut d’un champ est supprimée ou indisponible. 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.

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.

Erreur	Description
`scn_account_disabled`	Votre intégration Stripe Connector for NetSuite n’est pas activée. Pour l’activer, accédez aux paramètres de l’application et sélectionnez Activer.
`scn_amount_due`	Le champ `Amount Due` est obligatoire sur un formulaire de facture NetSuite. Vous pouvez vérifier que l’option Afficher est sélectionnée pour le champ `Amount Due` en passant de Personnalisation > Formulaires > Formulaires de transaction au formulaire d’enregistrement de facture NetSuite. Modifiez le formulaire dans la sous-liste Champs d’écran.
`scn_amount_too_large`	Le montant dû est supérieur au montant maximum autorisé. Utilisez une quantité moins élevée et réessayez.
`scn_amount_too_small`	Le montant dû est inférieur au montant minimum autorisé. Utilisez une quantité plus élevée et réessayez.
`scn_currency_not_found`	La devise de l’enregistrement de client ou de facture NetSuite n’est pas définie.
`scn_duplicate_key`	Deux processus ont tenté de créer une session Checkout en même temps. Veuillez réessayer.
`scn_invalid_argument`	Le client NetSuite est introuvable. Stripe a bloqué la création d’une session Checkout.
`scn_invalid_customer_record`	L’enregistrement du client n’est pas valide : ce client est peut-être inactif, présente une signature de brouillage non valide, ou son champ personnalisé de page de paiement est manquant.
`scn_invalid_internal_id`	La valeur de l’ID interne est incorrecte. Cette erreur signifie souvent que la formule est mal configurée et qu’il y a un caractère ou un symbole à la fin de l’URL. Par exemple, un `)`. Vérifiez la présence de caractères ou de symboles de fin dans l’URL et indiquez une valeur numérique positive.
`scn_invalid_livemode_value`	La valeur en mode production du lot NetSuite est incorrecte.
`scn_invalid_merchant_account`	Stripe n’a pas trouvé de configuration de compte pour cette entreprise dans le mode production. Cela peut se produire si l’entreprise n’existe pas ou si son intégration au connecteur n’est pas terminée.
`scn_invalid_payment_link_resource`	La ressource du lien de paiement n’est pas valide, car il s’agit soit d’une commande client, soit d’une facture dont le solde est nul.
`scn_invalid_record_type`	Vous avez tenté de créer un lien de paiement à partir d’un enregistrement NetSuite qui n’est pas une facture ni un bon de commande, ce qui n’est pas pris en charge.
`scn_minimum_balance_not_met`	Vous avez tenté de créer une page de paiement client pour un client dont le solde est inférieur au montant de paiement minimal (0,50 USD).
`scn_missing_amount`	Il manque le champ « Montant dû » sur la facture. Activez cette option sur tous les formulaires de facture personnalisés : Accédez à Personnalisation > Formulaires > Formulaires de transaction et filtrez par Type de facture. Modifiez tous les formulaires de facture personnalisés (ceux avec l’option Modifier). Regardez sous l’onglet Champs de l’écran. Assurez-vous d’activer Montant dû sous Afficher. S’il n’existe pas de formulaire personnalisé, créez-en un en cliquant sur Personnaliser dans le formulaire voulu. Enregistrez toutes les modifications.
`scn_no_customer_balance`	Le client NetSuite n’a pas de solde.
`scn_no_guid`	La structure du lien de paiement n’est pas valide. Le lien de paiement doit comporter un GUID et respecter la structure suivante : `/payment/{{{merchant}}}/live/invoice/{{{guid}}}`.
`scn_no_id`	La structure du lien de paiement n’est pas valide. Le GUID doit comporter exactement deux parties, séparées par un trait de soulignement. Par exemple, `F1783B96F2111D47E053972C0C0AAEB5_1234567`.
`scn_no_payment_methods_available`	Aucun type de moyen de paiement n’est valide pour la session Checkout.
`scn_no_resource_lock`	Un verrou de ressource n’a pas pu être acquis, la ressource est probablement en cours de modification par un autre processus. Réessayez ultérieurement.
`scn_ns_concurrent_request_limit_exceeded`	Toutes les connexions NetSuite sont utilisées et la demande était limitée. Réessayez ultérieurement.
`scn_ns_data_center_not_found`	Aucune URL de connexion NetSuite n’a été trouvée. Vérifiez la configuration de votre compte et réessayez.
`scn_ns_invalid_login_attempt`	Échec de la connexion à NetSuite. Vérifiez vos informations de connexion et réessayez. Cette erreur peut parfois se produire avec des informations de connexion correctes.
`scn_ns_record_changed`	Le dossier a été modifié en même temps par un autre processus. Réessayez ultérieurement.
`scn_ns_unexpected_error`	Une erreur inattendue s’est produite dans NetSuite. Réessayez ultérieurement.
`scn_payment_links_not_enabled` ou `scn_customer_payment_page_not_enabled`	La fonctionnalité de page de paiement client ou de page de paiement de facture correspondante n’est pas activée sur ce compte. Stripe a bloqué la création d’une session Checkout.
`scn_recent_payment_found`	La page de paiement du client a été utilisée pour soumettre un paiement réussi au cours des dernières 24 heures. Un seul paiement est autorisé par jour.
`scn_record_not_found`	Stripe utilise l’ID interne fourni dans une URL pour rechercher la facture associée à un lien de paiement dans NetSuite. Cette erreur peut se produire si : Il n’existe pas d’enregistrement de facture avec l’ID interne fourni Il manque un GUID dans le `custbody_stripe_payment_link_guid` champ personnalisé de l’enregistrement de facture Le GUID de l’enregistrement de facture ne correspond pas au GUID de l’URL du lien de paiement
`scn_too_many_parts`	La structure du lien de paiement n’est pas valide. Le GUID doit comporter exactement deux parties, séparées par un trait de soulignement. Par exemple, `F1783B96F2111D47E053972C0C0AAEB5_1234567`.
`scn_unknown_error`	Une erreur inconnue s’est produite. Contactez le support.
`scn_unsupported_record_type`	Vous avez tenté de créer un lien de paiement à partir d’une commande client NetSuite, ce qui n’est pas pris en charge.

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é.

Champs de liens de paiement Stripe

Assurez-vous de configurer correctement les champs suivants.

Champ	Description
Devise	Ce champ est obligatoire et doit figurer sur tous les modèles de facture utilisés avec le lien de paiement Stripe.
Montant dû / Montant restant	Assurez-vous que ce champ figure sur la facture. L’URL affiche un message à l’intention de votre client si ce champ n’est pas affiché, si la valeur est nulle ou si la facture a été payée.

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.