使用记录编号获取记录

目录

 概述 

使用 Zoho Creator 中的zoho.books.getRecordsByID() Deluge 任务，您可以从 Zoho Books 提取相关记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。使用记录编号从 Zoho Books 中的联系人、发货单和付款模块提取记录。例如，使用记录编号在 Zoho Creator 中执行“表单动作”以便从 Zoho Books 提取联系人。或在 Zoho Creator 中配置计划程序以便从 Zoho Books 提取特定发货单。

 支持的模块

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

 语法

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

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

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

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

<contactID> 与需要提取的记录编号相关。在这里，它代表联系人编号。

注：

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

 示例

1) 使用记录编号从 Zoho Books 提取联系人

在本示例中，通过将代码添加到 Zoho Creator 表单来提取 Zoho Books 联系人模块的记录。在表单提交时，会提取与指定的记录编号相关的记录。

  • 将以下脚本添加在 Zoho Creator 表单的“成功时”部分。
response = zoho.books.getRecordsByID("contacts", "12345678","11111000000000001");
  • 提交表单将从 Zoho Books 提取其 ID 为“11111000000000001”的记录。 

其中，
contacts 是 Zoho Books 模块的名称，记录将需要从中提取。
12345678 是示例机构编号。使用您的机构编号替换它。
11111000000000001 是需要提取记录的记录编号

 响应格式

以下代码用于 getRecordsByID() 任务，

response = zoho.books.getRecordsByID("contacts", "35201411","12340000000450123"); 
info response;

生成以下响应格式，

{
"message":"success",
"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}