在 Zoho Books 中更新记录

目录

 概述

使用 Zoho Creator 中的 zoho.books.updateRecord() Deluge 任务，您可在 Zoho Books 中更新记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。当您需要时使用此任务在 Zoho Books 的联系人、发货单和付款模块中更新记录。例如，在 Zoho Creator 中执行“表单动作”以在 Zoho Books 中更新联系人，或在 Zoho Creator 中配置计划程序以在 Zoho Books 中更新发货单。

 支持的模块

  • 联系人
  • 发货单
  • 客户付款
  • 项目
  • 报价单
  • 经常性发货单
  • 费用

 语法

<response> = zoho.books.updateRecord(<module>, <orgID>, <contactID>, <params>);

其中，
<response> 是作为响应返回的映射变量。它包含新创建记录的详细信息。

<module> 是需要从中更新记录的 Zoho Books 模块的名称。例如，“Contacts”指的是联系人模块。Creator 支持的 Zoho Books 模块是“联系人”、“发货单”和“客户付款”。

<orgID> 指的是在 Zoho Books 中指定的您机构的 ID。若要查看您的机构ID，请单击 Zoho Books 主页右上角的<您的机构名 >> 管理机构。

<contactID> 是需要在其中更新记录的联系人 ID。

<Params> 是保存键值对的映射变量。映射键是 Zoho Books 模块中指定的标签名，映射值是在 ZC 表单中提交的字段值。例如，"Contact Name" : input.Contact_Name。在这里，"Contact Name” 是在 Zoho Books 模块中指定的标签名，“input.Contact_Name”指的是在 Zoho Creator 表单的 Contact_Name 字段中指定的值。

注：

  • 上面列出的所有参数都是必需的。 

 示例

1) 使用 Zoho Creator 表单在 Zoho books 中更新记录。

在本示例中，通过将代码添加到 Zoho Creator 表单，以在 Zoho Books 的联系人模块中更新记录。在提交表单时，Zoho Books 联系人模块中的电子邮件地址使用提交的数据来更新。 

  • 将以下脚本添加在 Zoho Creator 表单的“成功时”部分。
response = zoho.books.updateRecord("contacts", "12345678","11111000000000001",{"email" : "john@zillum.com"});
  • 提交表单会将 Zoho Books 联系人模块中的电子邮件地址更新为“john@zillum.com”

其中，
contacts 是 Zoho Books 模块的名称，记录将需要在其中更新。
12345678 是示例机构ID。 使用您的机构ID 替换它。
11111000000000001 是需要更新其记录的联系人的 ID。
"Email” 是在 Zoho Books 模块中指定的标签名称。"john@zillum.com” 指的是更新的值。

 响应格式

updateRecord() 任务的以下代码，

response = zoho.books.updateRecord("contacts", "35201411","1234000000045123",{"email" : "john@zillum.com"});
info response;

生成以下响应格式，

{
"message":"Contact information has been saved.",
"code":0,
"contact":{
"default_templates":{
"invoice_template_id":"",
"creditnote_email_template_id":"",
"creditnote_template_name":"",
"estimate_email_template_name":"",
"estimate_template_id":"",
"estimate_email_template_id":"",
"invoice_email_template_id":"",
"estimate_template_name":"",
"creditnote_template_id":"",
"invoice_template_name":"",
"invoice_email_template_name":"",
"creditnote_email_template_name":""
},
"payment_terms":0,
"payment_terms_label":"Due On Receipt",
"contact_id":"1782000000045001",
"price_precision":2,
"has_transaction":false,
"outstanding_receivable_amount_bcy":0,
"shipping_address":{
"zip":"",
"fax":"",
"address":"",
"state":"",
"country":"",
"city":""
},
"outstanding_receivable_amount":0,
"is_crm_customer":false,
"unused_credits_payable_amount":0,
"associated_with_square":false,
"company_name":"",
"contact_name":"Zoho Creator",
"currency_symbol":"Rs.",
"currency_code":"INR",
"cards":"[]",
"tags":"[]",
"custom_fields":"[]",
"currency_id":"1782000000000099",
"pricebook_id":"",
"status":"active",
"website":"",
"is_linked_with_zohocrm":false,
"payment_reminder_enabled":true,
"primary_contact_id":"",
"outstanding_payable_amount_bcy":0,
"bank_accounts":"[]",
"pricebook_name":"",
"source":"api",
"outstanding_payable_amount":0,
"unused_credits_receivable_amount":0,
"last_modified_time":"2015-02-18T15:01:39+0530",
"unused_credits_payable_amount_bcy":0,
"contact_persons":"[]",
"contact_salutation":"",
"contact_type":"none",
"created_time":"2015-02-18T15:01:39+0530",
"notes":"",
"billing_address":{
"zip":"",
"fax":"",
"address":"",
"state":"",
"country":"",
"city":""
},
"unused_credits_receivable_amount_bcy":0
}
}

如果为了某种原因，执行失败，则错误响应将为以下格式：

Error Response for - Wrong value for record id

{"message":"Contact does not exist.","code":1002}