Aide CRM

Méthode insertRecords

Objectif

Vous pouvez utiliser la méthode insertRecords pour insérer des enregistrements dans le module Zoho CRM voulu.

Note importante : utilisez la méthode POSTpour transmettre ces paramètres au lieu de la méthode GET.

URL de demande

Format XML :

https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=AuthToken&scope=crmapi&xmlData=Your XML Data 

Paramètres de la demande

ParamètreType de donnéesDescription
authtoken*ChaîneChaîne alphanumérique chiffrée utilisée pour l'authentification de vos identifiants Zoho.
scope*ChaîneDéfinir l'étendue comme crmapi
xmlData*XMLIl s'agit d'une chaîne XML et le format doit être identique à celui de getRecords au format XML des documents récupérés.
wfTriggerChamps booléensDéfinir la valeur sur true pour déclencher la règle de workflow lors de l'insertion de l'enregistrement dans le compte CRM. Par défaut, la valeur de ce paramètre est false.
duplicateCheckEntierDéfinir la valeur sur 1 pour vérifier les enregistrements en double et envoyer un message d'erreur ou sur 2 pour vérifier les enregistrements en double, le cas échéant, mettre à jour les mêmes.
isApprovalChamps booléensPar défaut, les enregistrements sont insérés directement. Pour conserver les enregistrements en mode d'approbation, définissez la valeur sur true. Vous pouvez utiliser ces paramètres pour les modules Leads, Contacts et Dossiers.
newFormatEntiernewFormat=1 : pour exclure les champs avec des valeurs « null » lors de l'insertion de données à partir de votre compte CRM.
newFormat=2 : pour inclure des champs avec des valeurs « null » lors de l'insertion de données à partir de votre compte CRM.
versionEntierversion = 1 : (Valeur par défaut) Ceci permettra de récupérer les réponses en fonction de l'API mise en œuvre précédemment, c.-à-d. avant les améliorations apportées.
version = 2 : permet de récupérer les réponses en fonction de l'API la plus récente.
version = 4 : déclenche la fonctionnalité de vérification des doublons pour plusieurs enregistrements.

* - Paramètre obligatoire

Remarque :

  • consultez la page des Notes de mise à jour  pour en savoir plus sur les améliorations apportées à la mise en œuvre de l'API.

Champs de vérification des doublons

Nom du moduleChamps de vérification des doublons
LeadsEmail
ContactsEmail
ComptesNom du compte
Clients potentielsNom du client potentiel
CampagnesNom de la campagne
DossiersObjet
ProduitsNom du produit
FournisseursNom du fournisseur
DevisObjet
Commandes clientsObjet
Commandes fournisseursObjet
FacturesObjet
Module PersonnaliséNom du Module Personnalisé

Notes supplémentaires

  • Lors de l'insertion de données sur votre compte Zoho CRM, la sécurité fondée sur les rôles (rôles, profiles, sécurité au niveau des champs de données et règles de partage des données) est appliquée. Par conséquent, l'utilisation de l'ID d'utilisateur avec le rôle de plus haut niveau (ex. : PDG) et de profil de plus haut niveau (ex. : administrateur). Assurez-vous également que tous les champs sont activés dans les paramètres de sécurité au niveau des champs. Pour les paramètres de sécurité fondée sur les rôles, reportez-vous à Administration de la sécurité  lors de la génération du ticket d'authentification.
  • Lors de l'insertion de données, assurez-vous que la date et l'heure sont dans les formats mm/jj/aaaa et  aaaa-mm-jj hh:mm:ss respectivement.

Exemples

Insérer des enregistrements dans Zoho CRM à partir d'applications tierces

Format de l'URL :
https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData=Your XML Data

Sample Request:

https://crm.zoho.com/crm/private/xml/Leads/insertRecords?
newFormat=1
&authtoken=Auth Token
&scope=crmapi
&xmlData=

