Skip to main content

​
Resumen

Una factura es una cuenta con líneas de detalle, una tasa de impuesto opcional y un cliente. Al crearla se crea automáticamente un pago para liquidarla — comparte el enlace de ese pago con tu cliente y la factura se marca como pagada en el momento en que el pago se completa.
Consulta el pago vinculado (GET /payments/{id}, usando el payment_id de la respuesta de la factura) para obtener el shortUrl compartible para el cliente. Ver Enlaces de Pago.

​
Montos e impuesto

  • Todos los campos de dinero son enteros en la unidad más pequeña de la moneda (centavos): unit_price, subtotal, tax_total, total.
  • subtotal = Σ quantity × unit_price.
  • Una única tax_percentage (0–100) se aplica a todo el subtotal: tax_total = subtotal × tax_percentage / 100, y total = subtotal + tax_total. No se admiten tasas de impuesto por línea.
  • currency es la moneda de precios; la liquidación se realiza en USDC como en todo pago de Ebioro.

​
Estados de la factura

Cancelar anula la factura y expira su enlace de pago. Una factura pagada no puede cancelarse — reembolsa el pago vinculado en su lugar.

​
Clientes

Adjunta un cliente por referencia o de forma directa:
  • customer_id — vuelve a facturar a un cliente existente.
  • customer — créalo en la misma llamada: customer_type (individual | business), name, company_name, email, vat_number, address.
El cliente aparece en la respuesta de la factura y puede reutilizarse mediante su id en facturas posteriores.

​
Numeración de facturas

Los números se emiten sin huecos por comercio: prefijo + secuencia. Configura el prefijo mediante los ajustes de numeración:
  • El token {year} se resuelve al año en curso en el momento de la creación (INV-2026-100). La secuencia es continua — {year} estampa el año pero no reinicia el contador cada enero.
  • next_number solo puede avanzar, de modo que un número ya emitido nunca se vuelve a emitir.
  • También puedes pasar un invoice_number explícito al crear una factura; el contador sin huecos se omite para esa factura.
GET /invoices/settings devuelve el prefijo actual, el número siguiente y una vista previa resuelta ("INV-2026-5").