Cierres de caja
POST
Contexto para el conteo de caja
POST /api/cash-closures/get-cash-declaration-context
Descripción
Devuelve las denominaciones del país, los medios de pago a declarar y lo que el cajero haya guardado previamente en el conteo de la sesión.
Detalles
Retorna el catálogo de denominaciones (billetes y monedas) del país del negocio, los medios de pago electrónicos que se deben declarar al cierre y los valores ya guardados en la sesión activa. Falla si la sesión no está abierta o no es del usuario.
Permisos requeridos
cash.session.declare
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| cashRegisterSessionId | int | Sí |
min_value:1
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/cash-closures/get-cash-declaration-context \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"cashRegisterSessionId": 2
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"cashRegisterSessionId": 2,
"countryCode": "CO",
"cashDeclarationStatus": "pending",
"methodsDeclarationStatus": "pending",
"denominations": [
{
"currencyDenominationId": 1,
"countryCode": "CO",
"kind": "bill",
"name": "$ 100.000",
"valueCents": 10000000,
"sortOrder": 1,
"isSystem": 1
},
{
"currencyDenominationId": 2,
"countryCode": "CO",
"kind": "bill",
"name": "$ 50.000",
"valueCents": 5000000,
"sortOrder": 2,
"isSystem": 1
},
{
"currencyDenominationId": 3,
"countryCode": "CO",
"kind": "bill",
"name": "$ 20.000",
"valueCents": 2000000,
"sortOrder": 3,
"isSystem": 1
},
{
"currencyDenominationId": 4,
"countryCode": "CO",
"kind": "bill",
"name": "$ 10.000",
"valueCents": 1000000,
"sortOrder": 4,
"isSystem": 1
},
{
"currencyDenominationId": 5,
"countryCode": "CO",
"kind": "bill",
"name": "$ 5.000",
"valueCents": 500000,
"sortOrder": 5,
"isSystem": 1
},
{
"currencyDenominationId": 6,
"countryCode": "CO",
"kind": "bill",
"name": "$ 2.000",
"valueCents": 200000,
"sortOrder": 6,
"isSystem": 1
},
{
"currencyDenominationId": 7,
"countryCode": "CO",
"kind": "bill",
"name": "$ 1.000",
"valueCents": 100000,
"sortOrder": 7,
"isSystem": 1
},
{
"currencyDenominationId": 8,
"countryCode": "CO",
"kind": "coin",
"name": "$ 1.000",
"valueCents": 100000,
"sortOrder": 1,
"isSystem": 1
},
{
"currencyDenominationId": 9,
"countryCode": "CO",
"kind": "coin",
"name": "$ 500",
"valueCents": 50000,
"sortOrder": 2,
"isSystem": 1
},
{
"currencyDenominationId": 10,
"countryCode": "CO",
"kind": "coin",
"name": "$ 200",
"valueCents": 20000,
"sortOrder": 3,
"isSystem": 1
},
{
"currencyDenominationId": 11,
"countryCode": "CO",
"kind": "coin",
"name": "$ 100",
"valueCents": 10000,
"sortOrder": 4,
"isSystem": 1
},
{
"currencyDenominationId": 12,
"countryCode": "CO",
"kind": "coin",
"name": "$ 50",
"valueCents": 5000,
"sortOrder": 5,
"isSystem": 1
},
{
"currencyDenominationId": 13,
"countryCode": null,
"kind": "aux",
"name": "Auxiliar 1",
"valueCents": null,
"sortOrder": 1,
"isSystem": 0
},
{
"currencyDenominationId": 14,
"countryCode": null,
"kind": "aux",
"name": "Auxiliar 2",
"valueCents": null,
"sortOrder": 2,
"isSystem": 0
},
{
"currencyDenominationId": 15,
"countryCode": null,
"kind": "aux",
"name": "Auxiliar 3",
"valueCents": null,
"sortOrder": 3,
"isSystem": 0
}
],
"paymentMethods": [
{
"paymentMethodId": 11,
"code": null,
"name": "Transferencia Bancaria",
"iconFontAwesome": "fa-solid fa-building-columns",
"color": "#0ea5e9",
"sortOrder": 13
}
],
"savedDenominations": [],
"savedPaymentMethods": []
}
}