<Leads>
<row no="1">
<FL val="Lead Source">Web Download</FL>
<FL val="Company">Your Company</FL>
<FL val="First Name">Hannah</FL>
<FL val="Last Name">Smith</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Home Phone">0987654321</FL>
<FL val="Other Phone">1212211212</FL>
<FL val="Fax">02927272626</FL>
<FL val="Mobile">292827622</FL>
</row>
</Leads>

Exemple de données XML pour un lead

<Leads>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Lead Owner">Scott@zohotest.com</FL>
<FL val="Company">Zoho</FL>
<FL val="First Name">Peter</FL>
<FL val="Last Name">John</FL>
<FL val="Designation">CEO</FL>
<FL val="Email">john@test.com</FL>
<FL val="Phone">04422334455</FL>
<FL val="Fax">98889</FL>
<FL val="Mobile">09999999999</FL>
<FL val="Website">www.sample.com</FL>
<FL val="Lead Source">External Referral</FL>
<FL val="Lead Status">Contacted</FL>
<FL val="Industry">Financial Services</FL>
<FL val="No of Employees">100</FL>
<FL val="Annual Revenue">100.0</FL>
<FL val="Email Opt Out">true</FL>
<FL val="Skype ID">peter</FL>
<FL val="Salutation">Mr.</FL>
<FL val="Street">Street One</FL>
<FL val="City">Chennai</FL>
<FL val="State">Tamil Nadu</FL>
<FL val="Zip Code">6000001</FL>
<FL val="Country">India</FL>
<FL val="Description">Sample Description.</FL>
</row>
</Leads>

Exemple de données XML pour une tâche avec recherche de lead

<Tasks>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Task Owner">Scott@zohotest.com</FL>
<FL val="Subject">Demo Call</FL>
<FL val="Due Date">11/23/2009</FL>
<FL val="SEID">2000000018003</FL>
<FL val="SEMODULE">Leads</FL>
<FL val="Status">In Progress</FL>
<FL val="Priority">Highest</FL>
<FL val="Send Notification Email">false</FL>
<FL val="Description">Sample Desc</FL>
</row>
</Tasks>

Exemple de données XML pour une tâche avec recherche de contact et de compte

<Tasks>
<row no="1">
<FL val="SMOWNERID">2000000016714</FL>
<FL val="Task Owner">Scott@zohotest.com</FL>
<FL val="Subject">Demo Call</FL>
<FL val="Due Date">11/23/2009</FL>
<FL val="CONTACTID">2000000018443</FL>
<FL val="SEID">2000022218013</FL>
<FL val="SEMODULE">Accounts</FL>
<FL val="Status">In Progress</FL>
<FL val="Priority">Highest</FL>
<FL val="Send Notification Email">false</FL>
<FL val="Description">Sample Desc</FL>
</row>
</Tasks>

Insérer des notes et se rattacher au module principal

Format XML :

https://crm.zoho.com/crm/private/xml/Notes/insertRecords?newFormat=1&authtoken=Auth Token
&scope=crmapi
&xmlData=

<Notes>
<row no="1">
<FL val="entityId">2000000078001</FL>
<FL val="Note Title">Zoho CRM Sample Note</FL>
<FL val="Note Content">This is sample content to test Zoho CRM API</FL>
</row>
</Notes>

Dans ce cas, entityID est l'ID unique de l'enregistrement primaire (lead, compte, contact, etc.)

Attribuer un propriétaire à l'enregistrement

Lorsque vous insérez un enregistrement via l'API, assurez-vous que vous indiquez l'adresse e-mail ou l'ID d'utilisateur du propriétaire de l'enregistrement. Si vous utilisez le nom du propriétaire de l'enregistrement, l'enregistrement sera attribué aux identifiants de connexion par défaut utilisés dans le jeton d'authentification. Si vous souhaitez utiliser l'ID d'utilisateur pour définir le propriétaire de l'enregistrement, ajoutez l'étiquette <FL val="SMOWNERID">userID</FL> à vos données XML.

