Paybyidir.ai

Documentación

Guías oficiales para configurar y usar Pay by idir.ai.

Primeros pasos

Guía completa para empezar a usar la plataforma de facturación profesional. Sigue esta secuencia paso a paso para configurar tu cuenta, negocio y comenzar a facturar sin bloqueos.

¿Qué obtienes con esta plataforma?

  • Sistema completo de facturación con gestión de clientes y facturas
  • Generación de PDFs profesionales con códigos QR de pago SEPA
  • API RESTful para integraciones y automatización
  • Encriptación de datos sensibles de clientes (AES-256)
  • Reportes fiscales de IVA e IRPF con exportación CSV
  • Soporte multi-negocio con aislamiento completo de datos
  • Gestión de roles y permisos (administradores y gestores)
  • Sistema de auditoría completo para trazabilidad
  • Descarga masiva de facturas en ZIP
  • Facturación recurrente a múltiples clientes

1. Crear cuenta y verificar correo

Primero crea tu cuenta de usuario. Disponemos de dos métodos de registro: mediante correo electrónico y contraseña, o usando tu cuenta de Google (OAuth). Como titular de cuenta, disfrutarás de un período de prueba de 1 mes desde el registro. La verificación del correo es obligatoria para activar todas las funcionalidades.

Tips & Best Practices

  • Usa una contraseña única de al menos 8 caracteres
  • El email se usará para recuperación de contraseña y notificaciones
  • Google OAuth es más rápido y no requiere gestión de contraseñas
  • Debes aceptar los términos de servicio y política de privacidad
  • El sistema registra tu consentimiento legal con IP y fecha

2. Crear tu negocio

Dentro del dashboard, crea un negocio y completa los datos fiscales obligatorios. Un negocio es la entidad legal que emite facturas. Puedes gestionar múltiples negocios desde una sola cuenta. Cada negocio tiene configuración independiente: datos fiscales, numeración de facturas, impuestos por defecto, datos bancarios y preferencias de idioma.

Tips & Best Practices

  • Razón social: debe coincidir exactamente con tu registro fiscal
  • NIF/CIF: introduce el identificador fiscal sin espacios ni guiones
  • Dirección fiscal: debe ser la dirección registrada oficialmente
  • Configura el patrón de numeración (ej: {SEQ:5}-{YYYY}-{CODE})
  • Define IVA e IRPF por defecto para acelerar la creación de facturas
  • Añade IBAN y datos bancarios para mostrarlos en las facturas
  • El código QR SEPA permite a clientes pagar fácilmente

3. Cargar clientes

Da de alta a tus clientes con nombre completo, identificador fiscal (NIF/CIF) y dirección completa. Los datos sensibles (NIF y dirección) se encriptan automáticamente con AES-256 para máxima seguridad. Puedes crear clientes manualmente uno a uno o importar múltiples clientes mediante CSV.

Tips & Best Practices

  • Cada cliente necesita un identificador único dentro del negocio
  • Completa nombre legal, NIF/CIF, dirección completa y código postal
  • El email del cliente es opcional pero necesario para envío automático
  • Puedes sobrescribir datos de pago específicos por cliente
  • Usa importación CSV para cargar múltiples clientes a la vez
  • El sistema detecta automáticamente delimitadores (coma o punto y coma)
  • Mantén los datos actualizados para evitar problemas fiscales

4. Crear la primera factura

Crea una factura en estado borrador, añade conceptos con base imponible, revisa los cálculos automáticos de IVA e IRPF, y cuando esté lista, cambia el estado a "pendiente" para finalizarla. Las facturas pueden tener múltiples líneas, cada una con su descripción y importe. El sistema calcula automáticamente subtotales, impuestos y total.

Tips & Best Practices

  • Puedes crear una factura para un solo cliente o múltiples a la vez
  • En borrador puedes editar todo libremente sin restricciones
  • Una vez marcada como "pendiente", la factura se finaliza legalmente
  • Las facturas finalizadas no pueden volver a estado borrador
  • Descarga el PDF profesional con código QR de pago SEPA
  • Envía la factura por email directamente desde la plataforma
  • Usa facturas rectificativas para anular o corregir facturas emitidas
  • El sistema genera números de factura automáticamente según tu patrón

5. Exportar y gestionar facturas

Una vez creadas las facturas, puedes exportarlas en diferentes formatos. Descarga PDFs individuales o múltiples facturas en un archivo ZIP. Exporta reportes fiscales en CSV para contabilidad. Consulta el historial de auditoría para ver quién accedió o modificó cada factura.

Tips & Best Practices

  • Descarga múltiples facturas como ZIP seleccionándolas en la lista
  • Exporta reportes fiscales agrupados por tipo de IVA e IRPF
  • Usa exportación CSV para importar datos en tu software contable
  • El sistema registra cada descarga y envío en el log de auditoría
  • Filtra facturas por estado, fecha, cliente o rango temporal
  • Los reportes fiscales incluyen totales por tipo impositivo

6. Integraciones y automatización (opcional)

Para casos de uso avanzados, usa la API RESTful para integrar la plataforma con otros sistemas. Genera tokens API con permisos específicos por negocio. Consulta facturas programáticamente, aplica filtros complejos y descarga datos en formato JSON. La API está documentada con OpenAPI 3.0 con interfaz interactiva.

Tips & Best Practices

  • Crea tokens API desde el dashboard con permisos por negocio
  • Cada token tiene un prefijo visible para identificación
  • Los tokens se hashean con SHA-256 para máxima seguridad
  • Define fecha de expiración (por defecto 180 días)
  • Usa la documentación interactiva OpenAPI para probar endpoints
  • Autenticación mediante header Authorization: Bearer {token}
  • Soporta paginación, filtros por estado y rango de fechas
  • Revoca tokens no utilizados para mantener la seguridad

Funcionalidades avanzadas

Gestión multi-negocio

Administra múltiples empresas desde una sola cuenta. Cada negocio tiene configuración independiente, clientes separados y numeración propia. Ideal para asesores fiscales, gestorías o empresarios con varias sociedades.

Sistema de roles y permisos

Como Super Admin puedes crear Gestores de Facturas y asignarlos a negocios específicos. Los gestores solo ven y gestionan los negocios asignados, con permisos limitados a clientes y facturas.

Facturas rectificativas

Corrige facturas ya emitidas creando facturas rectificativas de reembolso completo. El sistema mantiene la referencia a la factura original y gestiona automáticamente los importes negativos y el cumplimiento fiscal.

Auditoría completa

Registro detallado de todas las acciones: creación, edición, visualización y descarga de facturas. Trazabilidad por usuario, fecha y campos modificados. Datos almacenados de forma inmutable para compliance.

Encriptación de datos

Los datos sensibles de clientes (NIF/CIF y dirección) se encriptan con AES-256-GCM. Las contraseñas usan bcrypt con 12 rounds. Los tokens API se hashean con SHA-256. Cumplimiento GDPR garantizado.

Importación masiva CSV

Importa múltiples clientes a la vez mediante archivos CSV. El sistema detecta automáticamente delimitadores, valida datos y te muestra errores específicos para que puedas corregirlos fácilmente.