Stripe - Crear Factura

Descripcion

Este módulo permite crear facturas manuales para clientes. Puede agregar items, configurar el método de cobro, finalizar y enviar la factura automáticamente.

Configuración

Credenciales Requeridas

• Secret Key: Clave secreta de Stripe

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Stripe
customer_id	string	Sí	ID del cliente (cus_xxx)
items	string	No	Items de la factura (JSON array)
collection_method	select	No	Método de cobro
days_until_due	number	No	Días para pagar (default: 30)
description	string	No	Descripción de la factura
footer	string	No	Pie de página
finalize	boolean	No	Finalizar inmediatamente
send_invoice	boolean	No	Enviar por email
metadata	string	No	Metadatos personalizados (JSON)

Formato de Items

[
  {
    "amount": 99.99,
    "currency": "usd",
    "description": "Servicio de consultoría"
  },
  {
    "price_id": "price_xxx",
    "quantity": 2
  }
]

Salida

{
  "success": true,
  "invoice": {...},
  "invoice_id": "in_1MtHbELkdIwHu7ixl4OzzPMv",
  "number": "INV-0001",
  "status": "open",
  "amount_due": 99.99,
  "hosted_invoice_url": "https://invoice.stripe.com/...",
  "message": "Factura INV-0001 creada (open)"
}

Ejemplo de Uso

Factura simple con cobro automático

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 150, \"description\": \"Servicio mensual\"}]",
  "finalize": true
}

Factura con múltiples items

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 100, \"description\": \"Consultoría\"}, {\"amount\": 50, \"description\": \"Soporte adicional\"}]",
  "description": "Servicios de enero 2024",
  "finalize": true,
  "send_invoice": true
}

Factura con vencimiento

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "items": "[{\"amount\": 500, \"description\": \"Proyecto X\"}]",
  "collection_method": "send_invoice",
  "days_until_due": 15,
  "footer": "Gracias por su preferencia",
  "finalize": true,
  "send_invoice": true
}

API Utilizada

• Endpoint: POST /v1/invoices, POST /v1/invoiceitems
• Documentación: Stripe Create Invoice

Notas

• Los items pueden ser montos únicos o precios recurrentes
• finalize: true bloquea la factura para edición
• send_invoice: true envía email al cliente
• Las facturas no finalizadas son borradores editables
• El cliente puede pagar via hosted_invoice_url

Nodos relacionados

• StripeGetInvoices - Obtener y buscar facturas existentes
• StripeGetCustomers - Obtener datos del cliente
• StripeCreateCustomer - Crear el cliente antes de facturar
• StripeGetSubscriptions - Consultar suscripciones asociadas