在 Zoho Subscriptions 中更新记录
概述
使用 Zoho Creator 中的 zoho.subscriptions.update() Deluge 任务，您可在 Zoho Subscriptions 的受支持模块中更新记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。在需要时使用此任务更新客户详细信息和客户的订阅详细信息。例如，您可以在 Zoho Creator 中执行“表单动作”以更新客户的联系人信息或修改其订阅详情。
支持的模块
- 客户
- 订阅
语法
<response> = zoho.subscriptions.update(<module>, <orgID>, <ID>, <params>);
其中，
<response> 是作为响应返回的映射变量。它包含已更新记录的详细信息。
<module> 是需要从中提取记录的 Zoho Subscriptions 模块的名称。例如，"Customers” 指的是客户模块。
<orgID> 指的是 Zoho Subscriptions 中指定的机构ID。若要查看您的机构ID，请单击 Zoho Subscriptions 主页右上角的<您的机构名 >> 管理机构。点击此处以了解有关机构ID 的更多信息。
<ID> 指的是需要更新的记录的 Id
<params> 是保存键值对的映射变量。映射键是 Zoho Subscriptions 模块中指定的标签名，映射值是在 ZC 表单中提交的字段值。例如，"display_name" : input.Customer_Name。在这里，"display_name” 是在 Zoho Subscriptions 模块中指定的标签名，“input.Customer_Name”指的是在 Zoho Creator 表单的 Contact_Name 字段中指定的值。
注：
- 上面列出的所有参数都是必需的。
示例
1) 使用 Zoho Creator 表单在 Zoho Subscriptions 中更新交易详细信息
在此示例中，我们通过将代码添加到 Zoho Creator 表单并提交表单来更新订阅详细信息。表单包含字段“计划代码”。在提交表单时，指定记录的订阅详细信息会使用提交的数据来更新。
- 将以下脚本添加在 Zoho Creator 表单的“成功时”部分
params = map();
para = map();
para.put("plan_code", input.Plan_Code);
params.put("plan", para);
response = zoho.subscriptions.update("subscriptions", "12345678", "3808000000040107", params);
- 提交表单会根据提交的值来更新订阅计划。
其中，
"input.Plan_Code” 指的是 Zoho Creator 表单字段。
响应格式
下面是由 Zoho Subscriptions 返回至 Zoho Creator 的响应格式：
{
"message":"Subscription has been updated successfully.",
"subscription":{
"subscription_id":"115888000000047005",
"payment_terms":0,
"interval":1,
"product_id":"115888000000037018",
"payment_terms_label":"Due on Receipt",
"next_billing_at":"2015-04-10",
"product_name":"zoho",
"current_term_starts_at":"2015-03-10",
"customer":{
"payment_terms":0,
"payment_terms_label":"",
"zcrm_account_id":"",
"shipping_address":{
"zip":"",
"fax":"",
"street":"",
"state":"",
"country":"",
"city":""
},
"first_name":"",
"display_name":"ram",
"email":"ram.s@gmail.com",
"company_name":"",
"zcrm_contact_id":"",
"last_name":"",
"customer_id":"115888000000046001",
"billing_address":{
"zip":"",
"fax":"",
"street":"",
"state":"",
"country":"",
"city":""
}
},
"interval_unit":"months",
"updated_time":"2015-03-10T11:06:10+0530",
"current_term_ends_at":"2015-04-10",
"amount":1000,
"salesperson_name":"",
"name":"zoho-monthly",
"reference_id":"",
"salesperson_id":"",
"currency_symbol":"Rs.",
"activated_at":"2015-03-10",
"currency_code":"INR",
"custom_fields":"[]",
"child_invoice_id":"115888000000046015",
"status":"live",
"addons":"[]",
"last_billing_at":"2015-03-10",
"contactpersons":[
{
"phone":"",
"email":"ram.s@gmail.com",
"zcrm_contact_id":"",
"contactperson_id":"115888000000046003",
"mobile":""
}
],
"expires_at":"",
"plan":{
"tax_name":"",
"setup_fee":0,
"price":1000,
"tax_type":"",
"name":"monthly",
"tax_id":"",
"quantity":1,
"tax_percentage":"",
"plan_code":"monthly"
},
"created_time":"2015-03-10T11:00:18+0530",
"taxes":"[]",
"auto_collect":false
},
"code":0
}
如果为了某种原因，执行失败，则错误响应将为以下格式：
Error Response for - No records updated