Remarque :

  • Dans les exemples suivants, remplacez les valeurs pour authotoken et scope par celles que vous avez générées.

Dossiers

https://crm.zoho.com/crm/private/xml/Cases/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Cases>
<row no="1">
<FL val="Case Origin">Phone</FL>
<FL val="Status">Escalated</FL>
<FL val="Subject">New Case</FL>
<FL val="Account Name">Account for Cases</FL>
<FL val="WHOID">508020014316189251</FL>
</row>
</Cases>

Remarque :

  • Le champ WHOID fait référence au champ Lié à dans le module Dossiers. Indiquez l'ID de l'enregistrement que vous souhaitez associer aux dossiers en tant que valeur du champ Lié à dans le champ WHOID.

Tâches

https://crm.zoho.com/crm/private/xml/Tasks/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Tasks>
<row no="1">
<FL val="Subject">Call</FL>
<FL val="Due Date">2009-04-20</FL>
<FL val="Status">Deferred</FL>
<FL val="CONTACTID">2000000017017</FL>
</row>
</Tasks>

Événements

https://crm.zoho.com/crm/private/xml/Events/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Events>
<row no="1">
<FL val="Subject">Conference</FL>
<FL val="Start DateTime">2009-08-04 01:00:00</FL>
<FL val="End DateTime">2009-08-05 01:00:00</FL>
<FL val="Venue">United States</FL>
<FL val="Send Notification Email">True</FL>
</row>
</Events>

Événements avec mappage de contacts et de dossiers

https://crm.zoho.com/crm/private/xml/Events/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Events>
<row no="1">
<FL val="Subject">Conference</FL>
<FL val="Start DateTime">2009-09-24 01:00:00</FL>
<FL val="End DateTime">2009-09-25 01:00:00</FL>
<FL val="Venue">Chennai</FL>
<FL val="CONTACTID">2000000055003</FL>
<FL val="SEID">2000000055007</FL>
<FL val="SEMODULE">Cases</FL>
</row>
</Events>

Comptes

https://crm.zoho.com/crm/private/xml/Accounts/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Accounts>
<row no="1">
<FL val="Account Name">Zillum</FL>
<FL val="Website">www.zillum.com</FL>
<FL val="Employees">200</FL>
<FL val="Ownership">Private</FL>
<FL val="Industry">Real estate</FL>
<FL val="Fax">99999999</FL>
<FL val="Annual Revenue">20000000</FL>
</row>
</Accounts>

Contacts

https://crm.zoho.com/crm/private/xml/Contacts/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Contacts>
<row no="1">
<FL val="First Name">Scott</FL>
<FL val="Last Name">James</FL>
<FL val="Email">test@test.com</FL>
<FL val="Department">CG</FL>
<FL val="Phone">999999999</FL>
<FL val="Fax">99999999</FL>
<FL val="Mobile">99989989</FL>
<FL val="Assistant">John</FL>
</row>
</Contacts>

Commandes clients

Remarque :

    Une valeur pour l'ID du produit est obligatoire.

https://crm.zoho.com/crm/private/xml/SalesOrders/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<SalesOrders>
<row no="1">
<FL val="Subject">Zillium - SO</FL>
<FL val="Due Date">2009-03-10</FL>
<FL val="Sub Total">48000.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">48000.0</FL>
<FL val="Billing Street">test</FL>
<FL val="Shipping Street">test</FL>
<FL val="Billing City">test</FL>
<FL val="Shipping City">test</FL>
<FL val="Billing State">test</FL>
<FL val="Shipping State">test</FL>
<FL val="Billing Code">223</FL>
<FL val="Shipping Code">223</FL>
<FL val="Billing Country">test</FL>
<FL val="Shipping Country">test</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">2000000017001</FL>
<FL val="Unit Price">10.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Total">123.0</FL>
<FL val="Discount">1.23</FL>
<FL val="Total After Discount">121.77</FL>
<FL val="List Price">123.0</FL>
<FL val="Net Total">121.77</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Description">Test By Zoho</FL>
</row>
</SalesOrders>

