Update README and script docs with credentials.json format specifications

README.md

@@ -54,6 +54,49 @@ Consulta los estados una sola vez, genera `status.html` and finaliza. Ideal para
 
 ---
 
+## 🔑 Formato de Configuración (`credentials.json`)
+
+El archivo `credentials.json` debe colocarse junto al ejecutable o script y soporta dos formatos:
+
+### Formato A (Formato por objeto con puerto, exclusiones y navegador - RECOMENDADO):
+```json
+{
+  "port": 8080,
+  "exclude": ["1071", "1171", "1215"],  // Lista de sucursales a ignorar (ID, número o nombre)
+  "open_browser": true,                  // true para abrir navegador al iniciar (defecto en GUI)
+  "accounts": [
+    {
+      "label": "2020",
+      "username": "TuUsuario2020",
+      "password": "TuPassword2020"
+    },
+    {
+      "label": "2019",
+      "username": "TuUsuario2019",
+      "password": "TuPassword2019"
+    }
+  ]
+}
+```
+
+### Formato B (Formato original de lista - Puerto por defecto 8080):
+```json
+[
+  {
+    "label": "2020",
+    "username": "TuUsuario2020",
+    "password": "TuPassword2020"
+  },
+  {
+    "label": "2019",
+    "username": "TuUsuario2019",
+    "password": "TuPassword2019"
+  }
+]
+```
+
+---
+
 ## 🔒 Robustez y Resiliencia Implementada
 
 * **Motor Híbrido Dinámico (27 + 7):** En cada ciclo de 30s se procesan 27 sucursales del turno ordinario (ordenadas secuencialmente por antigüedad) + hasta 7 de alta frecuencia (desarmadas/alarmadas/fallos), previniendo rate-limits.