> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piriod.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clientes

En Piriod, los clientes representan a tus suscriptores, ya sean empresas (B2B) o personas naturales (B2C). Cada cliente centraliza toda la información necesaria para gestionar la relación comercial y automatizar la facturación y los cobros — datos de contacto, información fiscal, métodos de pago, historial de facturación y suscripciones activas.

***

### Crear un cliente

**Contactos → Clientes → Nuevo**

Completa la información básica, fiscal y de contacto, luego haz clic en **Crear cliente**. Una vez creado, el cliente quedará disponible para asociar suscripciones, emitir documentos y registrar pagos.

También puedes crear clientes de otras formas:

* **Por lote** — carga un archivo estructurado para crear múltiples clientes a la vez. Consulta la guía de **<u>importación de clientes</u>**
* **Desde Signup Forms** — tus clientes se registran de forma autónoma al suscribirse a un plan
* **Vía API** — usa el recurso **Create a customer** para sincronizar desde otros sistemas

***

### Listado de clientes

Desde **Contactos → Clientes** puedes ver todos tus clientes, filtrarlos y acceder al detalle de cada uno.

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(33).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=0fcf37348304f5a3aca5ea2fa5e565af" alt="Image (33)" width="2304" height="1273" data-path="images/image-(33).png" />
</Frame>

***

### Detalle de un cliente

Al abrir un cliente puedes ver toda su información relacionada:

* **Resumen transaccional** — ventas totales, ventas del mes y balance
* **Información general** — nombre, ID fiscal y datos de contacto
* **Información de facturación** — configuración para emisión de documentos
* **Tarjetas** — métodos de pago registrados. Ver [Tarjetas](https://docs.piriod.com/guide/revenues/tarjetas)
* **Últimos pagos y facturas** — acceso rápido al historial reciente
* **Suscripciones** — activas, pausadas y finalizadas
* **Unidades organizativas** — áreas internas del cliente (ver más abajo)
* **Metadatos** — información personalizada en pares clave-valor

***

### Acciones disponibles

Desde la parte superior derecha del detalle del cliente tienes acceso a las siguientes acciones:

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(34).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=4848151ddd8d14103a08d2e056070e0a" alt="Image (34)" width="1186" height="140" data-path="images/image-(34).png" />
</Frame>

#### Enviar deuda

Envía un email al cliente con el detalle consolidado de todas sus facturas pendientes. El correo incluye un resumen de documentos, montos, fechas de vencimiento, las facturas adjuntas en PDF y un botón de pago por cada documento.

1. Haz clic en **Enviar deuda**
2. Selecciona el destinatario
3. Ingresa el asunto
4. Ajusta el mensaje si lo deseas
5. Haz clic en **Enviar**

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(36).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=714b8966fe5df1dbabc43c23495ec455" alt="Image (36)" width="1718" height="1272" data-path="images/image-(36).png" />
</Frame>

#### Editar

Modifica la información básica, fiscal o de contacto del cliente en cualquier momento.

1. Haz clic en **Editar**
2. Actualiza la información
3. Haz clic en **Guardar**

<Frame>
  <img src="https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-(35).png?fit=max&auto=format&n=CyasDKczYvaYYs01&q=85&s=94953b741f88ce4118313f27012fed6e" alt="Image (35)" width="2304" height="1269" data-path="images/image-(35).png" />
</Frame>

<Info>
  En organizaciones donde la validación fiscal es realizada por una autoridad tributaria, el **ID fiscal no puede modificarse** una vez creado el cliente.
</Info>

#### Configurar mensajería

Define qué tipos de correos automáticos puede recibir el cliente. Si deshabilitas un tipo, el cliente dejará de recibir esas notificaciones.

Tipos disponibles:

* **Facturas** — correos al emitir documentos
* **Cobranzas** — recordatorios de pago pendiente
* **Comprobantes de pago** — confirmaciones al registrar un pago

Los cambios se guardan automáticamente.

#### Archivar

Desactiva el cliente sin eliminar su información ni historial. El cliente deja de aparecer en los listados activos pero sus datos siguen disponibles para consulta.

Recomendado cuando el cliente ya no tiene actividad comercial o tiene registros asociados que deben conservarse.

<Warning>
  Esta acción no se puede deshacer.
</Warning>

#### Eliminar

Elimina permanentemente el cliente. Solo disponible cuando no tiene registros asociados — tarjetas, suscripciones, facturas o pagos. Si tiene historial, usa **Archivar** en su lugar.

<Warning>
  Esta acción no se puede deshacer.
</Warning>

***

### Unidades organizativas

Las unidades organizativas permiten estructurar áreas internas de un cliente empresa — departamentos, sucursales, divisiones — y asignar personas específicas a cada una para dirigir correctamente las notificaciones de facturación y cobros.

#### Crear una unidad organizativa

1. Ve al detalle del cliente
2. Dirígete a la sección **Unidades organizativas**
3. Haz clic en **+ Nuevo**
4. Ingresa el nombre
5. Haz clic en **Crear**

También puedes crearlas vía API usando el recurso **Create a org unit**.

#### Asignar personas a una unidad organizativa

1. Asegúrate de que el cliente tenga al menos una unidad organizativa creada
2. Ve al detalle de la persona
3. Selecciona la unidad organizativa correspondiente

El cambio se guarda automáticamente.