Devis

Remarque :

  • Une valeur pour l'ID du produit est obligatoire.

https://crm.zoho.com/crm/private/xml/Quotes/insertRecords?authtoken=Auth Token&scope=crmapi
&newFormat=1
&xmlData=

<Quotes>
<row no="1">
<FL val="Subject">Zillium - Quote</FL>
<FL val="Due Date">2009-03-10</FL>
<FL val="Sub Total">48000.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">48000.0</FL>
<FL val="Billing Street">test</FL>
<FL val="Shipping Street">test</FL>
<FL val="Billing City">test</FL>
<FL val="Shipping City">test</FL>
<FL val="Billing State">test</FL>
<FL val="Shipping State">test</FL>
<FL val="Billing Code">223</FL>
<FL val="Shipping Code">223</FL>
<FL val="Billing Country">test</FL>
<FL val="Shipping Country">test</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">2000000017001</FL>
<FL val="Unit Price">10.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Total">123.0</FL>
<FL val="Discount">1.23</FL>
<FL val="Total After Discount">121.77</FL>
<FL val="List Price">123.0</FL>
<FL val="Net Total">121.77</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Description">Test By Zoho</FL>
</row>
</Quotes>

Exemple d'un devis avec plusieurs produits :

https://crm.zoho.com/crm/private/xml/Quotes/insertRecords?authtoken=Auth Token&scope=crmapi
&xmlData=

<Quotes>
<row no="1">
<FL val="Subject">TEST</FL>
<FL val="Quote Stage">Draft</FL>
<FL val="Carrier">FedEX</FL>
<FL val="ACCOUNTID">269840000000150037</FL>
<FL val="Account Name">phone account11 9pm</FL>
<FL val="SMOWNERID">269840000000034003</FL>
<FL val="Quote Owner">TEST</FL>
<FL val="SMCREATORID">269840000000034003</FL>
<FL val="Created By">TEST</FL>
<FL val="MODIFIEDBY">269840000000034003</FL>
<FL val="Modified By">TEST</FL>
<FL val="Created Time">2010-10-19 16:16:41</FL>
<FL val="Modified Time">2010-10-19 16:16:56</FL>
<FL val="Sub Total">23.0</FL>
<FL val="Tax">0.0</FL>
<FL val="Adjustment">0.0</FL>
<FL val="Grand Total">23.0</FL>
<FL val="Product Details">
<product no="1">
<FL val="Product Id">269840000000136287</FL>
<FL val="Product Name">prd1</FL>
<FL val="Unit Price">0.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Quantity in Stock">0.0</FL>
<FL val="Total">23.0</FL>
<FL val="Discount">0.0</FL>
<FL val="Total After Discount">23.0</FL>
<FL val="List Price">23.0</FL>
<FL val="Net Total">23.0</FL>
<FL val="Tax">0.0</FL>
</product>
<product no="2">
<FL val="Product Id">269840000000128149</FL>
<FL val="Product Name">prd2</FL>
<FL val="Unit Price">0.0</FL>
<FL val="Quantity">1.0</FL>
<FL val="Quantity in Stock">0.0</FL>
<FL val="Total">23.0</FL>
<FL val="Discount">0.0</FL>
<FL val="Total After Discount">23.0</FL>
<FL val="List Price">23.0</FL>
<FL val="Net Total">23.0</FL>
<FL val="Tax">0.0</FL>
</product>
</FL>
<FL val="Terms and Conditions">Test by Zoho</FL>
<FL val="Discount">0.0</FL>
<FL val="Date Field">07/21/2010</FL>
</row>
</Quotes>

Insérer des appels avec des recherches de contacts et de comptes

