GET
/api/mod/facturacion/{espacio}/review-queueLa cola de revisión de pagos
Los comprobantes que esperan que alguien los apruebe o los rechace, el más antiguo primero, con lo que se leyó de cada uno y cómo pedir su archivo.
- 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. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| queue | array | Los comprobantes en pending_review, el más antiguo primero. Cada uno con: |
| queue[].id · order_id | string | El comprobante y su orden. |
| queue[].decision | "pending_review" | "approved" | "rejected" | pending_review mientras espera revisión. |
| queue[].monto_declarado | string | null | Lo que el cliente dijo que pagó, si lo mandaste al subirlo. |
| queue[].content_type | string | null | El tipo con el que se subió el archivo. |
| queue[].sha256 · phash | string · string | null | Huellas del archivo: la exacta y la de la imagen (null si no es una imagen legible). Sirven para detectar comprobantes repetidos. |
| queue[].extraccion_json | string (JSON) | Lo que se leyó del comprobante, como texto JSON: ok, monto, cuenta_destino, fecha_hora, referencia, banco_app y nombre_destinatario. Con ok: false no se leyó nada: revísalo a ojo. |
| queue[].reglas_json | string (JSON) | Las cinco comprobaciones, como texto JSON: reglas (cada una true o false), todas_ok, auto_aprobar y motivo. Qué mira cada una, en la guía. |
| queue[].revisor · motivo | string | null | Quién lo decidió y por qué. null mientras espera. |
| queue[].creado_at · revisado_at | number | null | Segundos desde 1970. revisado_at es null mientras espera. |
| queue[].imagen_media_type | string | El tipo con el que se sirve el archivo: una imagen, application/pdf o application/octet-stream. |
| queue[].imagen_es_imagen | boolean | Si se puede enseñar como imagen. |
| queue[].imagen_disponible | boolean | Si el archivo sigue guardado. false: el comprobante existe, su archivo no. |
| queue[].imagen_bytes | integer | null | El tamaño del archivo. |
| queue[].imagen_path | string | Dónde pedir el archivo, relativo a /api/mod/facturacion/{espacio}/: ver el archivo. |
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
extraccion_jsonyreglas_jsonson texto: pásalos por un parser JSON antes de leerlos.- Los comprobantes ya decididos salen de la cola. Su decisión queda en la historia de la orden.
- Son datos personales del cliente: guárdalos solo donde los necesites y no los copies a registros ni a herramientas de terceros.