GET
/api/mod/contabilidad/{espacio}/reconciliationLa conciliación
Cuadra lo que mandaste con lo que tu software confirmó en un periodo: cuántas facturas y pagos hay en cada estado, cuánto suman los confirmados y cuáles quedaron sin confirmar.
- 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 Contabilidad. |
| desde · hasta | number, query | no | El periodo, en segundos desde 1970, por la fecha en que se encoló. Sin ellos, todo. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| desde · hasta | number | El periodo que pediste. |
| resumen.invoice · payment | object | Facturas y pagos: cuántos en done, pending (incluye los que se están mandando), failed y dead, y monto_total, la suma de los done (texto). |
| pendientes | array | Los que tu software no ha confirmado (pending, failed o dead): id, tipo, referencia_interna, estado y motivo. |
| deriva | boolean | true si algo quedó sin confirmar: hay que mirarlo. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Contabilidad | módulo no habilitado para este espacio. |
| 502 | El módulo no está disponible en este momento: reintenta en unos minutos | — |
| 422 | Falta un campo obligatorio o uno no tiene su tipo (detail es una lista) | — |
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
- Los clientes no entran en la conciliación: solo facturas y pagos.
- En el Estudio, el panel de Contabilidad pinta estas cifras y la lista de pendientes, con su botón de reintentar.