<Calls>
<row no="1">
<FL val="SMOWNERID">2000000018005</FL>
<FL val="Subject">Product Support</FL>
<FL val="Call Type">Inbound</FL>
<FL val="Call Purpose">Prospecting</FL>
<FL val="CONTACTID">2000000018001</FL>
<FL val="SEID">2000000018003</FL>
<FL val="SEMODULE">Accounts</FL>
<FL val="Call Start Time">2011-06-10 22:10:00</FL>
<FL val="Call Duration">60:00</FL>
<FL val="Description">Required Product Demo</FL>
<FL val="Billable">true</FL>
<FL val="Call Result">Successful</FL>
</row>
</Calls>

Insérer des appels avec des recherches de leads

<Calls>
<row no="1">
<FL val="SMOWNERID">2000000018005</FL>
<FL val="Subject">Demo</FL>
<FL val="Call Type">Inbound</FL>
<FL val="Call Purpose">Prospecting</FL>
<FL val="SEID">2000000017201</FL>
<FL val="SEMODULE">Leads</FL>
<FL val="Call Start Time">2011-06-10 22:10:00</FL>
<FL val="Call Duration">60:00</FL>
<FL val="Description">Demo Call</FL>
<FL val="Billable">true</FL>
<FL val="Call Result">Successful</FL>
</row>
</Calls>

Utilisation de « CDATA »

Objectif : considérer les caractères spéciaux comme du texte brut et NON PAS comme des données XML

Format de l'URL :
https://crm.zoho.com/crm/private/xml/Contacts/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= vos données XML

Exemple de données XML :

en tant que POST :

<Contacts>
<row no="1">
<FL val="First Name">Amy</FL>
<FL val="Last Name">Dawson</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Mobile">292827622</FL>
<FL val="Account Name"><![CDATA["A & A"]]></FL>
</row>
</Contacts>

en tant que GET :

<Contacts>
<row no="1">
<FL val="First Name">Amy</FL>
<FL val="Last Name">Dawson</FL>
<FL val="Email">testing@testing.com</FL>
<FL val="Title">Manager</FL>
<FL val="Phone">1234567890</FL>
<FL val="Mobile">292827622</FL>
<FL val="Account Name"><![CDATA["A %26 A"]]></FL>
</row>
</Contacts>

Remarque :

  • "%26" sera considéré comme « & »

Insérer plusieurs enregistrements

Format de l'URL : https://crm.zoho.com/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= vos données XML

Exemple de données XML :

<Leads>
   <row no="1"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="2"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="3"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="4"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="5"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="6"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="7"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="8"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="9"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
   <row no="10"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
 :
 :
 :
 
   <row no="100"><FL val="Last Name">testing</FL><FL val="Company">ZOHO</FL></row>
</Leads>

Remarques :

Lors de l'insertion de plusieurs enregistrements avec la méthode insertRecords :

  • la vérification des doublons ne fonctionne pas. Cependant, la vérification des doublons lorsqu'il existe plusieurs enregistrements est prise en charge   dans la version 4.
  • Les règles de workflow ne seront pas déclenchées pour les enregistrements qui répondent aux critères.
  • Il n'est pas possible d'insérer plusieurs enregistrements pour les modules de devis, de commandes clients, de factures et de commandes fournisseurs.
  • Seuls les 100 premiers enregistrements sont pris en compte lors de l'insertion de plusieurs enregistrements.

Vérification des doublons pour plusieurs enregistrements

Objectif

Vous pouvez utiliser la méthode insertRecords pour déclencher la fonctionnalité de vérification des doublons pour plusieurs enregistrements. Veuillez noter que version=4 est un paramètre obligatoire.

Nous avons introduit trois nouveaux codes qui représentent le statut des résultats de l'API pour chaque enregistrement. Les codes les suivants :

2000 = Enregistrement ajouté avec succès
2001 = Mise à jour de l'enregistrement réussie
2002 = L'enregistrement existe déjà

Format de l'URL :

https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=Auth  Token&scope=crmapi&duplicateCheck=( 1 OR 2 )&version=4&xmlData= Your XML Data

Exemple de données XML

