导入现有订阅是上传包含客户订阅数据的文件。根据上传的数据，在Rainex系统中自动创建订阅，无需手动转移数据。
请注意，尽管订阅数据的转移是自动的，但您的账户必须正确准备好才能使这些订阅正常工作。所以，进入设置部分的导入数据选项卡，然后点击开始新的导入。
输入操作名称并下载文档示例以填写。根据模板，您将上传的导入文档应为CSV格式。
该文件包含一系列必填和可选列。请按照说明快速正确地完成此文件以导入订阅。
填写文件id是订阅的未来唯一标识符，应由数字和/或拉丁字母的大写和/或小写组成。此字段为必填项。
customer_id – 以下字段也是必填项。在创建客户或导入其数据时，每个客户都会自动分配一个ID，或者您可以填写自定义ID字段。在此字段中，按照导入订阅的顺序输入客户的ID。您可以在计费部分的客户选项卡中的每个客户卡片中找到它们。
状态 – 此列将显示导入订阅的状态，也是必填项。
订阅可以导入为以下三种状态之一：
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相同的模板设置一个晚于数据导入日期的结束日期（否则必须处于活跃订阅状态）。输入YYYYY-MM-DDT00:00:00:00+00:00。如果没有时间数据，请在此行的此部分留下0，就像示例中一样。
total_billing_cycles – 订阅按照计费周期类型分为两种：永久和固定。永久订阅将持续到客户继续使用您的产品，甚至可以持续50年。固定订阅意味着计费周期数量有限，当这些周期对客户过期时，按照这些条件的订阅将不再对他们可用。
如果订阅是固定的，请在此列中输入在创建此订阅时为客户设置的计费周期数。这是创建时的原始数量，而不是剩余的数量！
如果订阅是永久的，请将该列留空。
current_term_end – 只有在导入的订阅处于活动状态时，才需要填写此列。由于您正在导入已经激活的订阅，它们可能处于不同的周期阶段。因此，对于每个活动的订阅，请指定当前计费周期的结束日期，这将影响客户的进一步开票。使用模板YYYYY-MM-DDT00: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为例，为每种货币类型提供一个示例。
折扣/[索引]/列的一般说明。
这些字段是可选的，取决于订阅是否有折扣。但是，如果有折扣，则必须填写以下所有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为例，为每种货币提供一个示例。
支付/金额 – 此列为可选项，仅适用于处于活动状态的订阅。
当在计费周期中导入订阅时，Rainex系统会自动生成发票。在此字段中，您可以调整此发票的付款状态，因为客户已经为当前计费周期进行了付款，或者客户需要支付它。在此列中，您可以指定发票的付款金额。您可以输入此订阅的发票全额金额，然后发票将被视为已支付。您也可以输入小于发票全额金额的金额，然后发票将被视为部分支付。或者您可以输入大于订阅发票的全额金额，然后将生成贷项通知单，并在下一张发票开具时对客户的余额进行调整。如果您将此字段留空，则会生成一个应付发票。
请注意，为了进一步正确显示，此列中的数据必须遵循特定的格式。在Rainex中，您可以接受3种类型的货币支付 – 带有两位小数、带有三位小数或不带小数。在输入导入表格的数据时，您需要省略逗号，并将所有符号连在一起作为整数。让我们以数字10为例，为每种货币类型提供一个示例。
导入文档 #
当文档完成后，请将其上传到订阅导入页面的系统中。在此阶段，将进行数据的初始验证，如果您填写的数据有误，系统将立即通知您。如果一切正常，您将进入数据导入的第二步。
第二步是列映射。也就是说，系统会检查并将文档中的数据（CSV标题列）与数据要求进行关联。
如果存在数据不匹配，您将会看到相应列的不匹配状态。在这种情况下，需要编辑映射，即将数据定向到适当的部分以进行进一步的正确处理。
在操作卡中，您可以看到操作的整体状态以及正在上传的每个实体的上传状态。不要害怕退出卡片并在Rainex中开始其他操作，数据将保存在系统中，当您切换到另一个页面时不会丢失。导入可能需要一些时间，具体取决于导入的数据量。订阅数据将在计费部分的订阅选项卡下显示，因为它正在加载。
当导入完成后，可以在导入数据表中找到有关该操作的数据。
