Configuración de ImportadorStripe
Para poder usar el complemento ImportadorStripe es necesario configurar ciertos aspectos:
1. Ajustes del complemento
Desde el menú Ajustes del complemento se agrega la configuración necesaria:
Nombre de la cuenta en Stripe: Identificador interno para la cuenta de Stripe con la que estás trabajando.
Clave secreta (sk_xxx): Tu clave privada de Stripe, necesaria para la conexión API.
Serie: Serie por defecto para las facturas generadas (a menos que el cliente ya tenga una serie asignada).
Código del cliente por defecto: Cliente que se asignará en modo automático cuando el cliente de Stripe no haya sido vinculado aún.
Código del producto por defecto: Producto que se asignará en modo automático cuando el producto de Stripe no haya sido vinculado aún.
Email técnico para gestión de errores: Si al generar una factura ocurre un error, se envía una notificación a este email. Es muy útil en modo automático.
Enviar email al cliente cuando se genere la factura: Configura si se envía automáticamente la factura al cliente o no.
2. Vincular productos
Desde el menú «Productos» del complemento debemos vincular los productos de Stripe con productos de ElequipoIA.
3. Vincular clientes
Desde el menú «Clientes» del complemento podemos vincular nuestros clientes de Stripe con nuestros clientes de ElequipoIA.
Funcionamiento
Funcionamiento manual
Vamos a la sección «Facturas» del complemento.
Seleccionamos la cuenta de Stripe y definimos el intervalo de tiempo.
Se cargarán las facturas pendientes de procesar en Stripe.
Pulsamos el signo «+» en la factura deseada.
El sistema comprobará si el cliente de Stripe está vinculado. Si no lo está, nos dará la opción de asociarlo a un cliente existente o crear uno nuevo.
Podemos indicar si la factura generada debe marcarse como pagada y si se debe enviar por email automáticamente.
Funcionamiento automático (Webhook)
En el menú Ajustes del complemento, se proporciona la URL de conexión (webhook) necesaria.
En Stripe, ve a Desarrolladores > Webhooks y añade un nuevo punto de conexión con la siguiente configuración:
URL del punto de conexión: La URL proporcionada por el complemento (ej:
https://tuelequipoia.com/WebhookStripe?source=xxx).Escuchar: Eventos en tu cuenta.
Eventos: Selecciona
Invoice>invoice.payment_succeeded.
Una vez configurado, Stripe notificará automáticamente a ElequipoIA cuando se complete un pago, y se generará la factura correspondiente de forma automática.
Nota importante: Tu instalación de ElequipoIA debe estar accesible desde internet bajo un dominio (no en localhost) para que Stripe pueda conectarse.
Impuestos definidos en lineas de suscripción
La prioridad es
Impuesto de línea: Impuesto específico aplicado a una línea concreta de la suscripción o factura.
Impuesto por defecto: Impuesto general aplicado por defecto a toda la suscripción o factura.
Impuesto de artículo de Fs: Impuesto configurado directamente en el artículo (producto) dentro de ElequipoIA.