<Leads>
  <row no="1">
<FL val="Company">Company1</FL>
<FL val="Last Name">Last Name1</FL>
<FL val="Email">automation@crm.com 1</FL>
  </row>
  <row no="2">
<FL val="Company">Company2</FL>
<FL val="Last Name">Last Name2</FL>
<FL val="Email">automation@crm.com 2</FL>
  </row>
</Leads> 

Exemple de réponse

Si duplicateCheck=1, version=4, certains enregistrements existent avec l'adresse e-mail et d'autres enregistrements n'existent pas, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri=/crm/private/xml/Leads/insertRecords>
        <result>
          <row no=1>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120006</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no=2>
            <success>
              <code>2002</code>
              <details>
                <FL val=Id>2000000120007</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si duplicateCheck=1, version=4, il n'existe aucun enregistrement avec l'adresse e-mail, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri=/crm/private/xml/Leads/insertRecords>
        <result>
          <row no=1>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120006</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no=2>
            <success>
              <code>2000</code>
              <details>
                <FL val=Id>2000000120007</FL>
                <FL val=Created Time>2013-02-11 17:55:04</FL>
                <FL val=Modified Time>2013-02-11 17:55:04</FL>
                <FL val=Created By>
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val=Modified By>
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si duplicateCheck=1, version=4, certains enregistrements existent avec l'adresse e-mail, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2002</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2002</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si duplicateCheck=2, version=4, il n'existe aucun enregistrement avec l'adresse e-mail, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si duplicateCheck=2, version=4, certains enregistrements existent avec l'adresse e-mail, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si duplicateCheck=2, version=4, certains enregistrements existent avec l'adresse e-mail et d'autres enregistrements non, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
            <success>
              <code>2000</code>
              <details>
                <FL val="Id">2000000120007</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
        </result>
      </response>

Si version=4, certains enregistrements contiennent des erreurs et d'autres pas, la fonctionnalité et la réponse sont indiquées comme suit :

<response uri="/crm/private/xml/Leads/insertRecords">
        <result>
          <row no="1">
            <success>
              <code>2001</code>
              <details>
                <FL val="Id">2000000120006</FL>
                <FL val="Created Time">2013-02-11 17:55:04</FL>
                <FL val="Modified Time">2013-02-11 17:55:04</FL>
                <FL val="Created By">
                <![CDATA[ aghil123 ]]>
                </FL>
                <FL val="Modified By">
                <![CDATA[ aghil123 ]]>
                </FL>
              </details>
            </success>
          </row>
          <row no="2">
        <error>
           <code>4832</code>
           <details>You have given a wrong value for the field : Annual Revenue</details>
            </error>
          </row>
        </result>
      </response>

Insérer des données dans les modules personnalisés

Exemple de demande

https://crm.zoho.com/crm/private/xml/CustomModule1/insertRecords?authtoken=Auth Token&scope=crmapi
&xmlData=

<CustomModule>
<row no="1">
<FL val="CustomModule1 Name">Registration-CS1000120160101</FL>
</row>
</CustomModule>

Remarque :

  • L'adresse e-mail constitue le champ de vérification des doublons pour le module Leads (Prospects). Pour les autres modules, le champ de vérification des doublons varie. Pour en savoir plus, reportez-vous à https://www.zoho.com/crm/help/api/insertrecords.html# Duplicate_Check_Field  
  • Les développeurs sont désormais en mesure d'identifier facilement l'ID de l'enregistrement, car les informations de l'enregistrement comprises dans la réponse sont fournies de la même façon que les demandes de l'utilisateur dans les données XML.
  • Si vous ne transmettez pas la version, la fonctionnalité par défaut sera exécutée.
  • Vous devez transmettre version=4 dans les paramètres de l'URL pour vérifier les doublons dans plusieurs enregistrements.

Share this post : FacebookTwitter

Vous ne trouvez toujours pas ce que vous cherchez?

Écrivez-nous: support@zohocrm.com