GET
/api/mod/facturacion/{espacio}/ordersLas órdenes del espacio
Todas las órdenes, la más reciente primero. Puedes filtrarlas por estado o por tu referencia.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Facturación. |
| estado | string, query | no | Solo las de este estado: pending_payment, under_review, paid… |
| session_ref | string, query | no | Solo las de esta referencia, exacta. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| orders | array | La más reciente primero. Cada una con los campos de GET orders/{orden} salvo cuentas y despacho_status. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Facturación | módulo no habilitado para este espacio. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- No pagina: devuelve todas las que cumplan el filtro. Filtra por
estadopara traer solo lo que te interesa. - Un estado que no existe no da error: devuelve una lista vacía.
- Son datos personales del cliente: guárdalos solo donde los necesites y no los copies a registros ni a herramientas de terceros.