Stripe - Obtener Facturas

Descripcion

Este módulo permite consultar las facturas generadas en Stripe. Puede obtener una factura específica o listar múltiples con filtros por cliente, suscripción, estado y fechas.

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
invoice_id	string	No	ID específico (in_xxx)
customer_id	string	No	Filtrar por cliente
subscription_id	string	No	Filtrar por suscripción
status	select	No	Filtrar por estado
created_gte	string	No	Creado después de (timestamp Unix)
created_lte	string	No	Creado antes de (timestamp Unix)
limit	number	No	Límite de resultados (default: 10)
starting_after	string	No	ID del último objeto para paginación

Estados de Factura

• draft: Borrador
• open: Abierta (pendiente de pago)
• paid: Pagada
• uncollectible: Incobrable
• void: Anulada

Salida

{
  "success": true,
  "invoices": [...],
  "count": 10,
  "has_more": true,
  "message": "10 facturas obtenidas"
}

Campos de Factura

• id: ID de la factura (in_xxx)
• number: Número de factura
• status: Estado
• amount_due: Monto pendiente
• amount_paid: Monto pagado
• total: Total de la factura
• currency: Moneda
• customer_email: Email del cliente
• hosted_invoice_url: URL para pagar online
• invoice_pdf: URL del PDF
• due_date: Fecha de vencimiento

Ejemplo de Uso

Obtener por ID

{
  "invoice_id": "in_1MtHbELkdIwHu7ixl4OzzPMv"
}

Facturas de un cliente

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "limit": 50
}

Facturas pendientes

{
  "status": "open"
}

Facturas de una suscripción

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "status": "paid"
}

API Utilizada

• Endpoint: GET /v1/invoices
• Documentación: Stripe Invoices API

Notas

• hosted_invoice_url permite al cliente pagar online
• invoice_pdf genera un PDF descargable
• Las facturas draft no son visibles para el cliente
• Los montos decimales se agregan para conveniencia

Nodos relacionados

• StripeCreateInvoice - Crear nuevas facturas
• StripeGetCustomers - Obtener datos del cliente de la factura
• StripeGetSubscriptions - Obtener suscripciones que generan facturas