🚀 Vinted Worker APIs - Versión con D1 Database

📥 DESCARGAR:
GET /download/{ruta-completa}
Ejemplo: /download/etiquetas/2025/06/17/VINTED_T41648508_X14235015957_InPost.pdf

📋 LISTAR:
GET /list                    → Todas las etiquetas (incluye estado de impresión)
GET /list/2025-06-17        → Etiquetas de una fecha específica
GET /search/41648508        → Buscar por tracking number
POST /search-batch          → Buscar múltiples IDs en lote
GET /stats                  → Estadísticas del sistema

🔗 COORDINACIÓN:
GET /api/label/exists/{id}  → Verificar si transaction_number existe (para Python)

📤 LABELS (Sincronización Python):
POST /api/labels/upload       → Subir PDF desde Python
                                Body: {"pdf_base64": "...", "transaction_id": "123", "tracking_number": "X", ...}
POST /api/labels/check        → Verificar qué etiquetas existen (EFICIENTE)
                                Body: {"transaction_ids": [123, 456, 789]}
                                Response: {"exists": [123], "missing": [456, 789]}

📦 ORDERS (Sincronización Python):
POST /api/orders/sync         → Sincronizar órdenes desde Python
                                Body: {"orders": [...], "seller_profile": "X", "seller_user_id": "Y"}
GET  /api/orders              → Listar órdenes
                                Params: ?limit=50&offset=0&user_status=&label_status=&seller=&from=&to=
GET  /api/orders/:id          → Obtener orden específica
PUT  /api/orders/:id/status   → Actualizar estado de etiqueta
                                Body: {"label_status": "captured", "tracking_number": "X", ...}
GET  /api/orders/stats        → Estadísticas de ventas
                                Params: ?days=30

✅ MARCAR COMO IMPRESO:
POST /mark-printed          → Marcar etiquetas como impresas
                              Body: {"tracking_numbers": ["123"], "transaction_numbers": ["456"], "file_keys": ["key"]}
POST /mark-all-printed      → Marcar TODAS las pendientes como impresas
POST /update-company        → Cambiar compañía de envío
                              Body: {"file_key": "...", "new_company": "InPost"}

🐛 DEPURACIÓN:
GET /debug/logs                → Ver logs de depuración
GET /debug/last-email          → Ver último email procesado
GET /debug/central-log         → Ver registro centralizado completo
GET /debug/search-log/{query}  → Buscar en registro centralizado

🔄 SINCRONIZACIÓN:
GET /sync-labels              → Sincronizar etiquetas de R2 a D1 (ejecutar una vez)

📁 ESTRUCTURA DE ARCHIVOS:
etiquetas/
├── 2025/
│   ├── 06/
│   │   ├── 17/
│   │   │   ├── VINTED_T41648508_X14235015957_InPost.pdf
│   │   │   └── VINTED_T41648509_X14235015958_Correos.pdf
│   │   └── 18/
│   └── 07/

debug/
├── logs/
│   └── YYYY-MM-DD_HH-mm-ss.json
├── emails/
│   └── last.json
└── central-log.json (registro centralizado)

💾 Base de Datos: D1 (búsquedas SQL rápidas) + R2 (almacenamiento PDFs)

🔗 EJEMPLOS DE USO:
curl https://vinted-email-webhook.fjmontesgonzalez.workers.dev/list
curl https://vinted-email-webhook.fjmontesgonzalez.workers.dev/search/41648508
curl https://vinted-email-webhook.fjmontesgonzalez.workers.dev/debug/central-log

✅ Worker funcionando correctamente!
Debug Mode: ACTIVADO
Última actualización: 2026-01-05T13:31:41.040Z