insertRecords 方法
目录
目的
您可以使用insertRecords方法将记录插入所需的 Zoho CRM 模块。
重要注意事项： 使用POST方法取代GET 方法通过这些参数。
请求 URL
XML 格式：
请求参数
| 参数 | 数据类型 | 说明 |
| authtoken* | 字符串 | 验证您的 Zoho 凭据的加密字母数字字符串。 |
| scope* | 字符串 | 将范围指定为crmapi |
| xmlData* | XML | 这是 XML 字符串，格式应与所获取记录的 XML 格式中 getRecords 相同。 |
| wfTrigger | 布尔 | 将值设定为真，在将记录插入 CRM 账户时触发CRM工作流规则。 默认情况下，此参数为假。 |
| duplicateCheck | 整数值 | 将值设置为 "1" ，检查重复记录并提出错误响应，或设置为 "2"，检查重复记录，如存在重复记录，则对相同记录进行更新。 |
| isApproval | 布尔 | 默认情况下，直接插入记录。 如需将记录保持在批准模式，则将值设置为真。 您可以将此参数用于线索、联系人和案例模块。 |
| newFormat | 整数值 | newFormat=1： 插入来自您的 CRM 账户的数据时排除有 "null" 的字段。 newFormat=2： 插入来自您的 CRM 账户的数据时将有 "null" 的字段包括在内。 |
| 版本 | 整数值 | version = 1： （默认值）这将基于之前的 API 执行即在进行强化之前获取响应。 version = 2： 这将基于上一次 API 执行获取响应。 version = 4：这将触发对多条记录的重复检查功能。 |
* - 必填参数
注意：
- 参考发布说明页面了解关于 API 执行中进行的强化的更多信息。
重复检查字段
| 模块名称 | 重复检查字段 |
| 线索 | 邮件 |
| 联系人 | 邮件 |
| 账户 | 账户名称 |
| 潜在客户 | 潜在客户姓名 |
| 宣传 | 宣传名称 |
| 案例 | 主题 |
| 产品 | 产品名称 |
| 供货商 | 供货商名称 |
| 报价 | 主题 |
| SalesOrders | 主题 |
| PurchaseOrders | 主题 |
| 发票 | 主题 |
| CustomModule | CustomModule 名称 |
其它说明
- 向您的 Zoho CRM 账户插入数据时，基于角色的安全（角色、概要文件、字段级别的安全和数据共享规则）应用。 因此，使用有最高级别角色（例如： CEO ）和概要文件（例如： 管理员）的用户 ID。 另外确保所有字段在字段级别安全设置中启用。 关于基于角色的安全设置，请在生成验证令牌时参阅安全管理。
- 插入数据时，确保日期和时间分别采用月/日/年和年-月-日 小时：分钟：秒的格式
示例
从第三方应用程序将记录插入 Zoho CRM
URL 格式：
https://crm.zoho.com.cn/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData=Your XML Data
样本请求：
https://crm.zoho.com.cn/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>
Sample Lead XMLDATA
<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>
使用线索查找的样本任务 XMLDATA
<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>
使用联系人和账户查找的样本任务 XMLDATA
<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">账户</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>
插入备注并关联至主要模块
XML 格式：
https://crm.zoho.com.cn/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>
Here the entityID is unique ID of the primary record (Lead, Account, Contact etc.)
分配所有者给记录
通过 API 插入记录时，确保您指定记录所有者的电子邮箱地址或 userID。 如果您使用记录所有者的姓名，记录将分配给验证令牌中使用的默认登录凭证。 如果您希望使用 userID 指定记录所有者，则添加 <FL val="SMOWNERID">userID</FL> 标签至您的 xmlData 中。
注意：
- 在以下示例中，将 authotoken' 和 'scope' 的值替换为您生成的值。
案例
https://crm.zoho.com.cn/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>
注意：
- WHOID 字段指的是案例模块中的 Related To 字段。 给出您想要关联至案例的记录 ID 作为 WHOID 字段中的 Related To 字段值。
Tasks
https://crm.zoho.com.cn/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>
Events
https://crm.zoho.com.cn/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>
有联系人和案例映射的活动
https://crm.zoho.com.cn/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>
Accounts
https://crm.zoho.com.cn/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.cn/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>
SalesOrders
注意：
- "Product Id" 的值为必填。
https://crm.zoho.com.cn/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>
报价
注意：
- "Product Id" 的值为必填。
https://crm.zoho.com.cn/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>
多种产品报价的示例：
https://crm.zoho.com.cn/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>
插入有联系人和账户查找的调用
<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>
插入有线索查找的调用
<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'
目的： 考虑将特殊字符作为普通文本，而非 XML 数据
URL 格式：
https://crm.zoho.com.cn/crm/private/xml/Contacts/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= Your XML Data
样本 XML 数据：
作为 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>
作为 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>
注意：
- "%26" 不会被视为 "&"
插入多条记录
URL 格式： https://crm.zoho.com.cn/crm/private/xml/Leads/insertRecords?newFormat=1&authtoken=Auth Token&scope=crmapi&xmlData= Your XML Data
XMLDATA 样本：
<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>
注意：
使用 insertRecords 方法插入多条记录时：
- 复制检查不会启用。 但是，我们在第 4 版本中支持对多条记录的重复检查
- 工作流规则不会针对满足标准的记录触发
- 多条记录不可针对报价、销售订单、发票和采购订单模块插入。
- 仅前 100 条记录可在插入多条记录时纳入考虑范围。
多条记录的重复检查
目的
您可以使用 insertRecords 触发多条记录的重复检查功能。 请注意，version=4 为必填参数。
我们引入了三种新代码，代表各条记录的 API 结果状态。 代码给出如下：
2000 = 记录添加成功
2001 = 记录更新成功
2002 = 记录已经存在
URL 格式：
https://crm.zoho.com.cn/crm/private/xml/Leads/insertRecords?authtoken=Auth Token&scope=crmapi&duplicateCheck=( 1 OR 2 )&version=4&xmlData= Your XML Data
样本 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>
样本响应
如果 duplicateCheck=1，version=4，有些记录已经与电子邮箱地址同时存在，有些记录则不存在这种情况，功能和响应给出如下：
<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>
如果 duplicateCheck=1，version=4，无记录与电子邮箱地址同时存在，功能和响应给出如下：
<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>
如果 duplicateCheck=1，version=4，记录与电子邮箱地址同时存在，功能和响应给出如下：
<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>
如果 duplicateCheck=2，version=4，无记录与电子邮箱地址同时存在，功能和响应给出如下：
<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>
如果 duplicateCheck=2，version=4，记录与电子邮箱地址同时存在，功能和响应给出如下：
<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>
如果 duplicateCheck=2，version=4，有些已经与电子邮箱地址同时存在，有些记录则不存在这种情况，功能和响应给出如下：
<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>
如果 version=4，有些记录包含错误，有些记录则没有，功能和响应给出如下：
<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>
将数据插入自定义模块
样本请求
https://crm.zoho.com.cn/crm/private/xml/CustomModule1/insertRecords?authtoken=Auth Token&scope=crmapi
&xmlData=
<CustomModule>
<row no="1">
<FL val="CustomModule1 Name">Registration-CS1000120160101</FL>
</row>
</CustomModule>
注意：
- 电子邮箱地址是线索模块的重复检查字段。 对于其它模块，重复检查字段视情况而定。 如需了解更多信息，请阅读https://www.zoho.com.cn/crm/help/api/insertrecords.html#Duplicate_Check_Field
- 开发者现在可以轻松识别记录 id，因为响应中的记录详细信息是以用户在 xml 数据中请求的同样方式给出。
- 如果您不通过这一版本，默认功能将被执行。
- 您必须在多条记录的重复检查中对参数 URL 通过 version=4。