Copy page

Conceptos de Zaroz Cloud v2

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

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

TypeScript

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

Python

Code
_, 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.