GET
/api/cuentas/{cuenta}/cierresLo gastado en cada ciclo cerrado
Los créditos que gastó la cuenta en cada ciclo mensual ya cerrado, del más antiguo al más reciente. En el plan por uso, es lo que se factura cada mes.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| cuenta | string | SÍ | El id de la cuenta. Desde un espacio: GET …/cuenta → cuenta.id. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| cuenta · plan_id | string · string | null | La cuenta y su plan. |
| cierres | array | Un elemento por ciclo cerrado. [] si aún no se ha cerrado ninguno. |
| cierres[].inicio · fin | string | Primer y último día del ciclo, los dos incluidos (AAAA-MM-DD). |
| cierres[].creditos | string | Los créditos gastados. Decimal como texto, 4 decimales: "152.3071". |
| cierres[].espacios | string[] | Los espacios que se sumaron. |
| cierres[].completa | bool | false = la cifra es un suelo: se gastó al menos eso. |
| cierres[].modulos_mudos | string[] | Los módulos que no respondieron al medir: su gasto no está en la cifra. |
| cierres[].llamadas_sin_reporte | int | Llamadas cuyo gasto no quedó medido. Más de 0 = la cifra es un suelo. |
| cierres[].cerrado_en | string | Cuándo se escribió el cierre (ISO 8601, UTC). |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | La cuenta no es tuya | Sin acceso a esta cuenta. |
| 404 | No existe | Cuenta no encontrada. |
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
- Cada ciclo se cierra el primer día del siguiente. Un cierre con
completa: falsetodavía puede cambiar: Bentho lo vuelve a medir en los días siguientes al fin del ciclo. - Lee lo ya escrito, así que responde rápido. Para el ciclo en curso, usa la bolsa.
creditoses texto, no número, como en la bolsa: conviértelo con un decimal de verdad.- Solo se cierran las cuentas con ciclo: las que tienen
ancla_cicloopagado_hasta(ver cuenta).