Referencia HTTP del API
Las rutas de extracción y facturas aceptan Authorization: Bearer con clave bf_live_ o JWT de sesión. Crea y revoca claves bf_live_ solo desde el panel con sesión iniciada (no documentado aquí). La facturación y los webhooks de suscripción van por la UI del producto, no en este catálogo.
Cómo encajan las piezas
Extrae primero y luego lista o actualiza filas guardadas. Cada caja enlaza a una página con todos los métodos y rutas.
Índice completo de endpoints
| Método | Ruta | Tema | Resumen | Detalle |
|---|---|---|---|---|
| POST | /api/expenses | Extracción | Extrae uno o varios documentos de gasto (JSON file_url/items o multipart). client_id obligatorio. | Ver |
| POST | /api/revenue | Extracción | Extrae uno o varios documentos de ingreso (misma forma que POST /api/expenses). client_id obligatorio. | Ver |
| GET | /api/expenses | Facturas | Facturas de gasto paginadas de un cliente (query client_id obligatorio). | Ver |
| GET | /api/expenses/[id] | Facturas | Obtiene una factura de gasto por id. | Ver |
| PATCH | /api/expenses/[id] | Facturas | Fusiona parsed_data en una factura de gasto. | Ver |
| DELETE | /api/expenses/[id] | Facturas | Elimina una factura de gasto. | Ver |
| GET | /api/revenue | Facturas | Facturas de ingreso paginadas de un cliente (query client_id obligatorio). | Ver |
| GET | /api/revenue/[id] | Facturas | Obtiene una factura de ingreso por id. | Ver |
| PATCH | /api/revenue/[id] | Facturas | Fusiona parsed_data en una factura de ingreso. | Ver |
| DELETE | /api/revenue/[id] | Facturas | Elimina una factura de ingreso. | Ver |
| GET | /api/clients | Clientes | Lista clientes de la organización autenticada. | Ver |
| POST | /api/clients | Clientes | Crea un cliente en la organización. | Ver |
| GET | /api/clients/[id] | Clientes | Obtiene un cliente por id. | Ver |