Ver opciones de caja
GET /api/cash-settings
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve las opciones de configuración que afectan el flujo de caja y los reportes de caja.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único).
Campos de data:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
destination_sale |
boolean | — | Caja general por defecto: en los formularios de venta del sistema el primer pago aparece con destino Caja (cash) ya elegido. No cambia lo que envía una integración: en la API siempre indicas payment_destination_id. |
separate_cash_transactions |
boolean | — | Valor inicial de la opción Separar ingresos y egresos del Libro de caja (separate_directions). |
order_cash_income |
boolean | — | Valor inicial de Agrupar por del Libro de caja: true = por tipo de comprobante (group_by=document_type); false = sin agrupar. |
available_cash_report_seller |
boolean | — | true = los vendedores pueden generar reportes de caja (solo de sus propias cajas). false = solo administradores. |
disabled_cash_reports |
array de string o null | — | Tipos de reporte ocultos en el catálogo: cash_movements, cash_operations, cash_credit, cash_products. [] o null = todos visibles. El Cierre de caja (cash_close) no se puede ocultar. |
cash_report_types lista los tipos de reporte con su nombre, si se pueden ocultar (toggleable) y si hoy se muestran (enabled): son los valores permitidos de disabled_cash_reports.
Errores:
403si el usuario no es administrador.401sin token o con un token inválido.
Respuestas
200 — Opciones
{
"success": true,
"data": {
"destination_sale": true,
"separate_cash_transactions": false,
"order_cash_income": true,
"available_cash_report_seller": true,
"disabled_cash_reports": [
"cash_products"
],
"cash_report_types": [
{
"type": "cash_close",
"label": "Cierre de caja",
"toggleable": false,
"enabled": true
},
{
"type": "cash_movements",
"label": "Libro de caja",
"toggleable": true,
"enabled": true
},
{
"type": "cash_operations",
"label": "Resumen de operaciones",
"toggleable": true,
"enabled": true
},
{
"type": "cash_credit",
"label": "Créditos y cobranzas",
"toggleable": true,
"enabled": true
},
{
"type": "cash_products",
"label": "Productos vendidos",
"toggleable": true,
"enabled": false
}
]
}
}
403 — Usuario no administrador
{
"success": false,
"message": "Solo un administrador puede gestionar este recurso."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.