Plugin ImportadorStripe para FacturaScripts

Stripe es un sistema de pagos online que entre otras cosas nos permite gestionar cobros recurrentes de servicios a los que se suscriben nuestros clientes y generar las facturas correspondientes a esos cobros. El problema de esas facturas es que puede que no nos sean utiles y tengamos que duplicar trabajo transcribiendolas a nuestro programa de facturación.
Este plugin permite crear facturas en Facturascripts a partir de las facturas que se generan en Stripe.
Además se pueden vincular artículos de Fs con los productos de Stripe.

## Configuración
Para poder usar el plugin ImportadorStripe es necesario configurar ciertos aspectos:

1- Desde el menú *Ajustes* es donde agregamos la configuración necesaria para que funcione el plugin.

- Nombre de la cuenta en Stripe: Es interno, este nombre identifica la cuenta de Stripe con la que estás trabajando.
- Clave secreta (sk_xxx): Es tu clave privada de stripe, necesaria para la conexión.
- Serie: Es la serie por defecto para tus facturas siempre y cuando no tengas una serie configurada en el cliente.
- Código del cliente por defecto: Este campo es necesario si utilizas el modo automático. Este cliente será el asignado cuando el cliente de stripe no haya sido vinculado.
- Código del producto por defecto: Este campo es necesario si utilizas el modo automático. A este producto será el asignado cuando el producto de stripe no haya sido vinculado.
- Email técnico para gestión de errores: Si al generar una factura da error, se le envía a este email. Es muy útil cuando lo tienes en modo automático ya que te da la tranquilidad de controlar las que den error.
- Enviar email al cliente cuando se genere la factura: Para configurar si queremos enviar la factura automáticamente al cliente o no.

2- Desde el menú *Productos* debemos vincular los productos de Stripe con productos de Facturascript.

3.- Desde el menú "Clientes" podemos vincular nuestros clientes de stripe con nuestros clientes de facturascripts.

## Funcionamiento

### Funcionamiento manual
Vamos a la sección *Facturas*, seleccionamos la cuenta de Stripe de la que deseamos importar y definimos el intervalo
de tiempo. Se cargarán las facturas que hay en Stripe pendientes de procesar. Solo tenemos que pulsar sobre el signo "más"
de la factura. El sistema comprobará si el cliente de la factura de Stripe tiene una correlación con un cliente de Facturascripts.
En caso afirmativo continuará, si no te dará la opción de asociarlo a un cliente existente o bien crear un nuevo cliente.
Por último podemos indicar si la factura generada tiene que darse por pagada y si se debe enviar por email a la dirección de la
ficha del cliente de Facturascripts.

### Funcionamiento automático
En el menú ajustes, te proporcionamos la url de conexión necesaria para configurar un punto de conexión en Stripe dentro de la sección "claves privadas". Ten en cuenta que tu Facturascripts tiene que estar conectado a internet bajo un dominio, ya que Stripe tiene que ser capaz de conectarse con tu Facturascripts mediante una url parecida a esta: https://tufacturascripts.com/WebhookStripe?source=733bb7e2cbfc486375ce01a999da1280

Una vez ya tienes la ruta, tienes que irte a Stripe >> desarrolladores >> Webhooks y añadir un punto de conexión. Tienes que configurar los siguientes campos:
- URL del punto de conexión: ** tu ruta de conexión **
- Descripción: (Opcional) Por si la quieres identificar
- Escuchar: ** Eventos en tu cuenta **
- Versión: ** Tu versión actual **
- Eventos: Cuando pulsas en "Seleccionar eventos", tienes que pulsar sobre "Invoice" y luego sobre "invoice.payment_succeeded"

Finalmente, pulsas sobre "Añadir punto de conexión" y ya lo tienes configurado.