Changelog

Unreleased

Catalog (GET /v2/catalog)

• Cada producto incluye subselections con sus ítems, reglas de selección, external_id y stock por ítem.

Infraestructura

• Columnas external_id en subselection y subselection_item.

v2.0.0

Primera implementación de OrderFast API v2 ERP.

API HTTP (/v2/*)

• Locations: GET /v2/locations/current
• Products y categories: CRUD + lookup by-external-id
• Orders ERP: creación con idempotency, external_id, channel, cancel
• Stock: listado, sync batch, stock por producto
• Catalog: lectura agregada (productos, categorías, stock y subselecciones) y sync batch (productos + categorías)
• Sync jobs: POST /v2/sync/products, GET /v2/sync/jobs/:id
• Payments, settlements, turns, reportes de ventas, menú activo
• Webhooks v2 en /v2/webhook-endpoints

Infraestructura

• Columnas external_id en products y categories
• Tabla api_sync_jobs con worker async
• Permisos v2 (catalog:*, stock:sync, sync:*, etc.)
• OpenAPI v2 en /openapi-v2.json
• Webhooks con api_version: "v2" y eventos extendidos
• GET /v2/orders/export con permiso orders:export
• Rate limits batch (batch_jobs_per_hour, max_items_per_batch)
• Sync jobs procesados vía PGMQ (api_sync_jobs queue)
• Webhook delivery vía PGMQ (webhook_events + webhook_retries queues)

Pendiente para próximas versiones

• MCP (v3)

---