Stripe Invoice

Stripe Invoice gestiona las facturas de tu cuenta de Stripe y los conceptos que las componen. Con él puedes preparar una factura para un cliente, añadirle conceptos, emitirla, enviarla por correo, cobrarla o anularla, y también consultar las facturas que ya existen.

El campo Type decide con qué trabajas: Invoice para la factura en sí o Invoice Item para los conceptos (líneas con importe) que se facturan a un cliente. Al cambiarlo, cambian las operaciones disponibles.

Cuándo usarlo

Al terminar un servicio, quieres añadir el concepto al cliente y emitirle la factura sin entrar en Stripe.
Quieres enviar por correo una factura con un plazo de pago de 30 días.
Cada mes quieres revisar las facturas abiertas o impagadas de tus clientes.
Se ha emitido una factura por error y quieres anularla.

Configuración

Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Stripe API de tu cuenta.
Type	`Invoice` para trabajar con facturas o `Invoice Item` para trabajar con conceptos de factura. Por defecto, `Invoice`.
Operation (obligatorio)	La acción que realiza el componente. Las opciones dependen de Type. Consulta Operaciones.
Mode	Solo en Get. `By ID` consulta un elemento concreto; `All` devuelve la lista. Por defecto, `By ID`.
ID	El identificador de la factura (empieza por `in_`) o del concepto (empieza por `ii_`). Obligatorio en Get con `By ID` y en todas las operaciones salvo Create.
Customer ID	El identificador del cliente en Stripe (empieza por `cus_`). Obligatorio en Create. En Get con `All`, muestra solo los elementos de ese cliente.
Amount	Solo con `Invoice Item`, en Create (obligatorio) y Update. Importe del concepto en la unidad más pequeña de la moneda, por ejemplo céntimos: `1000` son 10,00.
Currency	Solo con `Invoice Item` en Create, y obligatorio en ella. La moneda del concepto, como `eur` o `usd`. Por defecto, `usd`.
Description	Texto descriptivo de la factura o del concepto. En Create y Update.
Collection Method	Solo con `Invoice`, en Create y Update. `charge_automatically` cobra la factura a la forma de pago del cliente; `send_invoice` se la envía por correo para que la pague. Vacío, se usa lo que tenga configurado Stripe.
Days Until Due	Solo con `Invoice`, en Create y Update. Días que tiene el cliente para pagar. Solo se aplica cuando Collection Method es `send_invoice`. Por defecto, 30.
Footer	Solo con `Invoice`, en Create y Update. Texto que aparece al pie de la factura.
Status Filter	Solo con `Invoice` en Get con `All`. Devuelve solo las facturas en ese estado: `draft` (borrador), `open` (emitida y pendiente), `paid` (pagada), `void` (anulada) o `uncollectible` (incobrable).
Invoice ID	Solo con `Invoice Item`, en Create y en Get con `All`. La factura a la que pertenece el concepto. En Create, si lo dejas vacío, el concepto queda pendiente y entra en la próxima factura del cliente.
Limit	Solo en Get con `All`. Número máximo de elementos que se devuelven, entre 1 y 100. Por defecto, 100.

Operaciones

Con Type en Invoice:

Create: crea una factura en borrador para el cliente. Incluye los conceptos que el cliente tenga pendientes de facturar.
Delete: elimina una factura en borrador.
Finalize: emite una factura en borrador para que se pueda pagar. Solo funciona con facturas en estado draft.
Get: con By ID devuelve una factura; con All devuelve la lista, filtrada por cliente o estado si lo indicas.
Pay: intenta cobrar ahora una factura emitida. Solo funciona con facturas en estado open; si está en borrador, emítela antes con Finalize.
Send: envía la factura al cliente por correo. Solo funciona si su Collection Method es send_invoice.
Update: cambia la descripción, la forma de cobro, el plazo de pago o el pie de una factura.
Void: anula una factura emitida. Solo funciona con facturas en estado open; una factura pagada no se puede anular, en ese caso haz una devolución con Stripe Refund.

Con Type en Invoice Item:

Create: añade un concepto con importe al cliente, en una factura concreta o pendiente para la siguiente.
Delete: elimina un concepto.
Get: con By ID devuelve un concepto; con All devuelve la lista, filtrada por cliente o factura si lo indicas.
Update: cambia el importe o la descripción de un concepto.

Si una operación no se puede hacer por el estado de la factura, el componente se detiene con un mensaje que explica el motivo.

Resultado

La salida Data devuelve la factura o el concepto con el que has trabajado. Con Get y All, devuelve un elemento por cada uno. Cada factura incluye, entre otros datos de Stripe, su identificador, su estado, el importe total y pendiente y el enlace para que el cliente la vea y la pague.

Puedes conectarla a un correo, a tu sistema de contabilidad o a una condición que compruebe el estado. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una consultora factura cada proyecto cuando lo cierra.

Añade Stripe Invoice con Type en Invoice Item y Operation en Create. Indica el Customer ID del cliente, el Amount del proyecto en céntimos, Currency en eur y una Description.
Añade otro Stripe Invoice con Type en Invoice y Operation en Create para el mismo cliente, con Collection Method en send_invoice y Days Until Due en 30. La factura recoge el concepto pendiente.
Añade un tercero con Operation en Finalize y pasa a ID el identificador de la factura creada.
Termina con uno más con Operation en Send para que el cliente la reciba por correo.

Componentes relacionados

Stripe Customer: crea y gestiona clientes.
Stripe Subscription: facturación periódica con suscripciones.
Stripe Refund: devuelve un pago.