CRM-Hilfe

insertRecords-Methode

Zweck

Mit der insertRecords-Methode können Sie Datensätze in das erforderliche Zoho CRM-Modul einfügen.

Wichtig: Verwenden Sie zur Übergabe dieser Parameter die Methode POST anstatt der Methode GET.

Anfrage-URL

XML-Format:

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

Anfrageparameter

ParameterDatentypBeschreibung
authtoken*ZeichenfolgeVerschlüsselte alphanumerische Zeichenfolge zur Authentifizierung Ihrer Zoho-Anmeldedaten.
scope*ZeichenfolgeGeben Sie den Wert für "scope" mit crmapi an.
xmlData*XMLDies ist eine XML-Zeichenfolge. Das Format sollte den abgerufenen Datensätzen von getRecords im XML-Format entsprechen.
wfTriggerBooleschSetzen Sie den Wert auf True, um die Workflow-Regel während dem Einfügen des Datensatzes im CRM-Konto auszulösen. Standardmäßig ist dieser Parameter auf False gesetzt.
duplicateCheckGanzzahlSetzen Sie den Wert auf "1", wenn Sie die Datensätze auf Dubletten prüfen und einen Fehler ausgeben möchten, oder setzen Sie den Wert auf "2", um die Datensätze auf etwaige Dubletten zu prüfen und diese zu aktualisieren.
isApprovalBooleschStandardmäßig werden Datensätze direkt eingefügt. Um die Datensätze im Genehmigungsmodus zu belassen, setzen Sie den Wert auf True. Sie können diese Parameter für die Module "Leads", "Contacts" und "Cases" verwenden.
newFormatGanzzahlnewFormat=1: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto auszuschließen.
newFormat=2: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto einzubeziehen.
versionGanzzahlVersion = 1: (Standardwert) Dadurch werden Antworten auf der Grundlage der früheren API-Implementierung abgerufen, d. h. vor den vorgenommenen Erweiterungen/Verbesserungen.
Version = 2: Dadurch werden Antworten basierend auf der neuesten API-Implementierung abgerufen.
Version = 4: Dadurch wird die Dublettenprüfung für mehrere Datensätze ausgelöst.

* – Obligatorischer Parameter

Hinweis:

  • Auf der Seite Versionshinweise erfahren Sie mehr über die Erweiterungen/Verbesserungen, die in der API-Implementierung vorgenommen wurden.

Felder zur Dublettenprüfung

ModulnameFeld zur Dublettenprüfung
LeadsEmail
ContactsEmail
AccountsKontoname
PotentialsName des potenziellen Kunden
CampaignsName der Kampagne
CasesBetreff
ProductsProduktname
VendorsName des Anbieters
QuotesBetreff
SalesOrdersBetreff
PurchaseOrdersBetreff
InvoicesBetreff
Benutzerdefiniertes ModulName des benutzerdefinierten Modus

Zusätzliche Hinweise

  • Beim Einfügen von Daten in Ihr Zoho CRM-Account wird die rollenbasierte Sicherheit (Rollen, Profile, Sicherheit auf Feldebene und die Datenfreigaberegeln) angewendet. Verwenden Sie daher die Benutzer-ID mit der höchsten Rolle (z. B. CEO) und dem höchsten Profil (z. B. Administrator). Stellen Sie außerdem sicher, dass alle Felder in den Sicherheitseinstellungen auf Feldebene aktiviert sind. Informationen zu rollenbasierten Sicherheitseinstellungen finden Sie unter Sicherheitsadministration beim Generieren des Authentifizierungstoken.
  • Stellen Sie beim Einfügen der Daten sicher, dass Datum und Uhrzeit im Format tt/mm/jjjj und jjjj-MM-tt HH:mm:ss angegeben sind.

Beispiele

Datensätze in Zoho CRM aus Anwendungen von Drittanbietern einfügen

URL-Format:
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>

Leads – XMLDATA-Beispiel

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

Tasks – XMLDATA-Beispiel mit Lead-Suche

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

Tasks – XMLDATA-Beispiel mit Kontakt- und Kontosuche

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

Notizen mit Bezug auf das primäre Modul einfügen

XML-Format:

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>

In diesem Fall ist die entityID die eindeutige ID des primären Datensatzes (Lead, Konto, Kontakt usw.)

Eigentümer zum Datensatz zuweisen

Stellen Sie beim Einfügen eines Datensatzes über API sicher, dass Sie die E-Mail-Adresse oder Benutzer-ID des Datensatzeigentümers festlegen. Wenn Sie den Namen des Datensatzeigentümers verwenden, wird der Datensatz den standardmäßigen Anmeldeinformationen zugeordnet, die im Authentifizierungstoken verwendet werden. Wenn Sie die Benutzer-ID verwenden möchten, um den Datensatzeigentümer festzulegen, fügen Sie der xmlData-Zeichenfolge den Tag <FL val="SMOWNERID">userID</FL> hinzu.

