# Estado y confianza de la organización

Zaroz deja que una organización nueva empiece de inmediato y amplía lo que puede gastar a medida que construye un historial de pagos. Eso es el **estado** de la organización. Es por organización y por moneda.

## Qué mide

| Cifra | Significado |
|---|---|
| `balance_cents` | el saldo prepagado de la organización |
| `reserved_cents` | retenido para compras y para el peor caso de los servicios en marcha |
| `floor_cents`, `required_cents` | el saldo mínimo que necesita una compra nueva además de lo reservado |
| `available_cents` | `saldo - requerido`: lo que puede usar una compra |
| `credit_limit_cents` | cuánto puede deber la organización a factura (pospago), `0` en organizaciones prepago |
| `open_receivable_cents` | lo que debe actualmente |
| `restricted` | si el gasto **nuevo** se rechaza |

La confianza se gradúa en niveles con nombre, y el personal puede anular un nivel. Las señales de comportamiento pueden restringir el gasto nuevo y bajar el techo automáticamente. Una restricción solo detiene el gasto **nuevo**: compras, ampliaciones, unidades nuevas. No detiene servicios que ya están en marcha.

## Quién ve qué

Cualquier miembro puede leer el estado. El **propietario** de la organización recibe el desglose completo en `detail`. Los demás miembros solo reciben una frase fija en `message`, idéntica para cualquier motivo, para que una restricción nunca filtre las finanzas de la organización. Una organización a la que no perteneces responde `404`.

**curl**

```bash
curl -sS "$ZAROZ_API/organizations/<org uuid>/standing" -H "$AUTH"
```

**TypeScript**

```ts
const { body: standing } = await call("GET", `/organizations/${ORG}/standing`);
if (standing.restricted) console.warn(standing.message, standing.detail);
```

**Python**

```python
_, standing = call("GET", f"/organizations/{ORG}/standing")
if standing["restricted"]:
    print(standing["message"], standing.get("detail"))
```


## Dónde aparece

- `restricted: true` es la razón por la que se rechaza un pago o el arranque de una unidad; `restriction` en las respuestas de presupuesto y compra lleva el motivo y la cifra que lo resolvería.
- `required_cents` y `available_cents` del presupuesto te dicen antes de comprar si la compra pasará.
- En organizaciones con límite de crédito, las respuestas de presupuesto y compra del propietario traen una divulgación `postpaid` de lo que se facturará en lugar de prepagarse.

La deuda tiene una escalera definida, con avisos antes de cada paso irreversible: una organización restringida primero pierde la posibilidad de iniciar gasto nuevo y solo tras un impago sostenido se suspenden los servicios y, mucho después, se borran los datos, con avisos a 15, 7 y 1 día antes del borrado. Saldar la deuda abierta levanta la restricción.

:::note
Los nombres y umbrales de los niveles los fija Zaroz y el personal puede anularlos. No los fijes en el código; lee `restricted`, `required_cents` y `available_cents`.
:::