ANS-1090 · SERVICES WEB ET INTéGRATIONS
Comment attribuer un rôle de contact à un client via l’intégration NetSuite ?
Ce guide explique la procédure à suivre pour associer des contacts à des fiches clients et définir leurs rôles spécifiques à l'aide des services Web SuiteTalk de NetSuite.
Solution courte
Pour attribuer un rôle de contact à un client dans NetSuite via l’intégration, utilisez l’opération `attach` au sein des services Web SuiteTalk. Cette opération permet d’associer un enregistrement de contact à un enregistrement client, en spécifiant le rôle de contact souhaité via une requête XML. Veillez à utiliser les versions actuelles du WSDL et tenez compte de la dépréciation des services Web SOAP.
Scénario
Les entreprises ont souvent besoin d’intégrer des systèmes externes à NetSuite pour gérer leurs relations clients. Une exigence courante consiste à associer des contacts spécifiques aux fiches clients et à définir leurs rôles, tels que « Contact principal » ou « Contact de facturation ». Cette intégration garantit que les informations clients sont exhaustives et reflètent fidèlement les relations au sein de l’entreprise.
Solution
Pour attribuer un rôle de contact à une fiche client via l’intégration NetSuite, l’opération attach est utilisée au sein des services Web SOAP de SuiteTalk. Cette opération permet d’associer un contact à un client et de définir son rôle.
Pour plus d’informations sur les opérations attach et detach, veuillez vous reporter à la documentation du Centre d’aide NetSuite :
https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/attachdetach.html
Vous trouverez ci-dessous un exemple de requête XML permettant d’associer un contact ayant un rôle spécifique à un client. Veuillez noter que les espaces de noms WSDL doivent correspondre à une version actuellement prise en charge (par exemple, 2025.2) pour une compatibilité optimale.
xml
<attach xmlns="urn:messages_2025_2.platform.webservices.netsuite.com">
<attachReference xsi:type="ns1:AttachContactReference"
xmlns:ns1="urn:core_2025_2.platform.webservices.netsuite.com">
<ns1:attachTo internalId="176" type="customer" xsi:type="ns1:RecordRef">
<ns1:name xsi:type="xsd:string">Adelina Shonkwiler</ns1:name>
</ns1:attachTo>
<ns1:contact internalId="1467" xsi:type="ns1:RecordRef"/>
<ns1:contactRole internalId="-10" xsi:type="ns1:RecordRef">
<ns1:name xsi:type="xsd:string">Primary Contact</ns1:name>
</ns1:contactRole>
</attachReference>
</attach>Remarque importante :
bien que l’opération attach soit actuellement disponible dans les services Web SOAP de SuiteTalk, NetSuite procède activement à la dépréciation des services Web SOAP, dont la suppression complète est prévue d’ici la version 2028.2. Pour les nouvelles intégrations, NetSuite recommande d’utiliser les services Web REST.
Support expert NetSuite
Besoin d’aide pour cet enjeu NetSuite ?
Accompagnement-conseil et configuration pour Services Web et intégrations