{"openapi":"3.1.0","info":{"title":"Espina Comercial Public API","description":"API segura para integrar negocios, productos, inventario, ventas, bitácora, reportes y webhooks.","contact":{"name":"Espina Comercial"},"version":"v1"},"servers":[{"url":"https://www.espinacomercial.com","description":"Espina Comercial"}],"security":[{"espinaOAuth":[]}],"paths":{"/api/v1/accounts/{accountId}/webhooks":{"get":{"tags":["Webhooks"],"summary":"Lista los webhooks configurados","operationId":"list","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscriptionView"}}}}}}},"post":{"tags":["Webhooks"],"summary":"Crea un webhook; el secreto se muestra una sola vez","operationId":"create","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionView"}}}}}}},"/api/v1/accounts/{accountId}/webhooks/{subscriptionId}/test":{"post":{"tags":["Webhooks"],"summary":"Encola una entrega de prueba","operationId":"test","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"202":{"description":"Accepted"}}}},"/api/v1/accounts/{accountId}/webhooks/{subscriptionId}/rotate-secret":{"post":{"tags":["Webhooks"],"summary":"Rota el secreto de firma y devuelve el nuevo una sola vez","operationId":"rotateSecret","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionView"}}}}}}},"/api/v1/accounts/{accountId}/webhooks/{subscriptionId}/deliveries/{deliveryId}/replay":{"post":{"tags":["Webhooks"],"summary":"Reencola una entrega","operationId":"replay","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Accepted"}}}},"/api/v1/accounts/{accountId}/sales":{"get":{"tags":["Ventas"],"summary":"Lista ventas con filtros y paginación","operationId":"sales","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"paymentMethod","in":"query","required":false,"schema":{"type":"string"}},{"name":"seller","in":"query","required":false,"schema":{"type":"string"}},{"name":"minTotal","in":"query","required":false,"schema":{"type":"number"}},{"name":"maxTotal","in":"query","required":false,"schema":{"type":"number"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"date_desc"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiPageVentaResumenView"}}}}}},"post":{"tags":["Ventas"],"summary":"Registra una venta de productos y descuenta el stock","operationId":"createProductSale","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiProductSaleRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiSaleDetailView"}}}}}}},"/api/v1/accounts/{accountId}/sales/manual":{"post":{"tags":["Ventas"],"summary":"Registra una venta manual sin productos","operationId":"createManualSale","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiManualSaleRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiSaleDetailView"}}}}}}},"/api/v1/accounts/{accountId}/mobile-devices":{"get":{"tags":["mobile-device-api-controller"],"operationId":"list_1","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MobileDeviceView"}}}}}}},"post":{"tags":["mobile-device-api-controller"],"operationId":"register","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileDeviceRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MobileDeviceView"}}}}}}},"/api/v1/accounts/{accountId}/webhooks/{subscriptionId}":{"delete":{"tags":["Webhooks"],"summary":"Desactiva un webhook","operationId":"disable","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["Webhooks"],"summary":"Actualiza o activa/desactiva un webhook","operationId":"update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionUpdateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionView"}}}}}}},"/api/v1/accounts/{accountId}/mobile-devices/{deviceId}":{"delete":{"tags":["mobile-device-api-controller"],"operationId":"delete","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deviceId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["mobile-device-api-controller"],"operationId":"update_1","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"deviceId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileDeviceUpdateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MobileDeviceView"}}}}}}},"/ventas/pv/productos/buscar":{"get":{"tags":["punto-venta-controller"],"operationId":"buscarProductos","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductoBusquedaItemView"}}}}}}}},"/ventas/pv/estado":{"get":{"tags":["punto-venta-controller"],"operationId":"estadoCaja","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{}}}}}}}},"/productos/openfoodfacts/buscar":{"get":{"tags":["producto-controller"],"operationId":"buscarOpenFoodFacts","parameters":[{"name":"codigo","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/meta":{"get":{"tags":["Identidad y negocios"],"summary":"Describe la versión y los endpoints OAuth de la API","operationId":"meta","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{}}}}}}}},"/api/v1/me":{"get":{"tags":["Identidad y negocios"],"summary":"Devuelve el usuario autenticado y sus negocios","operationId":"me","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiUserView"}}}}}}},"/api/v1/accounts":{"get":{"tags":["Identidad y negocios"],"summary":"Lista los negocios accesibles por el usuario","operationId":"accounts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApiAccountView"}}}}}}}},"/api/v1/accounts/{accountId}":{"get":{"tags":["Identidad y negocios"],"summary":"Consulta un negocio y el rol del usuario","operationId":"account","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiAccountView"}}}}}}},"/api/v1/accounts/{accountId}/webhooks/{subscriptionId}/deliveries":{"get":{"tags":["Webhooks"],"summary":"Consulta el historial de entregas","operationId":"deliveries","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiPageWebhookDeliveryView"}}}}}}},"/api/v1/accounts/{accountId}/webhooks/events":{"get":{"tags":["Webhooks"],"summary":"Lista los eventos disponibles","operationId":"events","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}}}}}}},"/api/v1/accounts/{accountId}/summary":{"get":{"tags":["Identidad y negocios"],"summary":"Devuelve los indicadores del panel de inicio","operationId":"summary","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DashboardSummary"}}}}}}},"/api/v1/accounts/{accountId}/status":{"get":{"tags":["Identidad y negocios"],"summary":"Consulta el estado operativo, plan y suscripción del negocio","operationId":"accountStatus","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiAccountStatusView"}}}}}}},"/api/v1/accounts/{accountId}/sales/{type}/{saleId}":{"get":{"tags":["Ventas"],"summary":"Consulta el detalle de una venta","operationId":"sale","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}},{"name":"saleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiSaleDetailView"}}}}}}},"/api/v1/accounts/{accountId}/sales/totals":{"get":{"tags":["Ventas"],"summary":"Calcula totales, ticket promedio y medios de pago","operationId":"totals","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiSalesTotalsView"}}}}}}},"/api/v1/accounts/{accountId}/reports":{"get":{"tags":["Reportes"],"summary":"Devuelve el reporte completo disponible en Espina","operationId":"fullReport","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReporteView"}}}}}}},"/api/v1/accounts/{accountId}/reports/summary":{"get":{"tags":["Reportes"],"summary":"Devuelve indicadores, variaciones y ticket promedio","operationId":"summary_1","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/sellers":{"get":{"tags":["Reportes"],"summary":"Devuelve rendimiento por vendedor","operationId":"sellers","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/sales-series":{"get":{"tags":["Reportes"],"summary":"Devuelve la serie temporal de ventas","operationId":"salesSeries","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/products":{"get":{"tags":["Reportes"],"summary":"Devuelve productos destacados y accionables","operationId":"products","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/peak-hours":{"get":{"tags":["Reportes"],"summary":"Devuelve ventas agrupadas por hora","operationId":"peakHours","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/payment-methods":{"get":{"tags":["Reportes"],"summary":"Devuelve totales por medio de pago","operationId":"paymentMethods","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/inventory":{"get":{"tags":["Reportes"],"summary":"Devuelve el resumen y las alertas de inventario","operationId":"inventory","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/categories":{"get":{"tags":["Reportes"],"summary":"Compara las categorías del periodo","operationId":"categories","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/reports/cash":{"get":{"tags":["Reportes"],"summary":"Devuelve el resumen de caja y cobros digitales","operationId":"cash","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"grouping","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v1/accounts/{accountId}/products":{"get":{"tags":["Productos e inventario"],"summary":"Lista y filtra los productos del negocio","operationId":"products_1","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"unit","in":"query","required":false,"schema":{"type":"string"}},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"stockStatus","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiPageApiProductView"}}}}}}},"/api/v1/accounts/{accountId}/products/{productId}":{"get":{"tags":["Productos e inventario"],"summary":"Consulta un producto","operationId":"product","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"productId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiProductView"}}}}}}},"/api/v1/accounts/{accountId}/products/categories":{"get":{"tags":["Productos e inventario"],"summary":"Lista las categorías existentes","operationId":"categories_1","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}}}}},"/api/v1/accounts/{accountId}/inventory/movements":{"get":{"tags":["Productos e inventario"],"summary":"Lista los movimientos de inventario","operationId":"inventoryMovements","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"productId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiPageApiInventoryMovementView"}}}}}}},"/api/v1/accounts/{accountId}/inventory/alerts":{"get":{"tags":["Productos e inventario"],"summary":"Lista alertas de bajo stock y productos sin stock","operationId":"inventoryAlerts","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiPageApiProductView"}}}}}}},"/api/v1/accounts/{accountId}/balances":{"get":{"tags":["Balances operativos"],"summary":"Resume ventas, caja y medios de pago del periodo","operationId":"balance","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiBalanceView"}}}}}}},"/api/v1/accounts/{accountId}/activity":{"get":{"tags":["Bitácora"],"summary":"Devuelve la bitácora unificada del negocio con carga incremental","operationId":"activity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BitacoraFeedView"}}}}}}}},"components":{"schemas":{"WebhookSubscriptionRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":160,"minLength":0},"targetUrl":{"type":"string","maxLength":2048,"minLength":0},"events":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true}},"required":["events","name","targetUrl"]},"WebhookSubscriptionView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"accountId":{"type":"integer","format":"int64"},"name":{"type":"string"},"targetUrl":{"type":"string"},"events":{"type":"array","items":{"type":"string"},"uniqueItems":true},"active":{"type":"boolean"},"lastSuccessAt":{"type":"string","format":"date-time"},"lastFailureAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"signingSecret":{"type":"string"}}},"ApiProductSaleRequest":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiSaleItemRequest"},"maxItems":200,"minItems":0},"paymentMethod":{"type":"string","enum":["EFECTIVO","TRANSFERENCIA","TARJETA"]},"observation":{"type":"string","maxLength":2000,"minLength":0}},"required":["items","paymentMethod"]},"ApiSaleItemRequest":{"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"quantity":{"type":"integer","format":"int32","minimum":1}},"required":["productId","quantity"]},"ApiPaymentView":{"type":"object","properties":{"method":{"type":"string"},"amount":{"type":"number"}}},"ApiSaleDetailView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"type":"string"},"status":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"seller":{"type":"string"},"total":{"type":"number"},"observation":{"type":"string"},"payments":{"type":"array","items":{"$ref":"#/components/schemas/ApiPaymentView"}},"lines":{"type":"array","items":{"$ref":"#/components/schemas/ApiSaleLineView"}}}},"ApiSaleLineView":{"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"productCode":{"type":"string"},"productDescription":{"type":"string"},"quantity":{"type":"integer","format":"int32"},"unitPrice":{"type":"number"},"subtotal":{"type":"number"}}},"ApiManualSaleRequest":{"type":"object","properties":{"total":{"type":"number","minimum":0.01},"paymentMethod":{"type":"string","enum":["EFECTIVO","TRANSFERENCIA","TARJETA"]},"observation":{"type":"string","maxLength":2000,"minLength":0}},"required":["paymentMethod","total"]},"MobileDeviceRequest":{"type":"object","properties":{"expoPushToken":{"type":"string","maxLength":255,"minLength":0,"pattern":"^(Expo|Exponent)PushToken\\[[A-Za-z0-9_-]+]$"},"platform":{"type":"string","minLength":1,"pattern":"^(ios|android)$"},"deviceName":{"type":"string","maxLength":160,"minLength":0},"eventTypes":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true}},"required":["eventTypes","expoPushToken","platform"]},"MobileDeviceView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"accountId":{"type":"integer","format":"int64"},"platform":{"type":"string"},"deviceName":{"type":"string"},"enabled":{"type":"boolean"},"eventTypes":{"type":"array","items":{"type":"string"},"uniqueItems":true},"lastSeenAt":{"type":"string","format":"date-time"}}},"WebhookSubscriptionUpdateRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":160,"minLength":0},"targetUrl":{"type":"string","maxLength":2048,"minLength":0},"events":{"type":"array","items":{"type":"string"},"uniqueItems":true},"active":{"type":"boolean"}}},"MobileDeviceUpdateRequest":{"type":"object","properties":{"enabled":{"type":"boolean"},"eventTypes":{"type":"array","items":{"type":"string"},"uniqueItems":true}}},"ProductoBusquedaItemView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"codigo":{"type":"string"},"descripcion":{"type":"string"},"etiqueta":{"type":"string"}}},"ApiAccountView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"role":{"type":"string"},"plan":{"type":"string"},"subscriptionStatus":{"type":"string"},"trialEndsAt":{"type":"string","format":"date"},"paidUntil":{"type":"string","format":"date"},"active":{"type":"boolean"},"setupCompleted":{"type":"boolean"}}},"ApiUserView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"email":{"type":"string"},"pictureUrl":{"type":"string"},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/ApiAccountView"}}}},"ApiPageWebhookDeliveryView":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveryView"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"WebhookDeliveryView":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"eventType":{"type":"string"},"status":{"type":"string"},"attemptCount":{"type":"integer","format":"int32"},"responseStatus":{"type":"integer","format":"int32"},"responseBody":{"type":"string"},"lastError":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastAttemptAt":{"type":"string","format":"date-time"},"nextAttemptAt":{"type":"string","format":"date-time"},"deliveredAt":{"type":"string","format":"date-time"},"payload":{"type":"string"}}},"DashboardSummary":{"type":"object","properties":{"productosActivos":{"type":"integer","format":"int64"},"productosBajoStock":{"type":"integer","format":"int64"},"ventasHoy":{"type":"integer","format":"int64"},"totalVendidoHoy":{"type":"number"},"pinesActivos":{"type":"integer","format":"int64"}}},"ApiAccountStatusView":{"type":"object","properties":{"accountId":{"type":"integer","format":"int64"},"operational":{"type":"boolean"},"accountStatus":{"type":"string"},"subscriptionStatus":{"type":"string"},"plan":{"type":"string"},"activeProducts":{"type":"integer","format":"int64"},"lowStockProducts":{"type":"integer","format":"int64"},"members":{"type":"integer","format":"int64"},"generatedAt":{"type":"string","format":"date-time"}}},"ApiPageVentaResumenView":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/VentaResumenView"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"VentaResumenView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"fechaHora":{"type":"string","format":"date-time"},"medioPago":{"type":"string"},"total":{"type":"number"},"vendedorNombre":{"type":"string"},"cantidadItems":{"type":"integer","format":"int64"},"observacion":{"type":"string"},"tipo":{"type":"string"},"estado":{"type":"string"}}},"ApiSalesTotalsView":{"type":"object","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"salesCount":{"type":"integer","format":"int64"},"grossSales":{"type":"number"},"averageTicket":{"type":"number"},"paymentMethods":{"type":"object","additionalProperties":{"type":"number"}}}},"DailyTotalView":{"type":"object","properties":{"fecha":{"type":"string","format":"date"},"total":{"type":"number"}}},"PaymentTotalView":{"type":"object","properties":{"medioPago":{"type":"string","enum":["EFECTIVO","TRANSFERENCIA","TARJETA"]},"total":{"type":"number"}}},"ReporteAlertaView":{"type":"object","properties":{"nivel":{"type":"string"},"titulo":{"type":"string"},"detalle":{"type":"string"},"accion":{"type":"string"}}},"ReporteCajaView":{"type":"object","properties":{"efectivoEsperado":{"type":"number"},"totalDigital":{"type":"number"},"participacionEfectivoPct":{"type":"number"},"ventasMixtas":{"type":"integer","format":"int64"},"ventasSoloEfectivo":{"type":"integer","format":"int64"},"ventasDigitales":{"type":"integer","format":"int64"}}},"ReporteCategoriaComparativaView":{"type":"object","properties":{"categoria":{"type":"string"},"totalActual":{"type":"number"},"totalAnterior":{"type":"number"},"variacionPct":{"type":"number"},"cantidadVendidaActual":{"type":"integer","format":"int64"}}},"ReporteHoraView":{"type":"object","properties":{"franja":{"type":"string"},"cantidadVentas":{"type":"integer","format":"int64"},"totalVendido":{"type":"number"}}},"ReporteInventarioView":{"type":"object","properties":{"productosActivos":{"type":"integer","format":"int64"},"productosBajoStock":{"type":"integer","format":"int64"},"productosSinStock":{"type":"integer","format":"int64"},"productosSinVentas":{"type":"integer","format":"int64"}}},"ReporteProductoAccionView":{"type":"object","properties":{"codigo":{"type":"string"},"descripcion":{"type":"string"},"accion":{"type":"string"},"motivo":{"type":"string"},"stockActual":{"type":"integer","format":"int32"},"stockMinimo":{"type":"integer","format":"int32"},"cantidadVendida":{"type":"string"}}},"ReporteResumenView":{"type":"object","properties":{"totalPeriodo":{"type":"number"},"totalPeriodoAnterior":{"type":"number"},"variacionTotalPct":{"type":"number"},"cantidadVentasPeriodo":{"type":"integer","format":"int64"},"cantidadVentasPeriodoAnterior":{"type":"integer","format":"int64"},"ticketPromedio":{"type":"number"},"ticketPromedioAnterior":{"type":"number"},"variacionTicketPromedioPct":{"type":"number"},"promedioDiario":{"type":"number"},"promedioDiarioAnterior":{"type":"number"},"variacionPromedioDiarioPct":{"type":"number"},"totalHoy":{"type":"number"},"cantidadVentasHoy":{"type":"integer","format":"int64"},"mejorDiaEtiqueta":{"type":"string"},"mejorDiaTotal":{"type":"number"},"mejorVendedor":{"type":"string"},"mejorVendedorTotal":{"type":"number"}}},"ReporteSerieView":{"type":"object","properties":{"etiqueta":{"type":"string"},"totalVendido":{"type":"number"},"cantidadVentas":{"type":"integer","format":"int64"}}},"ReporteVendedorView":{"type":"object","properties":{"nombre":{"type":"string"},"cantidadVentas":{"type":"integer","format":"int64"},"totalVendido":{"type":"number"},"ticketPromedio":{"type":"number"}}},"ReporteView":{"type":"object","properties":{"fechaDesde":{"type":"string","format":"date"},"fechaHasta":{"type":"string","format":"date"},"agrupacion":{"type":"string"},"resumen":{"$ref":"#/components/schemas/ReporteResumenView"},"caja":{"$ref":"#/components/schemas/ReporteCajaView"},"inventario":{"$ref":"#/components/schemas/ReporteInventarioView"},"totalesPorMedioPago":{"type":"array","items":{"$ref":"#/components/schemas/PaymentTotalView"}},"serieVentas":{"type":"array","items":{"$ref":"#/components/schemas/ReporteSerieView"}},"categoriasComparativas":{"type":"array","items":{"$ref":"#/components/schemas/ReporteCategoriaComparativaView"}},"vendedores":{"type":"array","items":{"$ref":"#/components/schemas/ReporteVendedorView"}},"horasPico":{"type":"array","items":{"$ref":"#/components/schemas/ReporteHoraView"}},"topProductos":{"type":"array","items":{"$ref":"#/components/schemas/TopProductoView"}},"productosAccionables":{"type":"array","items":{"$ref":"#/components/schemas/ReporteProductoAccionView"}},"alertas":{"type":"array","items":{"$ref":"#/components/schemas/ReporteAlertaView"}},"totalesPorDia":{"type":"array","items":{"$ref":"#/components/schemas/DailyTotalView"}},"ventasDelDia":{"type":"array","items":{"$ref":"#/components/schemas/VentaResumenView"}},"ventasRecientes":{"type":"array","items":{"$ref":"#/components/schemas/VentaResumenView"}}}},"TopProductoView":{"type":"object","properties":{"codigo":{"type":"string"},"descripcion":{"type":"string"},"cantidadVendida":{"type":"string"},"cantidadVendidaValor":{"type":"integer","format":"int64"},"totalVendido":{"type":"number"}}},"ApiPageApiProductView":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiProductView"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"ApiProductView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"code":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"unitCode":{"type":"string"},"unitName":{"type":"string"},"customUnit":{"type":"string"},"price":{"type":"number"},"currentStock":{"type":"integer","format":"int32"},"minimumStock":{"type":"integer","format":"int32"},"stockStatus":{"type":"string"},"active":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ApiInventoryMovementView":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"occurredAt":{"type":"string","format":"date-time"},"productId":{"type":"integer","format":"int64"},"productCode":{"type":"string"},"productDescription":{"type":"string"},"incomingUnits":{"type":"integer","format":"int32"},"description":{"type":"string"},"receiptUrl":{"type":"string"},"performedBy":{"type":"string"}}},"ApiPageApiInventoryMovementView":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiInventoryMovementView"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"ApiBalanceView":{"type":"object","properties":{"currency":{"type":"string"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"salesCount":{"type":"integer","format":"int64"},"grossSales":{"type":"number"},"averageTicket":{"type":"number"},"expectedCash":{"type":"number"},"digitalSales":{"type":"number"},"paymentMethods":{"type":"object","additionalProperties":{"type":"number"}}}},"BitacoraEventView":{"type":"object","properties":{"key":{"type":"string"},"category":{"type":"string"},"type":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"title":{"type":"string"},"detail":{"type":"string"},"actorName":{"type":"string"},"amount":{"type":"number"},"status":{"type":"string"},"reference":{"type":"string"},"paymentMethod":{"type":"string"},"documentUrl":{"type":"string"},"products":{"type":"array","items":{"$ref":"#/components/schemas/BitacoraProductView"}}}},"BitacoraFeedView":{"type":"object","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"items":{"type":"array","items":{"$ref":"#/components/schemas/BitacoraEventView"}},"nextOffset":{"type":"integer","format":"int32"},"hasMore":{"type":"boolean"}}},"BitacoraProductView":{"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"code":{"type":"string"},"description":{"type":"string"},"quantity":{"type":"integer","format":"int32"},"quantityLabel":{"type":"string"},"unitPrice":{"type":"number"},"subtotal":{"type":"number"}}}},"securitySchemes":{"espinaOAuth":{"type":"oauth2","description":"OAuth 2.1 Authorization Code con PKCE","flows":{"authorizationCode":{"authorizationUrl":"https://www.espinacomercial.com/oauth2/authorize","tokenUrl":"https://www.espinacomercial.com/oauth2/token","refreshUrl":"https://www.espinacomercial.com/oauth2/token","scopes":{"openid":"Identidad OpenID Connect","profile":"Nombre y perfil del usuario","email":"Email del usuario","accounts:read":"Consultar negocios y estado","products:read":"Consultar productos","inventory:read":"Consultar stock y movimientos","sales:read":"Consultar ventas","sales:write":"Registrar ventas","reports:read":"Consultar reportes y bitácora operativa","notifications:manage":"Administrar dispositivos y notificaciones","webhooks:manage":"Administrar webhooks"}}}}}}}