在 Zoho Books 中创建记录
目录
概述
使用 Zoho Creator 中的 zoho.books.createRecord() Deluge 任务，您可在 Zoho Books 中创建记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。当您需要时使用此任务在 Zoho Books 中创建联系人、生成付款通知单和更新付款。例如，在 Zoho Creator 中执行“表单动作”以在 Zoho Books 中创建联系人，或在 Zoho Creator 中配置计划程序以在 Zoho Books 中生成付款通知单。
支持的模块
- 联系人
- 付款通知单
- 客户付款
- 项目
- 报价单
- 经常性发票
- 费用
语法
<response> = zoho.books.createRecord(<module>, <orgID>, <params>);
其中，
<response> 是作为响应返回的映射变量。它包含新创建的记录的详细信息。
<module> 是要在其中添加记录的 Zoho Books 模块的名称。例如，“Contacts”指的是联系人模块。Creator 支持的 Zoho Books 模块是“联系人”、“付款通知单”和“客户付款”。
<orgID> 指的是在 Zoho Books 中指定的机构 ID。若要查看您的机构 ID，请单击 Zoho Books 主页右上角的<您的机构名 >> 管理机构。
<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 的联系人模块中创建记录。表单包含“Contacts”和“email”字段。在提交表单时，使用提交的数据在 Zoho Books 中创建记录。
- 将以下脚本添加在 Zoho Creator 表单的“成功时”部分
- 提交表单将在 Zoho Books 中创建带有联系人姓名“John”和电子邮件“john@zillum.com”的新记录。
其中，
Contacts 是 Zoho Books 模块的名称，记录将添加到该模块。
12345678 是示例机构 ID。请使用您的机构ID 来替换它。
"contact_name” 和 "email” 是在 Zoho Books 模块中指定的标签名称。Input.contact 和 input.email 指的是分别在 Zoho Creator 表单中的联系人和电子邮件字段中指定的值。
2) 使用 Zoho Creator 中的计划功能在 Zoho Books 中创建记录。
在此示例中，使用 Zoho Creator 计划功能于指定的日期和时间在 Zoho Books 的联系人模块自动创建记录。添加的代码包含用于在 Zoho Books 中创建记录的数据。
这将于指定的日期和时间在 Zoho Books 中自动添加记录，该记录的联系人姓名为“John”，电子邮件为“john@zillum.com”
其中，
response 是作为响应返回的映射变量。它包含新创建的记录的详细信息。
Contacts 是要在其中添加记录的 Zoho Books 模块的名称。
12345678 是示例机构 ID。请使用您的机构 ID 来替换它。
"contact_name” 和 "email” 是在 Zoho Books 模块中指定的标签名称。"john” 和 "john@zillum.com” 分别指的是两个标签名称的值。
响应格式
createRecord() 任务的以下代码，
params.put("contact_name", "Zoho Creator");
response = zoho.books.createRecord("Contacts", "35201411", params);
info response;
生成以下响应格式，
{
"message":"The contact has been added.",
"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 - param name passed as contactname instead of contact_name