Saltar al contenido
Facturador

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:

  • 403 si el usuario no es administrador.
  • 401 sin 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.