[Autorización]
Incluir en los Headers HTTP:
Authorization: Bearer {API_KEY}

[Endpoints Disponibles]
- Subir Imagen (Base64):
POST /api/upload
Body: { "filename":"zapato.jpg", "data_base64":"/9j/4AAQSkZJRgABAgAA..." }
Respuesta: { "url": "/uploads/img_xxxxx.jpg" } (Usa esta URL en foto_url del modelo)

- Crear Catálogo/Modelo:
POST /api/modelos
Body: { "modelo":"M-123", "codigo":"COD1", "suela":"LADY", "foto_url":"/uploads/img.jpg", "precio_suela":18, "maquila":62.5, "adornos": [ {"nombre":"PEDRERIA", "valor":15} ] }

- Listar Catálogo de Modelos del Cliente:
GET /api/modelos

- Listar Códigos Autorizados (Catálogo Base):
GET /api/codigos/mis-codigos
Retorna los códigos agrupados por suela (solo-lectura, formato JSON).

- Crear Nota/Pedido:
POST /api/notas
Body: { "fecha":"06/04/2026" }

- Añadir Línea a Nota:
POST /api/notas/{nota_id}/lineas
Body: { "modelo_id":1, "modelo_snap":"M-123", "color":"ROJO", "pares":100, "precio_x_par":95.5, "codigo_snap":"COD1", "maquila_snap":62.5, "tallas":"23/40 24/40 25/20" }

- 🔢 Tallas — Formato y Uso:
El campo tallas es opcional. Si se envía, debe seguir el formato:
TALLA/PARES TALLA/PARES ... separados por espacio.
Ejemplo: "23/40 24/40 25/20" = 40 pares t.23 + 40 pares t.24 + 20 pares t.25 (total=100)
La suma de pares por talla debe igualar el total de pares.

- Validar Tallas (antes de guardar):
POST /api/tallas/validar
Body: { "tallas":"23/40 24/40 25/20", "pares":100 }
✅ OK: { "ok":true, "suma_tallas":100, "tallas":[{"talla":"23","pares":40},...] }
❌ Error: { "ok":false, "error":"La suma (80) no coincide con el total (100)", "suma_tallas":80 }

- Parsear string de Tallas:
GET /api/tallas/parsear?tallas=23/40%2024/40%2025/20
→ { "ok":true, "suma_tallas":100, "tallas":[{"talla":"23","pares":40},...] }

- Ver Numeraciones guardadas del cliente:
GET /api/numeraciones
→ [ {"id":1, "nombre":"Escolar", "rango":"22-26"}, ... ]

- 📦 Pedidos (Admin hacia Cliente):
GET /api/pedidos (Lista todos los pedidos dirigidos a este cliente)
GET /api/pedidos/{id} (Detalle completo del pedido, con líneas y desglose de tallas)
GET /api/pedidos/{id}/export (Descarga del Excel del pedido)