Saldo Inicial

Saldo Inicial

Prefijo: /api/saldo-inicial
Requiere Auth: Sí
Permiso requerido: saldo_inicial, *

Módulo para registrar el saldo inicial de efectivo por terminal al iniciar la jornada.

GET /api/saldo-inicial/

Descripción: Lista los saldos iniciales registrados
Requiere Auth: Sí
Permiso requerido: saldo_inicial, leer

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1,
    "terminal_id": "TERM-001",
    "fecha": "2025-01-15",
    "usuario": "Juan Pérez",
    "monto": 500000,
    "tenant_id": "uuid-tenant",
    "created_at": "2025-01-15T06:00:00"
  }
]

cURL:

curl http://localhost/api/saldo-inicial/ -H "Authorization: Bearer <token>"

Python:

import httpx
resp = httpx.get("http://localhost/api/saldo-inicial/", headers={"Authorization": f"Bearer {token}"})
saldos = resp.json()

JavaScript:

const resp = await fetch('http://localhost/api/saldo-inicial/', {
  headers: {'Authorization': `Bearer ${token}`}
});
const saldos = await resp.json();

---

GET /api/saldo-inicial/existe

Descripción: Verifica si ya existe un saldo inicial para una terminal/fecha
Requiere Auth: Sí
Permiso requerido: saldo_inicial, leer

Parámetros query:

Parámetro	Tipo	Obligatorio	Descripción
terminal_id	string	✅	Identificador de terminal
fecha	date	✅	Fecha a verificar

Respuesta exitosa: 200 OK

Response:

{
  "existe": true
}

cURL:

curl "http://localhost/api/saldo-inicial/existe?terminal_id=TERM-001&fecha=2025-01-15" -H "Authorization: Bearer <token>"

---

POST /api/saldo-inicial/

Descripción: Crea un nuevo saldo inicial
Requiere Auth: Sí
Permiso requerido: saldo_inicial, crear

Request:

{
  "terminal_id": "TERM-001",
  "fecha": "2025-01-15",
  "usuario": "Juan Pérez",
  "monto": 500000
}

Respuesta exitosa: 201 Created

cURL:

curl -X POST http://localhost/api/saldo-inicial/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"terminal_id":"TERM-001","fecha":"2025-01-15","usuario":"Juan Pérez","monto":500000}'

Python:

import httpx
resp = httpx.post("http://localhost/api/saldo-inicial/",
    json={"terminal_id": "TERM-001", "fecha": "2025-01-15", "usuario": "Juan Pérez", "monto": 500000},
    headers={"Authorization": f"Bearer {token}"})
saldo = resp.json()

JavaScript:

const resp = await fetch('http://localhost/api/saldo-inicial/', {
  method: 'POST',
  headers: {'Content-Type': 'application/json', 'Authorization': `Bearer ${token}`},
  body: JSON.stringify({terminal_id: 'TERM-001', fecha: '2025-01-15', usuario: 'Juan Pérez', monto: 500000})
});

---

GET /api/saldo-inicial/{saldo_id}

Descripción: Obtiene un saldo inicial por ID
Requiere Auth: Sí
Permiso requerido: saldo_inicial, leer

Respuesta exitosa: 200 OK
Errores: 404 (no encontrado)

cURL:

curl http://localhost/api/saldo-inicial/1 -H "Authorization: Bearer <token>"

---

PUT /api/saldo-inicial/{saldo_id}

Descripción: Actualiza un saldo inicial
Requiere Auth: Sí
Permiso requerido: saldo_inicial, actualizar

Respuesta exitosa: 200 OK
Errores: 404 (no encontrado)

cURL:

curl -X PUT http://localhost/api/saldo-inicial/1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"monto":550000}'

---

DELETE /api/saldo-inicial/{saldo_id}

Descripción: Elimina un saldo inicial
Requiere Auth: Sí
Permiso requerido: saldo_inicial, eliminar

Respuesta exitosa: 204 No Content
Errores: 404 (no encontrado)

cURL:

curl -X DELETE http://localhost/api/saldo-inicial/1 -H "Authorization: Bearer <token>"