Migración

El proceso de migración consiste en la importación de la información que proviene de otras fuentes y que es necesario canalizar a través de Piriod. Dentro de los datos a importar se encuentra la base de clientes, suscripciones, planes y productos. Para realizar este proceso de forma masiva, contamos con formatos estandarizados para facilitar el trabajo de importación.

Clientes

Los clientes son utilizados por Piriod para almacenar toda la información de un suscriptor. Ya sea una empresa (B2B) o una persona (B2C) el cliente es el objeto base para almacenar y administrar la información de contacto y facturación de los suscriptores, los detalles de la tarjeta y el modo de pago.

ColumnaDescripción
nameNombre o Razón Social del cliente.
No utilizar caracteres especiales (ñ, tildes, símbolos)
addressDirección del cliente.
No utilizar caracteres especiales (ñ, tildes, símbolos)
emailDirección de correo electrónico del cliente.
En minúsculas y sin espacios.
stateEstado o región del cliente.
En codificación ISO, revisa el listado con los estados en el siguiente link https://docs.piriod.com/docs/base-states
countryPais de origen del cliente.
En codificación ISO, revisa el listado de los países en el siguiente link https://docs.piriod.com/docs/base-states
tax_idNúmero de identificación fiscal del cliente (RUT, RUC, NIT, etc.).
Sin puntos, sin espacios y con guión (si aplica).
tax_settingsDescripción de actividad o giro comercial del cliente. Ejemplo: Venta de abarrotes
websiteSitio web del cliente. (opcional)
phoneTeléfono del cliente. (opcional)
currencyMoneda de facturación del cliente en codificación ISO, revisa el listado de monedas disponibles en el siguiente link https://docs.piriod.com/docs/base-currencies

👍

Archivo de ejemplo

Haz clic en el siguiente enlace para descargar un archivo de ejemplo: Plantilla de ejemplo para carga de clientes

Productos y planes

Los Planes en Piriod permiten definir de manera exacta cuando y como se cobra determinado Producto/Servicio en una suscripción. Se pueden crear múltiples planes de precio para un solo producto, cada uno con su información específica como moneda, precio, frecuencia de facturación entre muchas otras características.

ColumnaDescripción
idIdentificador único del plan.
productidentificador único del producto
nameNombre del plan.
Limite máximo de caracteres 56.
descriptionDescripción del plan.
Límite máximo de caracteres 200.
frequencyIndica la duración del ciclo de la suscripción.
Ejemplo: Annual, Semestral, Mensual
currencyMoneda con el que se facturará el plan.
Ejemplo: USD - CLP
amountValor del plan.

En Piriod los Productos/Servicios son la base de todas las suscripciones, a partir de estos puedes crear múltiples planes de precio relacionados o asociados a un solo Producto/Servicio. A su vez puedes crear diversos Productos/Servicios de acuerdo a las múltiples áreas que desees promocionar u ofrecer a tus clientes referente a su modelo de negocio u organización.

ColumnaDescripción
idIdentificador único del producto.
nameNombre del producto, este aparecerá en las facturas asociadas.
Límite máximo de caracteres 56.
unit_labelEtiqueta de unidad. Se refiere a la unidad en la que se representa el producto/servicio, puede ser una (cuenta, pase, usuario etc), esta aparecerá en el campo unidad en las futuras facturas asociada.

👍

Archivo de ejemplo

Haz clic en el siguiente enlace para descargar un archivo de ejemplo: Plantilla de ejemplo para carga de productos y planes

Suscripciones

Una suscripción representa la conexión entre un cliente y los productos o servicios a los que se suscribe y paga. Además determina la frecuencia con la que se les factura y cobra de forma periódica.

ColumnaDescripción
idIdentificador único de la suscripción.
tax_idNúmero fiscal del cliente (RUT, RUC, NIT, etc).
El formato para este campo debe ser sin puntos, sin espacios y con guión (si aplica).
date_startFecha de inicio de la suscripción.
Formato aaaa-mm-dd
billing cyclesDetermina la cantidad de ciclos (futuros) de facturación de la suscripción.
Este campo no es obligatorio. Si queda vacío se entiende que la suscripción no tiene fecha de término definido. Este campo es editable desde la interfaz.
noteDescripción de la suscripción.
Esta es la información que se agregará como glosa en la factura.
documentTipo de documento que generará la suscripción.
Para ver los tipos de documentos disponibles puedes revisar el siguiente link https://docs.piriod.com/docs/facturas#tipos-de-factura
custom_changePuedes definir un tipo de cambio personalizado para la suscripción.
Si el campo queda en blanco Piriod usará el tipo de cambio de acuerdo a la fecha del ciclo de facturación de la suscripción.

Lines

El line Piriod lo utiliza como nexo entre las suscripciones, planes y productos. Este concepto se transforma en el puente que conecta toda esta información y así presentarla unificada en la interfaz de usuario.

ColumnaDescripción
idIdentificador único del line.
subscriptionIdentificador único de la suscripción.
planIdentificador único del plan.
quantityIndica la cantidad suscrita del plan.
Ej.: Si el valor del plan es 10 USD y la cantidad es 2 el total a cobrar será 20 USD.

👍

Archivo de ejemplo

Haz clic en el siguiente enlace para descargar un archivo de ejemplo: Plantilla de ejemplo para carga de suscripciones y lineas de suscripción.