← API REST v1 SECCIÓN DEL MANUAL

6. Facturas

Instrucciones, comprobaciones y pasos de esta sección del manual.

Prueba esta ruta en el laboratorio

Abre el laboratorio estilo Postman, indica la URL de tu panel y envía la petición. Recuerda activar la API en Ajustes → Gestión de personal.

GET /invoices

Filtros: customer_id, status. Permiso: finanzas.facturas.menu.

POST /invoices

Permiso: clientes.facturacion.nuevo-factura.

{
  "customer_id": 12,
  "total": 30,
  "due_at": "2026-08-20",
  "issued_at": "2026-08-15",
  "number": 2995
}

GET /invoices/{id}

PUT /invoices/{id}

Campos: total, due_at, status. Permiso: finanzas.facturas.editar.

DELETE /invoices/{id}

Permiso: finanzas.facturas.eliminar.

GET /invoices/{id}/pdf

Descarga el PDF. Si no se puede generar, responde 422 pdf_unavailable. Permiso: finanzas.facturas.menu.