InsertRecords

      Méthode insertRecords - Comparaison

      Objectif

      Créer/insérer un ou plusieurs enregistrements spécifiques.

      URL de demande

      Version 1.0 :

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

      Version 2.0 :

      URL : https://www.zohoapis.com/crm/v2/Leads

      Méthode : POST

      Corps de la requête : le contenu d'un enregistrement donné au format JSON.

      En-tête : Authorization=Zoho-oauthtoken {oauth_token}

      Paramètres de requête

      Version 1.0Version 2.0
      authtoken=****Authorization=Zoho-oauthtoken ***** - comme En-tête.
      scope=crmapiS/O
      xmlDataS/O - Les données d'entrée doivent être données dans le corps de requête
      wfTrigger=true“trigger”:[“workflow”,”approval”,”blueprint”]
      La clé ci-dessus doit être donnée dans le corps de la requête
      duplicateCheckUne vérification des doublons est effectuée par défaut.
      isApproval“trigger”:[“workflow”,”approval”,”blueprint”]
      La clé ci-dessus doit être donnée dans le corps de la requête
      newFormatS/O
      versionS/O
       

      Exemple de requête API :

      Requête dans la version 1.0Requête dans la version 2.0
      https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=****&wfTrigger=true&xmlData=<Leads><row no="1"><FL val="Last Name">test1</FL><FL val="Company">com1</FL></row></Leads>URL - https://www.zohoapis.com/crm/v2/Leads
      Corps :
        {
          "data": [
            {
              "Last_Name":"Ben",
              "Company":"Zylker"
            }
          ],
      “triggger”:[“workflow”,”approval”,”blueprint”]
      }

      Exemples de réponses :

      +
      Réponse dans la version 1.0Réponse dans la version 2.0
      <?xml version="1.0" encoding="UTF-8" ?>
      <response uri="/crm/private/xml/Leads/insertRecords">
      <result>
      <message>Enregistrement(s) ajouté(s) avec succès</message>
      <recorddetail>
      <FL val="Id">1386586000002579001</FL>
      <FL val="Created Time">2018-03-2719:21:54</FL>
      <FL val="Modified Time">2018-03-2719:21:54</FL>
      <FL val="Created By"><![CDATA[Bruce Wills]]></FL>
      <FL val="Modified By"><![CDATA[Bruce Wills]]></FL>
      </recorddetail>
      </result>
      </response>      		{
        "data": [
         {
          "code": "SUCCESS",
          "details": {
           "Modified_Time": "2018-03-27T19:20:28+05:30",
           "Modified_By": {
            "name": "Bruce Wills",
            "id": "1386586000000078001"
           },
           "Created_Time": "2018-03-27T19:20:28+05:30",
           "id": "1386586000002572002",
           "Created_By": {
            "name": "Bruce Wills",
            "id": "1386586000000078001"
           },
          "display_name": "Deb",
          "type": "recycle",
          "Created_By": {
           "name": "Bruce Wills",
           "id": "1386586000000078001"
           }
          },
          "message": "record added",
          "status": "success",
         }   ]  }
       

      Remarque :

      Le champ "id" dans les API v1.0 est équivalent à "id" dans le premier objet JSON du tableau JSON "data".

      Le format d'entrée change pour le module Activités :

      Version 1.0Version 2.0
      <Events><row no="1">
      <FL val="Subject">Title3</FL>
      <FL val="Start DateTime">2018-04-1111:00:00</FL>
      <FL val="End DateTime">2018-04-1112:00:00</FL>
      <FL val="CONTACTID">1386586000002379006</FL>
      <FL val="SEID">1386586000001570009</FL>
      <FL val="SEMODULE">Accounts</FL>
      </row>
      </Events>      		{
        "data": [
         {
          "Event_Title":"titl1",
          "Start_DateTime":"2018-04-11T11:00:00+05:30",
          "End_DateTime":"2018-04-11T12:00:00+05:30",
          "Who_Id": "1386586000002379006",
          "$se_module": "Accounts",
          "What_Id": "1386586000001570009"
         }
        ]
      }
       

      Remarque :

      • CONTACTID est équivalent à l'id dans le JSONObject Who_Id.
      • SEMODULE est équivalent à $se_module.
      • SEID est équivalent à l'id dans le JSONObject What_Id.

      Le format d'entrée change pour le module des stocks :

      Version 1.0Version 2.0
      <Invoices><row no="1">
      <FL val="Subject">test inv2</FL>
      <FL val="ACCOUNTID">1386586000002307022</FL>
      <FL val="Tax">1.23</FL>
      <FL val="Adjustment">5</FL>
      <FL val="Grand Total">305</FL>
      <FL val="Product Details">
      <product no="1">
      <FL val="Product Id">1386586000000097001</FL>
      <FL val="Unit Price">10.0</FL>
      <FL val="Quantity">3.0</FL>
      <FL val="Total">300.0</FL>
      <FL val="Discount">1.23</FL>
      <FL val="Total After Discount">288.77</FL>
      <FL val="List Price">100.0</FL>
      <FL val="Net Total">288.77</FL>
      </product>
      </FL>
      </row>
      </Invoices>      		{
        "data": [
         {
          "Adjustment": 5,
          "Product_Details":
          [
           {
            "product": {
             "id": "1386586000000097001"
            },
            "quantity": 3,
            "list_price": 100,
            "unit_price": 22,
            "line_tax": [{"percentage": 2,"name": "Sales Tax"},{"percentage": 3,"name": "Vat"}]
           }
          ],
          "Subject": "test inv4",
          "Account_Name":
          "1386586000000753001",
          "$line_tax": [{"percentage": 1,"name":
          "Sales Tax"},{"percentage": 0.5,"name": "Vat"}]
         }
        ]
      }

      Share this post : FacebookTwitter

      Vous ne trouvez toujours pas ce que vous cherchez?

      Écrivez-nous: support@zohocrm.com

       
       

      Liens rapides

             S'inscrire gratuitement Accéder à Zoho crm
      Se connecter Tous les produits zoho