Apertura de Caja - CajaController

📋 Descripción General

Abre una nueva caja con el importe inicial especificado y opcionalmente un desglose de monedas y billetes. Este endpoint utiliza autenticación tradicional mediante parámetros de consulta.

📥 Parámetros de Consulta

Parámetro	Tipo	Requerido	Descripción	Ejemplo
initialCatalog	string	✅ Sí	Catálogo inicial de la base de datos	ELSIFON
userID	string	❌ No	ID del usuario para autenticación	admin
password	string	❌ No	Contraseña para autenticación	yourPassword

📦 Cuerpo de la Petición (JSON)

{
  "cajeroId": 1,
  "importeInicial": 100.50,
  "nombreCaja": "CAJA1",
  "desgloseMonedas": [
    { "codigo": "2EUR", "cantidad": 10 },
    { "codigo": "0.50EUR", "cantidad": 20 }
  ]
}

📤 Respuestas

200 OK

Caja abierta exitosamente. Retorna el cierre creado.

400 Bad Request

Ya existe un cierre para hoy o datos inválidos.

500 Internal Server Error

Error interno del servidor durante la apertura.

🔧 Ejemplo de Uso (cURL)

curl -X POST \
  'http://localhost:1379/Working/Caja/Abrir?initialCatalog=ELSIFON&userID=admin&password=yourPassword' \
  -H 'Content-Type: application/json' \
  -d '{
    "cajeroId": 1,
    "importeInicial": 100.50,
    "nombreCaja": "CAJA1",
    "desgloseMonedas": [
      {"codigo": "2EUR", "cantidad": 10},
      {"codigo": "0.50EUR", "cantidad": 20}
    ]
  }'

ℹ️ Notas Importantes

No puede existir un cierre para la misma fecha antes de abrir una nueva caja
El importe inicial debe coincidir con el desglose de monedas
El nombre de caja debe ser único para la fecha
Se valida que el cajero exista y tenga permisos

🚪 Apertura de Caja