# Clientes y personas

## Clientes

En Piriod, los **clientes** representan a tus suscriptores, ya sean empresas (B2B) o personas naturales (B2C). Este objeto centraliza toda la información necesaria para gestionar la relación comercial y automatizar la facturación y los pagos.

Aquí puedes almacenar:

* Información de contacto
* Información fiscal
* Métodos y detalles de pago
* Historial de facturación
* Suscripciones activas
* Metadatos personalizados

Tener los datos correctamente configurados permite reducir errores en la emisión de documentos y facilita la automatización de cobros recurrentes.

***

### Formas de crear un cliente

Al igual que otros recursos en Piriod, los clientes pueden crearse de distintas formas según tu flujo de trabajo:

#### Desde el panel de Piriod

Puedes crear clientes manualmente desde la interfaz del sistema.

**Ruta:**\
Contactos → Clientes → Nuevo

Ideal cuando necesitas ingresar clientes de forma puntual o realizar ajustes manuales.

#### Creación por lote

Permite crear múltiples clientes en una sola acción mediante la carga de un archivo estructurado.

Recomendado cuando migras información desde otro sistema o necesitas cargar una base de clientes completa.

Consulta la guía de [importación de clientes](https://docs.piriod.com/guide/settings/imports/customers) para conocer el formato requerido.

#### Desde Signup Forms

[Signup Forms](https://docs.piriod.com/guide/components/signup-forms) permite incrustar formularios en tu sitio web o aplicación para que tus clientes se registren y se suscriban de forma autónoma a tus planes.

Esta opción reduce fricción en el proceso de alta y evita el ingreso manual de información.

#### A través de la API de Piriod

Puedes crear clientes mediante integraciones utilizando el recurso **Create a customer** de la API.

Esta opción es útil cuando necesitas sincronizar datos desde otros sistemas o automatizar procesos de registro.

***

### Crear un cliente desde el panel de Piriod

1. Ve al menú **Contactos → Clientes**
2. Haz clic en **Nuevo**
3. Completa:
   * Información básica
   * Información fiscal
   * Información de contacto
4. Haz clic en **Crear cliente**

Una vez creado, el cliente quedará disponible para asociar suscripciones, emitir documentos y registrar pagos.

***

### Visualizar clientes

Para acceder al listado de clientes:

**Ruta:**\
Contactos → Clientes

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FuaJl8wc4bMMUj8nky9LV%2FCaptura%20de%20pantalla%202026-04-07%20a%20la(s)%2017.38.13.png?alt=media&#x26;token=f35037da-4364-48ee-8f6b-f36d13ad0bda" alt=""><figcaption></figcaption></figure>

Al ingresar al detalle de un cliente podrás visualizar toda la información relacionada:

#### Resumen transaccional

Vista general del comportamiento comercial del cliente:

* Ventas totales
* Ventas del mes actual
* Balance

#### Información general

Datos básicos del cliente, como nombre, identificador fiscal y datos de contacto.

#### Información de facturación

Configuración utilizada para la emisión de documentos tributarios.

#### Tarjetas

En el detalle del cliente podrás visualizar las tarjetas registradas.

Consulta la guía de [**Tarjetas**](https://docs.piriod.com/guide/revenues/tarjetas) para conocer cómo registrar y administrar tarjetas de clientes.

#### Últimos pagos

Registro de pagos recientes realizados por el cliente.

#### Últimas facturas

Acceso rápido a los documentos emitidos más recientes.

#### Suscripciones

Detalle de las suscripciones activas, pausadas o finalizadas.

#### Unidades organizativas

Las **unidades organizativas** permiten dividir un cliente empresa en áreas como sucursales o departamentos, facilitando la asignación de contactos específicos para recibir notificaciones de facturación y pagos.

Revisa la sección[ **Unidades organizativas**](#unidades-organizativas-1) para más detalles.

#### Metadatos

Los metadatos permiten agregar información personalizada a un cliente mediante pares **clave-valor**.

Este recurso es útil para almacenar información adicional estructurada, por ejemplo:

* ID interno de otro sistema
* Segmento de cliente
* Ejecutivo responsable
* Información comercial específica

Los metadatos pueden gestionarse desde el panel de Piriod o mediante la API de **Customers**.

***

### Acciones del cliente

Desde el detalle del cliente puedes acceder a distintas acciones que permiten administrar su información, gestionar comunicaciones y mantener tu base de datos ordenada.

Estas acciones se encuentran disponibles en la parte superior derecha de la vista de cliente:

* **Editar:** permite modificar la información del cliente.
* **Enviar deuda:** permite enviar un correo con el detalle de facturas pendientes de pago.
* **Configurar mensajería** (⚙️)**:** permite definir la configuración de notificaciones asociadas al cliente.
* **Archivar:** permite desactivar el cliente manteniendo su historial.
* **Eliminar:** permite borrar el cliente cuando no tiene registros asociados.

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FbpktgKhPBJz7fuDfOjgL%2FCaptura%20de%20pantalla%202026-04-07%20a%20la(s)%2019.07.49.png?alt=media&#x26;token=84bba042-87fd-4cc4-a783-35883c0b02ab" alt=""><figcaption></figcaption></figure>

Cada acción se detalla en las siguientes secciones de esta guía.

***

### Editar un cliente

Puedes modificar la información de un cliente en cualquier momento.

1. Ve a la vista de detalle del cliente
2. Haz clic en **Editar**
3. Actualiza la información básica, fiscal o de contacto
4. Haz clic en **Guardar**

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2F8X01u4i6lYTS5yox38zw%2FCaptura%20de%20pantalla%202026-04-07%20a%20la(s)%2018.04.30.png?alt=media&#x26;token=fca5f6d2-6fe4-4787-b5ce-bc1cbbac8169" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
En organizaciones que operan en países donde la validación fiscal es realizada por una autoridad tributaria, el **ID fiscal no puede ser modificado** una vez creado el cliente.
{% endhint %}

***

### Enviar deuda

La opción **Enviar deuda** permite enviar un correo electrónico al cliente con el detalle de todas sus facturas pendientes de pago.

El correo incluye:

* Resumen de documentos pendientes
* Monto total adeudado
* Fechas de vencimiento
* Facturas adjuntas en PDF
* Botón de pago para pagar cada documento individualmente
* Mensaje editable antes del envío

El destinatario podrá ser una persona asociada al cliente que tenga habilitadas notificaciones de facturación o la dirección de correo principal del cliente.

#### Cómo enviar el detalle de deuda

1. Ve al menú **Contactos → Clientes**
2. Ingresa al detalle del cliente
3. Haz clic en **Enviar deuda**
4. Selecciona el destinatario
5. Ingresa el asunto del correo
6. Ajusta el mensaje si lo deseas
7. Haz clic en **Enviar**

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FhcZZ828TiM1o3YAjGXzy%2FCaptura%20de%20pantalla%202026-04-07%20a%20la(s)%2018.44.18.png?alt=media&#x26;token=fb8d61f1-05dd-4cd9-9b48-2e759e68f78e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Tip:** puedes utilizar esta opción como recordatorio de pago manual o cuando necesites consolidar múltiples documentos pendientes en un solo correo.
{% endhint %}

***

### Configurar mensajería (Beta)

La opción **Configurar mensajería** permite definir qué tipos de correos automáticos puede recibir un cliente.

Esta configuración ayuda a controlar las notificaciones enviadas desde Piriod, asegurando que cada cliente reciba únicamente las comunicaciones relevantes para su operación.

Si deshabilitas un tipo de mensaje, el cliente dejará de recibir esos correos de forma automática.

#### Tipos de correos disponibles

Puedes habilitar o deshabilitar el envío automático de:

* **Facturas:** correos enviados al emitir documentos de facturación
* **Cobranzas:** recordatorios o notificaciones relacionadas con pagos pendientes
* **Comprobantes de pago:** confirmaciones enviadas cuando se registra un pago

#### Cómo configurar la mensajería de un cliente

1. Ve al menú **Contactos → Clientes**
2. Ingresa al detalle del cliente
3. Haz clic en el ícono de configuración (⚙️)
4. Activa o desactiva los tipos de correos según corresponda
5. Los cambios se guardan automáticamente

{% hint style="info" %}
**Tip:** esta configuración permite personalizar la comunicación con cada cliente y evitar el envío de correos innecesarios.
{% endhint %}

***

### Archivar un cliente

La opción **Archivar cliente** permite desactivar un registro sin eliminar su información ni su historial.

Al archivar un cliente, este deja de estar disponible para nuevas operaciones, pero se conservan sus datos, documentos y relaciones para consulta futura.

Esta opción es especialmente útil cuando:

* Un cliente ya no tiene actividad comercial
* Necesitas mantener orden en tu base de datos
* Deseas evitar el uso accidental de clientes antiguos
* El cliente tiene facturas, pagos o suscripciones asociadas que deben mantenerse como respaldo histórico

#### Cómo archivar un cliente

1. Ve al menú **Contactos → Clientes**
2. Ingresa al detalle del cliente
3. Haz clic en **Archivar**
4. Confirma la acción

El cliente archivado dejará de aparecer en los listados activos, pero su información seguirá disponible para consulta.

{% hint style="info" %}
**Tip:** archivar es la opción recomendada cuando el cliente tiene historial en el sistema.
{% endhint %}

{% hint style="warning" %}
Esta acción no se puede deshacer.
{% endhint %}

***

### Eliminar un cliente

La opción **Eliminar cliente** permite borrar permanentemente un registro cuando fue creado por error o no será utilizado.

A diferencia de archivar, eliminar un cliente lo remueve completamente del sistema.

#### Condiciones para eliminar un cliente

Un cliente solo puede ser eliminado si **no tiene registros asociados**, tales como:

* Tarjetas
* Suscripciones
* Facturas
* Pagos u otros documentos relacionados

Si el cliente tiene información vinculada, se recomienda utilizar la opción **Archivar** en su lugar.

#### Cómo eliminar un cliente

1. Ve al menú **Contactos → Clientes**
2. Ingresa al detalle del cliente
3. Haz clic en **Eliminar**
4. Confirma la acción

{% hint style="warning" %}
Esta acción no se puede deshacer.
{% endhint %}

{% hint style="info" %}
**Tip:** eliminar es útil cuando se crean clientes duplicados o registros de prueba que no serán utilizados.
{% endhint %}

***

### Creación de clientes por lote

Si necesitas crear múltiples clientes simultáneamente, utiliza la funcionalidad de importación.

Consulta la guía de [**importación de clientes**](https://docs.piriod.com/guide/settings/imports/customers) para conocer el paso a paso y el formato del archivo.

***

### Unidades organizativas

Las unidades organizativas permiten estructurar áreas internas de un cliente de tipo empresa, como departamentos, sucursales o divisiones de negocio.

Por ejemplo:

* Área de finanzas de una empresa
* Sucursal específica
* Unidad regional
* División comercial

Actualmente permiten:

* Asociar personas o contactos a una unidad específica dentro del cliente

Esto ayuda a dirigir correctamente notificaciones y comunicaciones.

### Formas de crear una unidad organizativa

#### Desde el panel de Piriod

**Ruta:**\
Contactos → Clientes → seleccionar cliente → sección Unidades organizativas

#### A través de la API de Piriod

Puedes crear unidades organizativas utilizando el recurso **Create a org unit** de la API.

### Crear una unidad organizativa desde el panel de Piriod

1. Ve al menú **Contactos → Clientes**
2. Selecciona un cliente
3. Dirígete a la sección **Unidades organizativas**
4. Haz clic en **+ Nuevo**
5. Ingresa el nombre de la unidad organizativa
6. Haz clic en **Crear**

### Asignar personas o contactos a una unidad organizativa

Asignar personas a unidades organizativas permite definir quiénes recibirán notificaciones sobre facturas, pagos o recordatorios asociados al cliente.

Para asignar una persona:

1. Asegúrate de que el cliente tenga al menos una unidad organizativa creada
2. Ve al detalle de la persona o contacto
3. Verifica que esté vinculado al cliente correspondiente
4. Selecciona la unidad organizativa
5. El cambio se guardará automáticamente

***

## Personas

Las **personas** representan contactos reales asociados a un cliente.

Permiten almacenar información de contacto y definir qué tipo de notificaciones recibirá cada persona, como avisos de facturación, pagos o recordatorios.

Un cliente puede tener múltiples personas asociadas.

### Formas de crear una persona

#### Desde el panel de Piriod

**Ruta:**\
Contactos → Personas → Crear

#### A través de la API de Piriod

Puedes crear personas utilizando el recurso **Create a contact** de la API.

***

### Crear una persona desde el panel de Piriod

1. Ve al menú **Contactos → Personas**
2. Haz clic en **Nuevo**
3. Completa la información de contacto
4. Activa o desactiva las notificaciones que correspondan
5. Haz clic en **Crear persona**

### Asociar una persona a un cliente

Para vincular una persona a un cliente:

1. Ve al detalle de la persona
2. Haz clic en **Vincular cliente**
3. Selecciona el cliente correspondiente
4. Confirma la selección

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FvGTjWMBWaRMUgvF8GAjK%2FCaptura%20de%20pantalla%202026-04-07%20a%20la(s)%2019.13.39.png?alt=media&#x26;token=abe397ca-d65d-4ef8-aec0-12646b2e7871" alt=""><figcaption></figcaption></figure>

### Editar una persona

1. Ve al detalle de la persona
2. Haz clic en **Editar**
3. Actualiza la información de contacto
4. Ajusta las preferencias de notificación según corresponda
5. Haz clic en **Guardar**