在Zoho Subscriptions中创建记录

目录

 概述

使用 Zoho Creator 中的 zoho.subscriptions.create() Deluge 任务，您可在 Zoho Subscriptions 的受支持模块中创建记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。在需要时使用此任务创建客户、为客户生成订阅以及为新订阅创建符合 PCI 的托管页面。例如，您可以在 Zoho Creator 中执行“表单动作”以在 Zoho Subscriptions 中创建客户或为 Zoho Subscriptions 中的现有客户生成订阅。

 支持的模块

  • 客户
  • 订阅
  • 托管页面

 语法

<response> = zoho.subscriptions.create(<module>, <orgID>, <params>);

其中，
<response> 是作为响应返回的映射变量。它包含新创建记录的详细信息。
<module> 是需要在其中添加记录的 Zoho Subscriptions 模块的名称。例如，"Customers” 指的是客户模块。
<orgID> 指的是 Zoho Subscriptions 中指定的机构ID。若要查看您的机构ID，请点击 Zoho Subscriptions 主页右上角的<您的机构名 >> 管理机构。点击此处以了解有关机构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 Subscriptions 的客户模块中创建客户。表单包含“Customer Name”和“Email”字段。在提交表单时，使用提交的数据在 Zoho Subscriptions 客户模块中创建记录。

  • 将以下脚本添加在 Zoho Creator 表单的“成功时”部分

params = map();
params.put("display_name", input.Customer_Name);
params.put("email", input.Email);
response = zoho.subscriptions.create("customers", "12345678", params);

  • 提交表单将在 Zoho Subscriptions 中创建一条带有指定的客户名称和电子邮件的新记录。

其中，
customers 是 Zoho Subscriptions 模块的名称，记录将添加到该模块。
12345678 是示例机构ID。请使用您的机构ID 来替换它。
"display_name” 和 "email” 是在 Zoho Subscriptions 客户模块中指定的标签名称。"input.Customer_Name” 和 "input.Email” 指的是 Zoho Creator 表单字段。

 响应格式

下面是由 Zoho Subscriptions 返回至 Zoho Creator 的响应格式：

{
"message":"The customer has been added.",
"code":0,
"customer":{
"default_templates":{
"creditnote_template_id":"",
"invoice_template_id":""
},
"phone":"",
"payment_terms":0,
"payment_terms_label":"Due On Receipt",
"price_precision":2,
"updated_time":"2015-03-10",
"outstanding_receivable_amount":0,
"shipping_address":{
"zip":"",
"fax":"",
"street":"",
"state":"",
"country":"",
"city":""
},
"first_name":"",
"company_name":"",
"zcrm_contact_id":"",
"currency_symbol":"Rs.",
"outstanding":0,
"currency_code":"INR",
"custom_fields":"[]",
"currency_id":"115888000000000099",
"status":"active",
"pricebook_id":"115888000000011001",
"zcrm_account_id":"",
"unused_credits":0,
"display_name":"zoho",
"email":"zohocorp@gmail.com",
"last_name":"",
"created_time":"2015-03-10",
"notes":"",
"customer_id":"115888000000046001",
"mobile":"",
"billing_address":{
"zip":"",
"fax":"",
"street":"",
"state":"",
"country":"",
"city":""
}
}
}

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

Error Response for - Customer diplay_name parameter not passed.

{"message":"Enter valid Customer Name","code":3013}

Customer display_name 是必填参数。