导入现有订阅是上传包含客户订阅数据的文件。根据上传的数据，在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相同的模板设置一个晚于数据导入日期的结束日期（否则必须处于活动订阅状态）。输入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为例，为每种货币类型提供一个示例。
折扣/[索引]/列的一般说明。
这些字段是可选的，取决于订阅是否有折扣。但是，如果有折扣，必须填写以下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 – 最后，折扣的最后分类将其分为两类：按百分比计算或固定金额。如果价格以百分比折扣，请在此列中指定百分比。如果对您来说更方便，或者事先与客户达成协议等等，您可以从价格中扣除一定金额的价值。在这种情况下，请在此列中输入固定金额的值。再次，请遵循导入文档中指定的拼写格式。
discounts/[index]/value – 此列中的值直接取决于前一列discounts/[index]/discount_type中的值。
如果您在这里指定了百分比，请输入一个介于0和100之间的值，包括小数值。
如果是固定金额，请在适当的货币中输入折扣金额。由于在Rainex中您可以接受3种类型的货币支付 – 带有两位小数、带有三位小数和没有小数位数的货币，因此在输入金额时，请省略逗号，并将所有货币写为整数。
让我们以数字10为例，为每种货币类型提供一个示例。
付款/金额 – 此列是可选的，仅适用于活动状态的订阅。
当在计费周期中导入订阅时，Rainex系统会自动生成发票。在此字段中，您可以调节该发票是否立即处于已支付状态，因为客户已经为当前计费周期进行了付款，或者客户需要支付该发票。在此列中，您可以指定该发票的付款金额。您可以输入该订阅的发票全额金额，那么该发票将被视为已支付。您也可以输入小于发票全额金额的金额，那么该发票将被视为部分支付。或者您可以输入大于该订阅发票全额金额的金额，那么将生成一张贷项通知单，并在下一张发票开具时对客户的余额进行调整。如果您将此字段留空，将生成一张应付发票。
请注意，为了进一步正确显示，此列中的数据必须遵循特定的格式。在Rainex中，您可以接受3种类型的货币支付 – 两位小数、三位小数或无小数。在输入导入表格的数据时，您需要省略逗号，并将所有符号连在一起写成整数。让我们以数字10为例，为每种货币类型提供一个示例。
当文档完成后，请将其上传到订阅导入页面的系统中。在此阶段，将进行数据的初始验证，如果您填写的数据有误，系统将立即通知您。如果一切正常，您将进入数据导入的第二步。
第二步是列映射。也就是说，系统会检查并将文档中的数据（CSV标题列）与数据要求进行关联。
如果存在数据不匹配，您将会看到相应列的不匹配状态。在这种情况下，需要编辑映射，即将数据定向到适当的部分以进行进一步的正确操作。
点击“编辑列”，在编辑模式下，点击要更改值的行中的编辑图标。在“匹配的标题”列中，从下拉列表中选择您希望用更适合CSV文档列内容的值替换自动提取的值。请注意，如果标题包含索引，如果需要，也需要将其替换为所需的值，只需点击文本框并键入所需值。确保在编辑栏中点击保存，以防止更改丢失。
在编辑模式下，您可以看到“跳过”按钮，如果您希望在导入时忽略该列，可以点击该按钮。您还可以在交换列时使用“跳过”按钮，以避免系统显示错误，因为不可能同时为两个列使用相同的值。
当您完成编辑并确保已保存每行编辑的更改后，请单击“完成编辑”。在弹出的窗口中确认操作，然后导入过程将开始。
在操作卡中，您可以看到操作的整体状态以及正在上传的每个实体的上传状态。不要害怕退出卡片并在Rainex中开始其他操作，数据将保存在系统中，当您切换到另一个页面时不会丢失。导入可能需要一些时间，具体取决于导入的数据量。订阅数据将在计费部分的订阅选项卡下显示，因为它们正在加载。
导入完成后，有关操作的数据可以在“操作历史记录”选项卡中找到。
