Liquidación y cierre diario

El dinero que dispersas tiene que estar puesto antes, con uno de dos modelos.

curl -s "$BASE/v1/treasury/position?asset=BS" -H "x-api-key: $KEY"

{
  "tenantId": "3f1a0c22-9b41-4a77-8f0e-6d2c5b7a1e34", "asset": "BS",
  "prefundingBalance": "0", "platformRevenueFromTenant": "415900",
  "creditEnabled": true, "creditDrawn": "4537190",
  "creditLimit": null, "creditAvailable": null
}

creditEnabled dice en cuál de los dos estás.

	Prefondeado (`false`)	Cierre diario (`true`)
Cuándo pones el dinero	Antes de dispersar	Al cierre del día siguiente
Caja que inmovilizas	La de tu peor día	Ninguna
Si te quedas corto	`422 insufficient_tenant_funds`	Nada: la dispersión sale
La cifra que vigilas	`prefundingBalance`	`creditDrawn`

El cierre diario es una línea de crédito: se habilita caso por caso y con un importe acordado.

Los campos de tu posición

Campo	Qué es
`prefundingBalance`	Tu saldo disponible, en unidades menores. `"0"` es lo normal con cierre diario
`creditDrawn`	Lo que debes ahora mismo, en positivo. Crece durante el día, se liquida en el cierre y vuelve a `0`
`creditEnabled`	`true` = cierre diario. `false` = prefondeado
`creditLimit` · `creditAvailable`	El techo de tu línea y lo que te queda. `null` si no hay techo acordado
`platformRevenueFromTenant`	Comisiones que ha generado tu programa, para conciliar tu factura

Si pagas de más en un cierre, el exceso se queda en prefundingBalance y lo consumen las dispersiones del día siguiente antes de girar de la línea.

Qué entra en el cierre de hoy

Por liquidación, no por creación: una dispersión entra en el cierre del día en que quedó settled.

Estado al momento del corte	¿Entra?
`settled`	Sí. El dinero salió
`failed`	No. El asiento ya se revirtió: no debes nada
`submitted`	No. Pasa al cierre del día en que liquide
`unknown`	No. Pasa al cierre del día en que se resuelva

Una dispersión que mandas a las 23:55 y liquida a las 00:05 aparece en el cierre de mañana.

Qué recibes en el cierre

Al cierre te enviamos, por el canal que acordemos:

número de dispersiones liquidadas y el importe entregado, en Bs;
comisiones del periodo;
total a liquidar;
el detalle línea a línea, con id, beneficiario, banco, instrumento, bank_reference y settled_at.

Cuadrarlo tú mismo

Pide el día con GET /payments?from=…&to=…&status=settled, suma payout_amount y fee_amount en enteros y compara con creditDrawn. El bucle completo, listo para copiar: cuadrar un día.

Cómo se cobra

Concepto	Cómo se calcula
Comisión	Fijo + puntos básicos sobre el monto, con mínimo y máximo. Configurable por programa
Spread	Sólo cuando hay conversión: margen sobre la tasa, en puntos básicos. En `rate.spread_bps` de la cotización, con la tasa de mercado en `rate.market`
Sin conversión	No hay spread. Sólo comisión, cobrada encima del importe exacto que entregas

La cotización desglosa las tres cifras: deliver lo que recibe el beneficiario, fee la comisión y spend lo que se te debita. Ver cotizar.