导入现有订阅是上传包含客户订阅数据的文件。根据上传的数据，在Rainex系统中自动创建订阅，无需手动转移数据。
请注意，尽管订阅数据的传输是自动的，但您的账户必须正确准备好以确保这些订阅正常工作。
- 预设您订阅中使用的货币和频率。
- 创建您订阅销售的所有产品。
- 创建具有固定价格的订阅计划。
- 创建附加组件并附加到您的订阅中，并为它们设置价格。与订阅相关的附加组件的费用不可转移，因为它们是一次性项目，而不是像订阅本身那样重复发生的。
- 最后但并非最不重要的是手动输入或导入客户数据。请注意，如果您接受客户的自动付款，您必须连接适当的支付网关，并为每个客户添加自动付款的支付方式。
所以，请在设置部分的导入数据选项卡中点击开始新的导入。
输入操作的名称并下载文档样本进行填写。根据模板，您将上传的导入文档应为CSV格式。
该文件包含一系列强制和可选列。请按照说明快速准确地完成此文件以导入订阅。
填写文件 #
id是订阅的未来唯一标识符，应由数字和/或拉丁字母的大写和/或小写组成。此字段为必填项。
customer_id – 以下字段也是必填项。在创建客户或导入其数据时，每个客户都会自动分配一个ID，或者您可以填写自定义ID字段。在此字段中，按照导入其订阅的顺序输入客户的ID。您可以在计费部分的客户选项卡中的每个客户卡片中找到它们。
状态 – 此列将显示导入订阅的状态，也是必填项。
订阅只能以以下三种状态之一导入：
- 对于已经开始计费周期的有效订阅保持激活状态；
- 试用期内的订阅；
- 对于计划在导入此订阅后激活或开始试用期的预定订阅，将来的计划。
请注意，订阅状态必须以此格式指定在该列中：InTrial，Active，Future。
auto_collection – 此列是可选的，仅在导入的订阅中启用自动付款并在Rainex系统中为客户添加了主要付款方式时才填写。如果满足这些条件，请在相应客户的列中写入on。对于没有自动付款的客户，请在此列中写入off或者将该列保留为空。
future_invoice_days_before_end_period – 填写此列以指定发票应在账期结束前多少天发给客户。输入一个大于0但小于或等于账期长度的整数。
days_notify_about_unpaid_invoice – 如果您希望在未来发票发出后并在账单周期结束之前向客户发送付款提醒（当然，一旦发票付款，提醒将不会发送），请指定天数。将天数指定为整数，范围从发票发出到账单周期结束。也就是说，这些数字必须大于0且小于future_invoice_days_before_end_period列中的数字。我们要求您遵守以下格式的写法：“1, 2, 5”，包括引号（在Google表中生成csv文件时，引号会自动添加）。请注意，为了使此功能正常工作，您需要事先在通知设置中启用相应的电子邮件发送。
include_vat – 请确保在此列中指定此订阅的价格是否包含增值税。此信息对于进一步生成客户发票是必要的。如果包含增值税，请在此列的订阅行中写入true，如果不包含，请写入false（TRUE和FALSE也是有效的）。
start_date – 此列中的数据与状态列中的数据一致且是必填项。因此，如果订阅状态为Active或InTrial，则逻辑上在导入数据时已经开始，这意味着该列应包含早于导入数据的订阅日期。相应地，对于Future状态的订阅，日期应晚于进行中导入的日期。
此列中的日期应按照以下格式编写：YYYYY-MM-DDT00:00:00:00+00:00（T表示时间，包括毫秒，如果没有创建时间数据，请在模板中的每个位置上都填写0）。例如，2023-09-14T09:20:242849+00:00。
activated_on – 如果导入的订阅处于活动状态，则需要填写此列。对于试用和未来状态，请将字段保留为空。
使用与start_date相同的模板设置客户的订阅激活日期。输入YYYY-MM-DDT00:00:00:00+00:00。如果没有时间数据，请在字符串的这部分留下0，就像示例中一样。请注意，如果订阅立即开始，则此日期可以与start_date相同，如果其激活之前有试用期，则可以晚于start_date，但不能与导入此订阅数据的日期相同或晚于该日期，否则应处于不同的状态。
trial_ends_on – 如果导入的订阅处于试用状态，则此列是必填的。对于活动和未来状态，请将字段留空。
任何试用期必须有一个截止日期，客户付款后，订阅将进入活动状态。使用与start_date相同的模板设置一个晚于数据导入日期的截止日期，以便此订阅处于活动订阅状态。输入YYYY-MM-DDT00:00:00:00+00:00。如果没有时间数据，请在此行的此部分留下0，就像示例中一样。
total_billing_cycles – 订阅按照计费周期分为两种类型：永久和固定。永久订阅将持续到客户继续使用您的产品，甚至持续到未来50年。固定订阅意味着计费周期数量有限，当这些周期对客户过期时，按照这些条件的订阅将不再对他们可用。
如果订阅是固定的，请在此列中输入在创建此订阅时为客户设置的计费周期数量。这是创建时的原始数量，而不是剩余数量！
如果订阅是永久的，请将该列留空。
current_term_end – 只有在导入的订阅处于活动状态时，才需要填写此列。由于您正在导入已经处于活动状态的订阅，它们可能处于不同的周期阶段。因此，对于每个活动订阅，请指定当前计费周期的结束日期，这将影响客户的进一步发票。使用模板YYYY-MM-DDT00:00:00:00+00:00设置日期（如果没有时间数据，请在此行的此部分留下0，如示例所示）。请注意，此日期必须晚于start_date和activated_on列中的日期。
billing_cycles_left – 如果您在total_billing_cycles中指定了订阅为固定且处于活动状态，请确保填写此列。
此列不适用于InTrial和Future状态的订阅，因为它们的计费周期尚未开始，所以不需要填写。如果您将total_billing_cycles列留空，即订阅是永久的，请也将此列留空。
在此列中，您需要指定订阅周期中尚未过期的完整计费周期数量，而不考虑当前周期。此列中的数字必须小于total_billing_cycles。例如，如果订阅在导入时正在运行倒数第二个周期，并且只剩下1个完整计费周期才能结束其有效期，在相应的行中写入值1。
future_trial_duration – 当您指定导入的订阅处于未来状态时，当开始日期列中指定的日期发生时，它将切换到活动或试用状态。仅在为此未来订阅提供试用期时填写此列（对于立即激活，请将字段留空）。因此，在此列中输入与试用期长度相对应的整数值。您只在此处输入值，在下一列中输入度量单位。
future_trial_duration_units – 现在在这里输入day或month的值，它将与前一列的数字相关，并形成未来订阅的试用期持续时间。如果您填写了future_trial_duration列，则此列变为必填项。
项目/[索引]/列的一般说明。
一个订阅可以有多个行项目，即与之相关联的费率和附加项。具有单个索引的列描述一个单独的行项目。因此，索引是一个变量，有助于确定数据是否属于特定的行项目。
索引中值为0的前四列必须始终包含有关导入的订阅计划的数据。
导入插件数据是通过复制四列，更改所有四个列的索引，并填写插件数据来完成的。从1到无穷大的所有后续索引值表示附加到订阅的插件。每增加一个新项目，索引号将增加一。
例如，您有一个订阅，附有五个附加组件，而其他订阅要么只有一个附加组件，要么根本没有附加组件。在这种情况下，您需要使用索引0填充每个订阅的相应数据列。然后，您复制这四个原始列，将整个集合连续粘贴5次，同时按顺序将索引更改为从1到5的整数值，应用于整个四列集合。在这种情况下，您需要填写关于最大订阅的所有五个附加组件的数据，而对于其他没有这些数据的订阅，这些列将保持为空。
请记住，所有订阅项目的持续时间和货币必须相同。
正如我们之前所说，由于附加费用不是重复性操作，因此无法导入相关数据。
items/[index]/item_price_id – 此列为必填项，必须包含您在数据导入之前创建的计划的价格ID。要在目录部分找到所需的数据，请转到订阅计划，然后转到导入的订阅的适当计划。在计划卡片上，单击为此订阅设置的价格，在价格详细信息页面上，您将看到ID的字母数字代码，应在数据导入文档的这些字段中指定。
items/[index]/quantity – 根据定价结构，费率和附加组件分为固定费用和按单位计费。此列仅适用于按单位计费的项目（对于固定费用，请将字段留空）。在此处指定项目数量，以整数形式表示。
items/[index]/free_quantity – 此列用于按单位定价的可选项。如果items/[index]/quantity列中的某些项目是免费的，请在此处设置一个整数值。相应地，此列中的数字必须小于items/[index]/quantity列中的数字。对于固定费用，也请将字段保留为空。
items/[index]/unit_price – 必填列，您在此处指定订阅或附加组件的价格。请记住，对于固定费用，指定的价格将是项目的全价。然而，如果项目的价格是按单位计算的，最终费用将通过将此金额乘以items/[index]/quantity列中指定的数量减去free_quantity列中的值来计算。
请注意，为了进一步正确显示，此列中的数据必须遵循特定的格式。在Rainex中，您可以接受3种类型的货币支付 – 带有两位小数、带有三位小数或不带小数。在输入导入表格的数据时，您需要省略逗号，并将所有符号连在一起作为整数。
让我们以数字10为例，为每种货币类型提供一个示例。
- 对于像美元、欧元、英镑等带有两位小数的货币，您需要写上1000，即包括分的值。
- 对于没有小数点的货币，如日元或韩元 – 10，因为这种类型的货币没有小数点值。
- 对于3位小数的货币，如科威特第纳尔或阿曼里亚尔，正确的格式是10000。
折扣/[索引]/列的一般说明。
这些字段是可选的，取决于订阅是否有折扣。但是如果有折扣，必须填写以下所有5个列，以正确显示数据。
请注意，折扣索引从0开始重新计算。项目索引和折扣索引没有关联，因为折扣应用于哪个特定项目是直接在列中指定的。
您可以对订阅应用多个折扣。就像对于items/[index]/一样，要添加另一个项目，复制所有列，将索引增加1，并填写必要的数据。
discounts/[index]/duration_type – 折扣可以是一次性的或永久的，例如用于促销活动。对于处于活动状态的订阅，一次性折扣将被应用于导入时生成的发票或下一个计费周期的发票。对于处于未来和试用状态的订阅，折扣将被应用于订阅激活后的第一张发票。相应地，永久性折扣将在整个订阅的持续时间内应用于订阅或其元素。在此列中以确切的拼写格式指定OneTime或Forever。
discounts/[index]/apply_on – 在Rainex中，您可以创建两种类型的折扣：适用于所有订阅项目的折扣，即折扣将从总发票金额中扣除，以及适用于每个单独的订阅项目，并且仅适用于指定的项目。根据折扣的应用情况，在此列中指定SpecificItemPrice或InvoiceAmount。请保持文档中的拼写格式与此示例相同。
discounts/[index]/item_price_id – 如果您在前一列中输入了SpecificItemPrice，这里您必须输入特定项目的价格ID，以便应用折扣。复制计划或附加组件的价格ID，并粘贴到此列中。如果您在discounts/[index]/apply_on列中写入了InvoiceAmount，请将此列中的字段留空。
discounts/[index]/discount_type – 最后，折扣的最后分类将其分为两个类别：按百分比计算或固定金额。如果价格以百分比折扣，请在此列中指定Percentage。如果对您来说更方便，或者事先与客户达成协议等等，您可以从价格中扣除一定金额的值。在这种情况下，请在此列中输入FixedAmount值。再次，请遵循导入文档中指定的拼写格式。
discounts/[index]/value – 此列中的值直接取决于前一列discounts/[index]/discount_type中的值。
如果您在此处指定了百分比，请输入一个介于0和100之间的值，包括小数值。
如果是固定金额，请在适当的货币中输入折扣金额。由于在Rainex中可以接受3种类型的货币支付-带有两位小数、带有三位小数和不带小数，所以在输入表格中的金额时，请省略逗号，并将所有货币写成整数。
让我们以数字10为例，为每种货币提供一个示例。
- 对于小数点后有两位的货币，如美元、欧元、英镑等，您需要写上1000，即将分的价值包含在内。
- 对于没有小数点的货币，如日元或韩元 – 10，因为这种类型的货币没有小数点值。
- 对于3位小数的货币，例如科威特第纳尔或阿曼里亚尔，正确的拼写应为10000。
付款/金额 – 此列是可选的，仅适用于处于活动状态的订阅。
当在计费周期中导入订阅时，Rainex系统会自动生成一张发票。在此字段中，您可以调整该发票的付款状态，因为客户已经对当前计费周期进行了付款，或者客户需要支付该发票。在此列中，您可以指定该发票的付款金额。您可以输入该订阅的发票全额金额，那么该发票将被视为已付款。您也可以输入小于该发票全额金额的金额，那么该发票将被视为部分付款。或者您可以输入大于该订阅发票全额金额的金额，那么将会生成一张贷项通知单，并在下一张发票开具时对客户的余额进行调整。如果您将此字段留空，将生成一张应付发票。
请注意，为了进一步正确显示，此列中的数据必须遵循特定的格式。在Rainex中，您可以接受3种类型的货币支付 – 两位小数、三位小数或无小数。在输入导入表格的数据时，您需要省略逗号，并将所有符号连写为整数。
让我们以数字10为例，为每种货币类型提供一个示例。
- 对于小数货币，如美元、欧元、英镑等，您需要写上小数点后的值，例如1000。
- 对于没有小数点的货币，如日元或韩元-10，因为这种类型的货币没有小数点值。
- 对于3位小数的货币，例如科威特第纳尔或阿曼里亚尔，正确的格式是10000。
导入文件 #
当文档完成后，请将其上传到订阅导入页面上的系统中。在此阶段，将进行数据的初始验证，如果您填写的数据有误，系统将立即通知您。如果一切正常，您将进入数据导入的第二步。
第二步是列映射。也就是说，系统会检查并将文档中的数据（CSV标题列）与数据要求进行关联。
如果存在数据不匹配，您将会看到相应列的不匹配状态。在这种情况下，需要编辑映射，即将数据定向到适当的部分以进行进一步的正确工作。
在操作卡中，您可以看到操作的整体状态以及正在上传的每个实体的上传状态。不要害怕退出卡片并在Rainex中开始其他操作，数据将保存在系统中，当您切换到另一个页面时不会丢失。导入可能需要一些时间，具体取决于导入的数据量。订阅数据将在计费部分的订阅选项卡下显示，因为它正在加载。
当导入完成后，可以在导入数据表中找到有关该操作的数据。