Hinweis:

  • Ersetzen Sie in den folgenden Beispielen die Werte für "authtoken" und "scope" durch die von Ihnen generierten Werte.

Fälle

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>

Hinweis:

  • Das Feld WHOID bezieht sich auf das Feld Related To im Modul "Cases". Geben Sie in das Feld WHOID die ID des Datensatzes ein, den Sie den Fällen als Feldwert Related To zuordnen möchten.

Aufgaben

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>

Veranstaltungen

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>

Veranstaltungen mit Kontakt- und Fallzuordnung

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>

Konten

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>

Kontakte

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>

Kundenaufträge

Hinweis:

  • Für "Produkt-ID" muss ein Wert eingegeben werden.

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>

Angebote

Hinweis:

  • Für "Produkt-ID" muss ein Wert eingegeben werden.

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>

Beispiel für ein Angebot mit mehreren Produkten:

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>

Anrufe an Kontakte und Kontensuche einfügen

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

Anrufe mit Leads-Suche einfügen

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

"CDATA" verwenden

Zweck: Sonderzeichen als Klartext und NICHT als XML-Daten betrachten

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

XML-Beispieldaten:

Als 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>

Als 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>

Hinweis:

  • "%26" gilt als "&"

Mehrere Datensätze einfügen

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

XMLDATA-Beispiel:

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

Hinweise:

Beim Einfügen mehrerer Datensätze mit der insertRecords-Methode:

  • Die Dublettenprüfung funktioniert nicht. Wir unterstützen jedoch dieDublettenprüfung für mehrere Datensätze in der Version 4.
  • Workflow-Regeln werden nicht für Datensätze ausgelöst, die diese Kriterien erfüllen.
  • Mehrere Datensätze können nicht für die Module Quotes, SalesOrders, Invoices und PurchaseOrders eingefügt werden.
  • Beim Einfügen mehrerer Datensätze werden nur die 100 Datensätze in Betracht gezogen.

Dublettenprüfung für mehrere Datensätze ausführen

Zweck

Mit insertRecords können Sie die Dublettenprüfung für mehrere Datensätze auszulösen. Bitte beachten Sie, dass "version=4" ein obligatorischer Parameter ist.

Wir haben drei neue Codes eingeführt, die den API-Ergebnisstatus für jeden Datensatz darstellen. Die Codes sind nachstehend aufgeführt:

2000 = Datensatz wurde erfolgreich hinzugefügt
2001 = Datensatz wurde erfolgreich aktualisiert
2002 = Datensatz ist bereits vorhanden

URL-Format:

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

XML-Beispieldaten

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

Beispielantwort

Wenn "duplicateCheck=1, version=4" sind in einigen vorhandenen Datensätzen (nicht in allen) die E-Mail-Adressen enthalten. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "duplicateCheck=1, version=4" enthalten keine Datensätze die E-Mail-Adresse. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "duplicateCheck=1, version=4" sind Datensätze mit der E-Mail-Adresse vorhanden. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "duplicateCheck=2, version=4" enthalten keine Datensätze die E-Mail-Adresse. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "duplicateCheck=2, version=4" sind Datensätze mit der E-Mail-Adresse vorhanden. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "duplicateCheck=2, version=4" sind in einigen vorhandenen Datensätzen (nicht in allen) die E-Mail-Adressen enthalten. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Wenn "version=4" sind in einigen Datensätzen (nicht in allen) Fehler enthalten. Die Funktion und Antwort entspricht den folgenden Angaben:

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

Daten in benutzerdefinierte Module einfügen

Beispielanfrage

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>

Hinweis:

  • Im Modul Leads ist die E-Mail Adresse das Feld zur Dublettenprüfung. In anderen Module unterscheidet sich das Feld zur Dublettenprüfung. Weitere Informationen dazu finden Sie unter https://www.zoho.com/crm/help/api/insertrecords.html#Duplicate_Check_Field 
  • Entwickler können nun die Datensatz-ID ganz einfach identifizieren, da die Datensatzdetails in der Antwort auf die gleiche Weise wie bei den Anfragen des Benutzers in den XML-Daten angegeben werden.
  • Wenn Sie die Version nicht weitergeben, wird die Standardfunktion ausgeführt.
  • Um die Dublettenprüfung in mehreren Datensätzen durchzuführen, müssen Sie in der Parameter-URL "version=4" übergeben.

Share this post : FacebookTwitter

Finden Sie immer noch nicht, wonach Sie suchen?

Schreib uns: support@zohocrm.com