Mappages des champs

Vous utilisez les mappages de champs lorsque vous souhaitez obtenir des rapports supplémentaires ou une catégorisation des enregistrements dans NetSuite, ou pour ajouter des valeurs aux champs obligatoires dont le connecteur a besoin pour créer des enregistrements.

Stripe Connector for NetSuite vous permet d’ajouter des données à vos enregistrements NetSuite de deux manières :

• Champs par défaut (statiques)
• Mappage des champs (dynamiques)

Vous pouvez trouver les deux méthodes de mappage dans l’application du connecteur à la section Settings (paramètres) > Field mappings (mappage des champs). Cela vous permet de personnaliser les données à synchroniser avec NetSuite, par exemple, si vous avez besoin de plus de données dans l’enregistrement NetSuite que ce qui est synchronisé par défaut.

Champs par défaut

Vous pouvez ajouter des valeurs par défaut (valeurs statiques) aux champs de tout enregistrement créé par l’intégration, même s’il n’est pas présent dans Stripe. Si l’un de vos enregistrements NetSuite comporte un champ obligatoire, le connecteur doit inclure une valeur pour ce champ afin de créer l’enregistrement. Dans le cas contraire, la demande de création de l’enregistrement échoue et renvoie une erreur.

Par exemple, si votre formulaire de facture comporte un champ Class obligatoire, vous devez fournir une valeur Class pour que le connecteur puisse créer l’enregistrement. Comme Class est un champ recordReference ou un champ déroulant, le connecteur a besoin de l’ID interne de la valeur à utiliser comme valeur par défaut pour ce champ. Pour utiliser la valeur Corporate avec internalID: 5, vous devez saisir le hachage JSON suivant :

invoice: {
  "klass_id": 5
}

Si le poste de facture requiert le même champ, vous entrez le hachage JSON suivant :

invoice_item: {
  "klass_id": 5
}

Dans les exemples ci-dessus, nous utilisons klass au lieu de class, ce qui est spécifique à l’API de NetSuite pour ce champ. Le suffixe _id indique à NetSuite que la valeur du champ est une recordReference (une liste déroulante). Le suffixe _date est un autre suffixe courant. Il signale un champ de date NetSuite qui doit être au format d’horodatage Unix.

Mappages des champs

Vous pouvez transmettre des mappages de champs (valeurs dynamiques) de Stripe à NetSuite. Pour ce faire, le connecteur récupère les données du champ Stripe et les enregistre dans le champ NetSuite.

Par exemple, votre système intégré à Stripe transmet un company_id aux métadonnées de chaque paiement. Vous souhaitez que cet ID soit transmis à un champ personnalisé sur le paiement client dans NetSuite à des fins de suivi. Pour ce faire, vous configurez le mappage de champ suivant :

customer_payment: {
   "metadata.company_id": "custbody_company_identifier"
}

L’exemple ci-dessus utilise le suffixe _identifier au lieu de _id pour le champ personnalisé dans NetSuite. Les champs personnalisés doivent utiliser une valeur autre que le suffixe _id, car NetSuite utilise _id pour signaler une référence d’enregistrement ou un type de champ déroulant.

Par exemple, un champ par défaut permettant de définir une règle de comptabilisation des revenus sur les postes de vente de services pourrait se présenter comme suit :

"service_sale_item": { "revenue_recognition_rule_id": 123 }

Écraser des personnalisations

Lorsque le connecteur crée un enregistrement dans NetSuite, il mappe un ensemble standard de données de l’enregistrement Stripe avec l’enregistrement NetSuite. Par exemple, l’ID du client et son adresse e-mail dans Stripe sont mappés aux clients NetSuite créés par le connecteur.

Si vous souhaitez remplacer les mappages de données standard du connecteur, vous pouvez utiliser des valeurs de champ par défaut ou des mappages de champ. Si vous avez un mappage par défaut (statique) et un mappage de champ (dynamique) sur le même champ NetSuite, le mappage de champ prime sur le mappage par défaut.

Par exemple, le connecteur mappe le nom du client Stripe au champ NetSuite company_name. Par défaut, NetSuite copie la valeur du company_name dans l’ID de l’entité. Le connecteur ignore cette fonctionnalité et utilise l’ID client de Stripe pour répondre à l’exigence de NetSuite d’utiliser un ID d’entité unique. N’utilisez pas l’ID de client Stripe : nous vous recommandons d’utiliser plutôt un ID unique.

Dans ce cas, vous pouvez remplacer le mappage de données standard en annulant l’ID d’entité. Cela permet à NetSuite de copier le nom du client en tant qu’ID d’entité et d’utiliser le comportement par défaut de NetSuite.

"customer": {
    "entity_id": null
  }