Skip to main content

Documentation Index

Fetch the complete documentation index at: https://piriod-d406ac55.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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 importación de clientes
  • 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.
Image (33)

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
  • Ú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:
Image (34)

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
Image (36)

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
Image (35)
En organizaciones donde la validación fiscal es realizada por una autoridad tributaria, el ID fiscal no puede modificarse una vez creado el cliente.

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.
Esta acción no se puede deshacer.

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.
Esta acción no se puede deshacer.

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.