{"openapi":"3.0.1","info":{"title":"CookieSun API","description":"Public catalog and authenticated ordering API for CookieSun, an Israeli bakery. Read endpoints are public; cart and order endpoints require OAuth. See https://cookiesun.com/llms.txt and https://cookiesun.com/auth.md.","contact":{"name":"CookieSun","url":"https://cookiesun.com","email":"ozishemesh@gmail.com"},"license":{"name":"Proprietary"},"version":"1.0.0"},"servers":[{"url":"https://cookiesun.com/api","description":"Production"}],"tags":[{"name":"Catalog","description":"Public catalog endpoints"},{"name":"Orders","description":"Order management for authenticated users"},{"name":"Mock Payment","description":"Mock payment page for testing"},{"name":"Admin Product Recipe","description":"Per-product cost recipe management"},{"name":"Agentic Commerce","description":"OpenAI Agentic Commerce Protocol (ACP) checkout"},{"name":"Status","description":"Public service status"},{"name":"Cart","description":"Shopping cart endpoints (authenticated customers)"},{"name":"Order Availability","description":"Public online order window configuration"},{"name":"Admin Product Packages","description":"Sellable product package management"},{"name":"Admin Order Availability","description":"Configure when customers can place online orders"},{"name":"Fulfillment Availability","description":"Public pickup/delivery time slots"},{"name":"Admin Catalog","description":"Catalog management for administrators"},{"name":"Admin Clearing Fee","description":"Configure payment clearing fee rates"},{"name":"Admin Cost Items","description":"Production cost item catalog management"},{"name":"Admin Orders","description":"Order management for administrators"},{"name":"Admin Usage","description":"Customer access/usage reporting for administrators"},{"name":"Admin Inventory","description":"Inventory management for administrators"},{"name":"Admin Package Types","description":"Package type management"},{"name":"Payment","description":"Checkout payment endpoints (Pelecard iframe)"},{"name":"Pelecard Feedback","description":"Server-to-server transaction feedback from Pelecard"},{"name":"Admin Reports","description":"Profit and sales reporting for administrators"},{"name":"Admin Fulfillment Schedule","description":"Configure pickup/delivery availability"}],"paths":{"/cart/preferences":{"put":{"tags":["Cart"],"summary":"Update checkout preferences on cart","description":"Update checkout preferences on cart","operationId":"updatePreferences","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCartPreferencesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/cart/items/{itemId}":{"put":{"tags":["Cart"],"summary":"Update cart item","description":"Update cart item","operationId":"updateCartItem","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCartItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Cart"],"summary":"Remove item from cart","description":"Remove item from cart","operationId":"removeFromCart","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/product-packages/{id}":{"put":{"tags":["Admin Product Packages"],"summary":"Update product package","description":"Update product package","operationId":"updateProductPackage","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductPackageRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductPackageAdminResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Product Packages"],"summary":"Delete product package (offering)","description":"Delete product package (offering)","operationId":"deleteProductPackage","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/product-packages/{id}/cost":{"put":{"tags":["Admin Product Packages"],"summary":"Update offering price, units, and packaging cost lines","description":"Update offering price, units, and packaging cost lines","operationId":"updateOfferingCost","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOfferingCostRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OfferingCostBreakdownResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/product-packages/bulk":{"put":{"tags":["Admin Product Packages"],"summary":"Bulk create or update product packages","description":"Bulk create or update product packages","operationId":"bulkUpdate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateProductPackagesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductPackageAdminResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/package-types/{id}":{"put":{"tags":["Admin Package Types"],"summary":"Update package type","description":"Update package type","operationId":"updatePackageType","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePackageTypeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminPackageTypeResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Package Types"],"summary":"Delete package type","description":"Delete package type","operationId":"deletePackageType","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/{orderId}/status":{"put":{"tags":["Admin Orders"],"summary":"Update order status","description":"Update order status","operationId":"updateOrderStatus","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"status","in":"query","required":true,"schema":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/draft/preferences":{"put":{"tags":["Admin Orders"],"summary":"Update admin POS order draft preferences","description":"Update admin POS order draft preferences","operationId":"updateDraftPreferences","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminOrderDraftPreferencesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminOrderDraftResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/draft/items/{itemId}":{"put":{"tags":["Admin Orders"],"summary":"Update admin POS order draft item","description":"Update admin POS order draft item","operationId":"updateDraftItem","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminOrderDraftItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminOrderDraftResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Orders"],"summary":"Remove item from admin POS order draft","description":"Remove item from admin POS order draft","operationId":"removeDraftItem","parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminOrderDraftResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/order-availability":{"get":{"tags":["Admin Order Availability"],"summary":"Get order availability configuration","description":"Get order availability configuration","operationId":"getAvailability_2","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderAvailabilityResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Order Availability"],"summary":"Update order availability configuration","description":"Update order availability configuration","operationId":"updateAvailability","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAvailabilityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderAvailabilityResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/inventory":{"get":{"tags":["Admin Inventory"],"summary":"Get all inventory items","description":"Get all inventory items","operationId":"getAllInventory","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InventoryItemResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Inventory"],"summary":"Update inventory","description":"Update inventory","operationId":"updateInventory","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInventoryRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InventoryItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/fulfillment-schedule":{"get":{"tags":["Admin Fulfillment Schedule"],"summary":"Get fulfillment schedule configuration","description":"Get fulfillment schedule configuration","operationId":"getSchedule","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FulfillmentScheduleResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Fulfillment Schedule"],"summary":"Update fulfillment schedule configuration","description":"Update fulfillment schedule configuration","operationId":"updateSchedule","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FulfillmentScheduleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FulfillmentScheduleResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/fulfillment-schedule/day":{"put":{"tags":["Admin Fulfillment Schedule"],"summary":"Update a single day - either as a one-off override or weekday template","description":"Update a single day - either as a one-off override or weekday template","operationId":"updateDay","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDayScheduleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FulfillmentScheduleResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/cost-items/{id}":{"get":{"tags":["Admin Cost Items"],"summary":"Get cost item by id","description":"Get cost item by id","operationId":"getCostItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CostItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Cost Items"],"summary":"Update cost item","description":"Update cost item","operationId":"updateCostItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCostItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CostItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Cost Items"],"summary":"Delete cost item","description":"Delete cost item","operationId":"deleteCostItem","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/clearing-fee":{"get":{"tags":["Admin Clearing Fee"],"summary":"Get payment clearing fee settings","description":"Get payment clearing fee settings","operationId":"getSettings","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClearingFeeSettingsResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Clearing Fee"],"summary":"Update payment clearing fee settings","description":"Update payment clearing fee settings","operationId":"updateSettings","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClearingFeeSettingsRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClearingFeeSettingsResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/products/{productId}/recipe":{"get":{"tags":["Admin Product Recipe"],"summary":"Get product cost recipe","description":"Get product cost recipe","operationId":"getRecipe","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductRecipeResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"tags":["Admin Product Recipe"],"summary":"Replace product cost recipe","description":"Replace product cost recipe","operationId":"replaceRecipe","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceProductRecipeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductRecipeResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/products/{id}":{"put":{"tags":["Admin Catalog"],"summary":"Update product","description":"Update product","operationId":"updateProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Catalog"],"summary":"Delete product (soft delete)","description":"Delete product (soft delete)","operationId":"deleteProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/products/{id}/active":{"put":{"tags":["Admin Catalog"],"summary":"Toggle product active status","description":"Toggle product active status","operationId":"toggleProductActive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"active","in":"query","required":true,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/categories/{id}":{"put":{"tags":["Admin Catalog"],"summary":"Update category","description":"Update category","operationId":"updateCategory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCategoryRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CategoryResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Catalog"],"summary":"Delete category (soft delete)","description":"Delete category (soft delete)","operationId":"deleteCategory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/profile/avatar":{"post":{"tags":["profile-avatar-controller"],"description":"Operation on /profile/avatar.","operationId":"uploadAvatar","parameters":[{"name":"previousFileId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["profile-avatar-controller"],"description":"Operation on /profile/avatar.","operationId":"deleteAvatar","parameters":[{"name":"fileId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/pelecard/feedback/good":{"post":{"tags":["Pelecard Feedback"],"summary":"Pelecard good-transaction feedback","description":"Verifies amount and ConfirmationKey with Pelecard, then idempotently marks the order paid.","operationId":"goodFeedback","requestBody":{"content":{"*/*":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/pelecard/feedback/error":{"post":{"tags":["Pelecard Feedback"],"summary":"Pelecard failed-transaction feedback","description":"Idempotently cancels the unpaid order and restores cart/inventory.","operationId":"errorFeedback","requestBody":{"content":{"*/*":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/mock/complete":{"post":{"tags":["Mock Payment"],"summary":"Complete mock payment","description":"Complete mock payment","operationId":"completeMockPayment","parameters":[{"name":"orderId","in":"query","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}},{"name":"outcome","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/checkout/{orderId}":{"post":{"tags":["Payment"],"summary":"Start payment for an order","description":"Initializes a payment with the configured provider and returns the hosted payment page URL to embed in the checkout iframe.","operationId":"createPaymentLink","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaymentLinkResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/checkout/{orderId}/confirm":{"post":{"tags":["Payment"],"summary":"Confirm payment result for an order","description":"Provider-verified payment status. Called by the checkout page after the payment iframe lands on the payment-result route; the answer comes from the provider (or the already-applied server feedback), never from browser input.","operationId":"confirmPayment","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaymentConfirmResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/orders":{"post":{"tags":["Orders"],"summary":"Create order from current cart","description":"Creates an order from the authenticated user's cart. Pass an `Idempotency-Key` header to make retries safe — repeating a request with the same key returns the original order instead of creating a duplicate.","operationId":"createOrder","parameters":[{"name":"Idempotency-Key","in":"header","description":"Client-generated key; repeats are de-duplicated.","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/cart/items":{"post":{"tags":["Cart"],"summary":"Add item to cart","description":"Add item to cart","operationId":"addToCart","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddToCartRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/agentic-commerce/checkout_sessions":{"post":{"tags":["Agentic Commerce"],"summary":"Create an ACP checkout session","description":"Creates a canonical ACP CheckoutSession from a cart of items. Echoes the requested API-Version. Idempotency-Key is honored.","operationId":"createSession","parameters":[{"name":"API-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/agentic-commerce/checkout_sessions/{id}/complete":{"post":{"tags":["Agentic Commerce"],"summary":"Complete an ACP checkout session","description":"Complete an ACP checkout session","operationId":"complete","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/agentic-commerce/checkout_sessions/{id}/cancel":{"post":{"tags":["Agentic Commerce"],"summary":"Cancel an ACP checkout session","description":"Cancel an ACP checkout session","operationId":"cancel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/storage/upload":{"post":{"tags":["storage-controller"],"description":"Operation on /admin/storage/upload.","operationId":"uploadFile","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/storage/preview":{"post":{"tags":["storage-controller"],"description":"Operation on /admin/storage/preview.","operationId":"previewFile","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/product-packages":{"get":{"tags":["Admin Product Packages"],"summary":"Get product packages (optionally filter by product or package type)","description":"Get product packages (optionally filter by product or package type)","operationId":"getProductPackages","parameters":[{"name":"productId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"packageTypeId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductPackageAdminResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Product Packages"],"summary":"Create product package","description":"Create product package","operationId":"createProductPackage","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductPackageRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductPackageAdminResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/package-types":{"get":{"tags":["Admin Package Types"],"summary":"Get all package types","description":"Get all package types","operationId":"getAllPackageTypes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminPackageTypeResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Package Types"],"summary":"Create package type","description":"Create package type","operationId":"createPackageType","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePackageTypeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminPackageTypeResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders":{"get":{"tags":["Admin Orders"],"summary":"Search and list orders","description":"Search and list orders","operationId":"getAllOrders","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}},{"name":"delivery","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"customer","in":"query","required":false,"schema":{"type":"string"}},{"name":"phone","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"userId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"pageable","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Pageable"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageOrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Orders"],"summary":"Create order from admin POS draft","description":"Create order from admin POS draft","operationId":"createOrderFromDraft","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdminOrderRequest"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/{orderId}/invoice":{"post":{"tags":["Admin Orders"],"summary":"Create Payper invoice for a paid order","description":"Post-hoc invoice creation for a paid order that has no invoice yet (automatic invoice failed, or the order predates the Payper integration).","operationId":"createInvoice","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/draft/items":{"post":{"tags":["Admin Orders"],"summary":"Add item to admin POS order draft","description":"Add item to admin POS order draft","operationId":"addDraftItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddAdminOrderDraftItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminOrderDraftResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/inventory/product-package/{productPackageId}/adjust":{"post":{"tags":["Admin Inventory"],"summary":"Adjust stock by delta (positive to add, negative to remove)","description":"Adjust stock by delta (positive to add, negative to remove)","operationId":"adjustStock","parameters":[{"name":"productPackageId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"adjustment","in":"query","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InventoryItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/cost-items":{"get":{"tags":["Admin Cost Items"],"summary":"List all cost items","description":"List all cost items","operationId":"getCostItems","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CostItemResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Cost Items"],"summary":"Create cost item","description":"Create cost item","operationId":"createCostItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCostItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CostItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/products":{"get":{"tags":["Admin Catalog"],"summary":"Get all products (including inactive)","description":"Get all products (including inactive)","operationId":"getAllProducts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Catalog"],"summary":"Create product","description":"Create product","operationId":"createProduct","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/catalog/categories":{"get":{"tags":["Admin Catalog"],"summary":"Get all categories (including inactive)","description":"Get all categories (including inactive)","operationId":"getAllCategories","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CategoryResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["Admin Catalog"],"summary":"Create category","description":"Create category","operationId":"createCategory","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCategoryRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CategoryResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/access":{"get":{"tags":["admin-access-controller"],"description":"Operation on /admin/access.","operationId":"listAdmins","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"type":"object","additionalProperties":{"type":"object"}}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"tags":["admin-access-controller"],"description":"Operation on /admin/access.","operationId":"addAdmin","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddAdminRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/status":{"get":{"tags":["Status"],"summary":"Service status","description":"Returns current operational status, last-updated timestamp, and any active incidents.","operationId":"status","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/payment/mock":{"get":{"tags":["Mock Payment"],"summary":"Mock payment page","description":"Mock payment page","operationId":"showMockPaymentPage","parameters":[{"name":"orderId","in":"query","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/orders/{orderId}":{"get":{"tags":["Orders"],"summary":"Get order by ID","description":"Get order by ID","operationId":"getOrderById","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/orders/my":{"get":{"tags":["Orders"],"summary":"Get my orders","description":"Get my orders","operationId":"getMyOrders","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/order-availability":{"get":{"tags":["Order Availability"],"summary":"Get whether online orders are currently accepted","description":"Get whether online orders are currently accepted","operationId":"getAvailability","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderAvailabilityResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/fulfillment-availability":{"get":{"tags":["Fulfillment Availability"],"summary":"Get available pickup/delivery dates and time slots","description":"Get available pickup/delivery dates and time slots","operationId":"getAvailability_1","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FulfillmentAvailabilityResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products":{"get":{"tags":["Catalog"],"summary":"Get all active products","description":"Get all active products","operationId":"getProducts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products/{id}":{"get":{"tags":["Catalog"],"summary":"Get product by ID","description":"Get product by ID","operationId":"getProductById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products/{id}/packages":{"get":{"tags":["Catalog"],"summary":"Get active package options for a product","description":"Get active package options for a product","operationId":"getPackagesByProductId","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductPackageOfferingResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products/vegan":{"get":{"tags":["Catalog"],"summary":"Get vegan products","description":"Get vegan products","operationId":"getVeganProducts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products/search":{"get":{"tags":["Catalog"],"summary":"Search products by name or description","description":"Search products by name or description","operationId":"searchProducts","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/products/gluten-free":{"get":{"tags":["Catalog"],"summary":"Get gluten-free products","description":"Get gluten-free products","operationId":"getGlutenFreeProducts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/product-of-the-day":{"get":{"tags":["Catalog"],"summary":"Get today's featured product (admin-pinned or daily rotation)","description":"Get today's featured product (admin-pinned or daily rotation)","operationId":"getProductOfTheDay","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductOfTheDayResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/package-types":{"get":{"tags":["Catalog"],"summary":"Get active package types","description":"Get active package types","operationId":"getPackageTypes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PackageTypeResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/package-types/{id}/offerings":{"get":{"tags":["Catalog"],"summary":"Get active product offerings for a package type","description":"Get active product offerings for a package type","operationId":"getOfferingsByPackageType","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductPackageOfferingResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/categories":{"get":{"tags":["Catalog"],"summary":"Get all active categories","description":"Get all active categories","operationId":"getCategories","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CategoryResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/categories/{id}":{"get":{"tags":["Catalog"],"summary":"Get category by ID","description":"Get category by ID","operationId":"getCategoryById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CategoryResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/categories/{id}/products":{"get":{"tags":["Catalog"],"summary":"Get products by category","description":"Get products by category","operationId":"getProductsByCategory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/catalog/categories/with-products":{"get":{"tags":["Catalog"],"summary":"Get all active categories with their products","description":"Get all active categories with their products","operationId":"getCategoriesWithProducts","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CategoryResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/cart":{"get":{"tags":["Cart"],"summary":"Get current cart","description":"Get current cart","operationId":"getCart","parameters":[{"name":"cookiesun_session","in":"cookie","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Cart"],"summary":"Clear cart","description":"Clear cart","operationId":"clearCart","responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/cart/validate":{"get":{"tags":["Cart"],"summary":"Validate cart inventory availability before checkout","description":"Validate cart inventory availability before checkout","operationId":"validateCart","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CartValidationResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/agentic-commerce/checkout_sessions/{id}":{"get":{"tags":["Agentic Commerce"],"summary":"Retrieve an ACP checkout session","description":"Retrieve an ACP checkout session","operationId":"getSession","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/usage/users":{"get":{"tags":["Admin Usage"],"summary":"Users who accessed the app in a date range","description":"Users who accessed the app in a date range","operationId":"getUsers","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"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":200}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageUserRowResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/usage/timeseries":{"get":{"tags":["Admin Usage"],"summary":"Daily unique-user access timeseries","description":"Daily unique-user access timeseries","operationId":"getTimeseries","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageTimeseriesPointResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/usage/summary":{"get":{"tags":["Admin Usage"],"summary":"Customer usage summary for a date range","description":"Customer usage summary for a date range","operationId":"getSummary","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsageSummaryResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/usage/new-users":{"get":{"tags":["Admin Usage"],"summary":"Users registered in a date range","description":"Users registered in a date range","operationId":"getNewUsers","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"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":200}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageUserRowResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/usage/events":{"get":{"tags":["Admin Usage"],"summary":"Access events in a date range","description":"Access events in a date range","operationId":"getAccessEvents","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"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":200}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UsageAccessEventResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/storage/files/{id}":{"get":{"tags":["storage-controller"],"description":"Operation on /admin/storage/files/{id}.","operationId":"getFile","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/reports/profit/timeseries":{"get":{"tags":["Admin Reports"],"summary":"Profit time series for a date range","description":"Profit time series for a date range","operationId":"getProfitTimeseries","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"granularity","in":"query","required":false,"schema":{"type":"string","default":"day"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProfitTimeseriesPointResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/reports/profit/summary":{"get":{"tags":["Admin Reports"],"summary":"Profit summary for a date range","description":"Profit summary for a date range","operationId":"getProfitSummary","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProfitSummaryResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/reports/profit/by-product":{"get":{"tags":["Admin Reports"],"summary":"Profit breakdown by product","description":"Profit breakdown by product","operationId":"getProfitByProduct","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductProfitRowResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/reports/profit/by-package":{"get":{"tags":["Admin Reports"],"summary":"Profit breakdown by product package offering","description":"Profit breakdown by product package offering","operationId":"getProfitByPackage","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PackageProfitRowResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/product-packages/{id}/cost-breakdown":{"get":{"tags":["Admin Product Packages"],"summary":"Get offering cost breakdown and margin","description":"Get offering cost breakdown and margin","operationId":"getCostBreakdown","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OfferingCostBreakdownResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/{orderId}":{"get":{"tags":["Admin Orders"],"summary":"Get order by ID","description":"Get order by ID","operationId":"getOrderById_1","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/status/{status}":{"get":{"tags":["Admin Orders"],"summary":"Get orders by status","description":"Get orders by status","operationId":"getOrdersByStatus","parameters":[{"name":"status","in":"path","required":true,"schema":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]}},{"name":"pageable","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Pageable"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageOrderResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/pickup/{date}":{"get":{"tags":["Admin Orders"],"summary":"Get pickup orders for a date","description":"Get pickup orders for a date","operationId":"getPickupOrdersByDate","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/orders/draft":{"get":{"tags":["Admin Orders"],"summary":"Get admin POS order draft","description":"Get admin POS order draft","operationId":"getDraft","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminOrderDraftResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"tags":["Admin Orders"],"summary":"Clear admin POS order draft","description":"Clear admin POS order draft","operationId":"clearDraft","responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/inventory/product-package/{productPackageId}":{"get":{"tags":["Admin Inventory"],"summary":"Get inventory for a product package","description":"Get inventory for a product package","operationId":"getInventoryByProductPackageId","parameters":[{"name":"productPackageId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InventoryItemResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/inventory/out-of-stock":{"get":{"tags":["Admin Inventory"],"summary":"Get out of stock items","description":"Get out of stock items","operationId":"getOutOfStockItems","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InventoryItemResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/inventory/low-stock":{"get":{"tags":["Admin Inventory"],"summary":"Get low stock items","description":"Get low stock items","operationId":"getLowStockItems","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InventoryItemResponse"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/access/me":{"get":{"tags":["admin-access-controller"],"description":"Operation on /admin/access/me.","operationId":"currentAdminAccess","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/fulfillment-schedule/overrides/{date}":{"delete":{"tags":["Admin Fulfillment Schedule"],"summary":"Remove a date-specific override and revert to the weekday template","description":"Remove a date-specific override and revert to the weekday template","operationId":"deleteOverride","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FulfillmentScheduleResponse"}}}},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/admin/access/{email}":{"delete":{"tags":["admin-access-controller"],"description":"Operation on /admin/access/{email}.","operationId":"removeAdmin","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"default":{"description":"Error (RFC 7807 problem+json)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"schemas":{"UpdateCartPreferencesRequest":{"type":"object","properties":{"fulfillmentMode":{"type":"string"},"pickupDateId":{"type":"string"},"pickupSlotId":{"type":"string"}}},"CartItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"packageTypeName":{"type":"string"},"unitsPerPackage":{"type":"integer","format":"int32"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"productImageUrl":{"type":"string"},"productImageFileId":{"type":"string","format":"uuid"},"unitPrice":{"type":"number"},"quantity":{"type":"integer","format":"int32"},"notes":{"type":"string"},"subtotal":{"type":"number"}}},"CartResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"sessionId":{"type":"string"},"userId":{"type":"integer","format":"int64"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CartItemResponse"}},"totalAmount":{"type":"number"},"itemCount":{"type":"integer","format":"int32"},"fulfillmentMode":{"type":"string"},"pickupDateId":{"type":"string"},"pickupSlotId":{"type":"string"}}},"UpdateCartItemRequest":{"type":"object","properties":{"quantity":{"minimum":0,"type":"integer","format":"int32"},"notes":{"type":"string"},"productPackageId":{"type":"integer","format":"int64"}}},"CreateProductPackageRequest":{"required":["packageTypeId","price","productId"],"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"packageTypeId":{"type":"integer","format":"int64"},"unitCount":{"minimum":1,"type":"integer","format":"int32"},"price":{"type":"number"},"active":{"type":"boolean"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"minOrderQuantity":{"type":"integer","format":"int32"},"maxOrderQuantity":{"type":"integer","format":"int32"}}},"ProductPackageAdminResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"productImageUrl":{"type":"string"},"productImageFileId":{"type":"string","format":"uuid"},"packageTypeId":{"type":"integer","format":"int64"},"packageTypeName":{"type":"string"},"unitCount":{"type":"integer","format":"int32"},"price":{"type":"number"},"active":{"type":"boolean"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"minOrderQuantity":{"type":"integer","format":"int32"},"maxOrderQuantity":{"type":"integer","format":"int32"},"estimatedProductCost":{"type":"number"},"estimatedPackagingCost":{"type":"number"},"estimatedTotalCost":{"type":"number"},"estimatedMarginAmount":{"type":"number"},"estimatedMarginPercent":{"type":"number"}}},"OfferingCostLineRequest":{"required":["costItemId","quantity"],"type":"object","properties":{"costItemId":{"type":"integer","format":"int64"},"quantity":{"type":"number"}}},"UpdateOfferingCostRequest":{"required":["price"],"type":"object","properties":{"unitCount":{"minimum":1,"type":"integer","format":"int32"},"price":{"type":"number"},"costItems":{"type":"array","items":{"$ref":"#/components/schemas/OfferingCostLineRequest"}}}},"OfferingCostBreakdownResponse":{"type":"object","properties":{"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"productImageUrl":{"type":"string"},"productImageFileId":{"type":"string","format":"uuid"},"packageTypeId":{"type":"integer","format":"int64"},"packageTypeName":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"unitCount":{"type":"integer","format":"int32"},"price":{"type":"number"},"perUnitProductCost":{"type":"number"},"productCost":{"type":"number"},"packagingCost":{"type":"number"},"totalCost":{"type":"number"},"marginAmount":{"type":"number"},"marginPercent":{"type":"number"},"hasRecipe":{"type":"boolean"},"costItems":{"type":"array","items":{"$ref":"#/components/schemas/OfferingCostItemResponse"}}}},"OfferingCostItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"costItemId":{"type":"integer","format":"int64"},"costItemName":{"type":"string"},"costItemType":{"type":"string","enum":["RAW","BAGS","STICKERS","PACKAGE","LABOR"]},"unit":{"type":"string","enum":["KG","GRAM","LITER","ML","UNIT","HOUR","MINUTE"]},"quantity":{"type":"number"},"unitCost":{"type":"number"},"lineCost":{"type":"number"}}},"BulkUpdateProductPackagesRequest":{"required":["items"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CreateProductPackageRequest"}}}},"CreatePackageTypeRequest":{"required":["name"],"type":"object","properties":{"name":{"type":"string"},"adminDescription":{"type":"string"},"displayOrder":{"type":"integer","format":"int32"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"active":{"type":"boolean"}}},"AdminPackageTypeResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"adminDescription":{"type":"string"},"displayOrder":{"type":"integer","format":"int32"},"active":{"type":"boolean"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"}}},"ClearingFeeSnapshot":{"type":"object","properties":{"paymentMethod":{"type":"string"},"basePercentRate":{"type":"number"},"bitSurchargePercent":{"type":"number"},"payboxSurchargePercent":{"type":"number"},"fixedFeePerTransaction":{"type":"number"},"effectivePercentRate":{"type":"number"},"transactionAmount":{"type":"number"},"fixedComponent":{"type":"number"},"percentComponent":{"type":"number"},"total":{"type":"number"},"monthlySubscriptionFeeAtPayment":{"type":"number"},"billingPeriodStartAtPayment":{"type":"string","format":"date"},"billingPeriodEndAtPayment":{"type":"string","format":"date"}}},"CostSnapshotLine":{"type":"object","properties":{"costItemId":{"type":"integer","format":"int64"},"costItemName":{"type":"string"},"costItemType":{"type":"string","enum":["RAW","BAGS","STICKERS","PACKAGE","LABOR"]},"unit":{"type":"string","enum":["KG","GRAM","LITER","ML","UNIT","HOUR","MINUTE"]},"quantity":{"type":"number"},"unitCost":{"type":"number"},"lineCost":{"type":"number"},"source":{"type":"string"}}},"OrderItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"productImageUrl":{"type":"string"},"productImageFileId":{"type":"string","format":"uuid"},"packageTypeName":{"type":"string"},"unitsPerPackage":{"type":"integer","format":"int32"},"quantity":{"type":"integer","format":"int32"},"priceAtPurchase":{"type":"number"},"notes":{"type":"string"},"subtotal":{"type":"number"},"costRaw":{"type":"number"},"costBags":{"type":"number"},"costStickers":{"type":"number"},"costPackage":{"type":"number"},"costLabor":{"type":"number"},"costTotal":{"type":"number"},"lineCostTotal":{"type":"number"},"lineProfit":{"type":"number"},"marginPercent":{"type":"number"},"costLines":{"type":"array","items":{"$ref":"#/components/schemas/CostSnapshotLine"}}}},"OrderResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"orderNumber":{"type":"string"},"userId":{"type":"integer","format":"int64"},"createdByAdminId":{"type":"integer","format":"int64"},"status":{"type":"string","enum":["PENDING","PAYMENT_PENDING","PAID","PREPARING","READY","OUT_FOR_DELIVERY","DELIVERED","PICKED_UP","CANCELLED","REFUNDED"]},"totalAmount":{"type":"number"},"deliveryAddress":{"type":"string"},"phoneNumber":{"type":"string"},"customerName":{"type":"string"},"notes":{"type":"string"},"delivery":{"type":"boolean"},"requestedTime":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"paidAt":{"type":"string","format":"date-time"},"totalCost":{"type":"number"},"paymentMethod":{"type":"string","enum":["CARD","BIT","PAYBOX","OTHER"]},"paymentMethodRaw":{"type":"string"},"clearingFee":{"type":"number"},"clearingFeeSnapshot":{"$ref":"#/components/schemas/ClearingFeeSnapshot"},"monthlyClearingShare":{"type":"number"},"totalProfit":{"type":"number"},"marginPercent":{"type":"number"},"invoiceLink":{"type":"string"},"invoiceNumber":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/OrderItemResponse"}}}},"LocalTime":{"type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"},"second":{"type":"integer","format":"int32"},"nano":{"type":"integer","format":"int32"}}},"UpdateAdminOrderDraftPreferencesRequest":{"type":"object","properties":{"customerName":{"type":"string"},"phoneNumber":{"type":"string"},"pickupDate":{"type":"string","format":"date"},"pickupTime":{"$ref":"#/components/schemas/LocalTime"},"pickupDateId":{"type":"string"},"pickupSlotId":{"type":"string"},"notes":{"type":"string"}}},"AdminOrderDraftItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"packageTypeName":{"type":"string"},"unitsPerPackage":{"type":"integer","format":"int32"},"quantity":{"type":"integer","format":"int32"},"unitPrice":{"type":"number"},"subtotal":{"type":"number"},"imageUrl":{"type":"string"},"notes":{"type":"string"}}},"AdminOrderDraftResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"customerName":{"type":"string"},"phoneNumber":{"type":"string"},"pickupDate":{"type":"string","format":"date"},"pickupTime":{"$ref":"#/components/schemas/LocalTime"},"pickupDateId":{"type":"string"},"pickupSlotId":{"type":"string"},"notes":{"type":"string"},"totalAmount":{"type":"number"},"items":{"type":"array","items":{"$ref":"#/components/schemas/AdminOrderDraftItemResponse"}}}},"UpdateAdminOrderDraftItemRequest":{"type":"object","properties":{"quantity":{"minimum":1,"type":"integer","format":"int32"},"notes":{"type":"string"}}},"OrderAvailabilityRequest":{"required":["closedMessage","closedPhone","mode"],"type":"object","properties":{"mode":{"pattern":"open|weekly|closed","type":"string"},"weeklyFrom":{"maximum":6,"minimum":0,"type":"integer","format":"int32"},"weeklyTo":{"maximum":6,"minimum":0,"type":"integer","format":"int32"},"closedMessage":{"maxLength":512,"minLength":0,"type":"string"},"closedPhone":{"maxLength":32,"minLength":0,"type":"string"},"closedPhone2":{"maxLength":32,"minLength":0,"type":"string"}}},"OrderAvailabilityResponse":{"type":"object","properties":{"mode":{"type":"string"},"weeklyFrom":{"type":"integer","format":"int32"},"weeklyTo":{"type":"integer","format":"int32"},"closedMessage":{"type":"string"},"closedPhone":{"type":"string"},"closedPhone2":{"type":"string"},"ordersOpen":{"type":"boolean"}}},"UpdateInventoryRequest":{"required":["productPackageId"],"type":"object","properties":{"productPackageId":{"type":"integer","format":"int64"},"quantityAvailable":{"minimum":0,"type":"integer","format":"int32"},"lowStockThreshold":{"minimum":0,"type":"integer","format":"int32"}}},"InventoryItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"packageTypeId":{"type":"integer","format":"int64"},"packageTypeName":{"type":"string"},"unitCount":{"type":"integer","format":"int32"},"quantityAvailable":{"type":"integer","format":"int32"},"reservedQuantity":{"type":"integer","format":"int32"},"effectiveAvailable":{"type":"integer","format":"int32"},"lowStockThreshold":{"type":"integer","format":"int32"},"lowStock":{"type":"boolean"},"lastRestocked":{"type":"string","format":"date"}}},"DayScheduleEntry":{"type":"object","properties":{"dayOfWeek":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"enabled":{"type":"boolean"},"openTime":{"$ref":"#/components/schemas/LocalTime"},"closeTime":{"$ref":"#/components/schemas/LocalTime"},"blockedSlots":{"type":"array","items":{"$ref":"#/components/schemas/LocalTime"}}}},"FulfillmentScheduleRequest":{"required":["days","daysAhead","slotDurationMinutes"],"type":"object","properties":{"slotDurationMinutes":{"maximum":120,"minimum":15,"type":"integer","format":"int32"},"daysAhead":{"maximum":30,"minimum":1,"type":"integer","format":"int32"},"days":{"type":"array","items":{"$ref":"#/components/schemas/DayScheduleEntry"}}}},"DateScheduleEntry":{"type":"object","properties":{"date":{"type":"string","format":"date"},"dayOfWeek":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"enabled":{"type":"boolean"},"openTime":{"$ref":"#/components/schemas/LocalTime"},"closeTime":{"$ref":"#/components/schemas/LocalTime"},"blockedSlots":{"type":"array","items":{"$ref":"#/components/schemas/LocalTime"}},"override":{"type":"boolean"}}},"FulfillmentScheduleResponse":{"type":"object","properties":{"slotDurationMinutes":{"type":"integer","format":"int32"},"daysAhead":{"type":"integer","format":"int32"},"days":{"type":"array","items":{"$ref":"#/components/schemas/DayScheduleEntry"}},"dateOverrides":{"type":"array","items":{"$ref":"#/components/schemas/DateScheduleEntry"}}}},"UpdateDayScheduleRequest":{"required":["applyScope","date","enabled"],"type":"object","properties":{"date":{"type":"string","format":"date"},"enabled":{"type":"boolean"},"openTime":{"$ref":"#/components/schemas/LocalTime"},"closeTime":{"$ref":"#/components/schemas/LocalTime"},"applyScope":{"type":"string","enum":["THIS_DATE","WEEKDAY_TEMPLATE","DATE_RANGE"]},"endDate":{"type":"string","format":"date"},"blockedSlots":{"type":"array","items":{"$ref":"#/components/schemas/LocalTime"}}}},"CreateCostItemRequest":{"required":["name","purchasePrice","purchaseQuantity","type","unit"],"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["RAW","BAGS","STICKERS","PACKAGE","LABOR"]},"unit":{"type":"string","enum":["KG","GRAM","LITER","ML","UNIT","HOUR","MINUTE"]},"purchaseQuantity":{"type":"number"},"purchasePrice":{"type":"number"},"active":{"type":"boolean"},"packageTypeId":{"type":"integer","format":"int64"},"allergenLabel":{"type":"string"},"adminDescription":{"type":"string"}}},"CostItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string","enum":["RAW","BAGS","STICKERS","PACKAGE","LABOR"]},"unit":{"type":"string","enum":["KG","GRAM","LITER","ML","UNIT","HOUR","MINUTE"]},"purchaseQuantity":{"type":"number"},"purchasePrice":{"type":"number"},"unitCost":{"type":"number"},"active":{"type":"boolean"},"usageCount":{"type":"integer","format":"int64"},"packageTypeId":{"type":"integer","format":"int64"},"allergenLabel":{"type":"string"},"adminDescription":{"type":"string"}}},"UpdateClearingFeeSettingsRequest":{"required":["basePercentRate","bitSurchargePercent","fixedFeePerTransaction","monthlySubscriptionFee","payboxSurchargePercent"],"type":"object","properties":{"monthlySubscriptionFee":{"minimum":0,"exclusiveMinimum":false,"type":"number"},"basePercentRate":{"minimum":0,"exclusiveMinimum":false,"type":"number"},"bitSurchargePercent":{"minimum":0,"exclusiveMinimum":false,"type":"number"},"payboxSurchargePercent":{"minimum":0,"exclusiveMinimum":false,"type":"number"},"fixedFeePerTransaction":{"minimum":0,"exclusiveMinimum":false,"type":"number"}}},"ClearingFeeSettingsResponse":{"type":"object","properties":{"monthlySubscriptionFee":{"type":"number"},"basePercentRate":{"type":"number"},"bitSurchargePercent":{"type":"number"},"payboxSurchargePercent":{"type":"number"},"fixedFeePerTransaction":{"type":"number"}}},"RecipeLineRequest":{"required":["batchYield","costItemId","quantityPerUnit"],"type":"object","properties":{"costItemId":{"type":"integer","format":"int64"},"quantityPerUnit":{"type":"number"},"batchYield":{"type":"number"}}},"ReplaceProductRecipeRequest":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/RecipeLineRequest"}}}},"ProductRecipeItemResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"costItemId":{"type":"integer","format":"int64"},"costItemName":{"type":"string"},"costItemType":{"type":"string","enum":["RAW","BAGS","STICKERS","PACKAGE","LABOR"]},"unit":{"type":"string","enum":["KG","GRAM","LITER","ML","UNIT","HOUR","MINUTE"]},"quantityPerUnit":{"type":"number"},"batchYield":{"type":"number"},"unitCost":{"type":"number"},"lineCost":{"type":"number"}}},"ProductRecipeResponse":{"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductRecipeItemResponse"}},"perUnitTotalCost":{"type":"number"}}},"CreateProductRequest":{"required":["categoryId","name"],"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"descriptionHeader":{"type":"string"},"descriptionContent":{"type":"string"},"allergyContainsExtra":{"type":"string"},"allergyMayContain":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"images":{"type":"array","items":{"$ref":"#/components/schemas/ProductImageRequest"}},"weekly":{"type":"boolean"},"spotted":{"type":"boolean"},"glutenFree":{"type":"boolean"},"alsoGlutenFree":{"type":"boolean"},"vegan":{"type":"boolean"},"kosher":{"type":"boolean"},"preparationTimeMinutes":{"type":"integer","format":"int32"},"categoryId":{"type":"integer","format":"int64"},"customTags":{"type":"array","items":{"type":"string"}}}},"ProductImageRequest":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"main":{"type":"boolean"}}},"ProductImageResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"main":{"type":"boolean"}}},"ProductResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"description":{"type":"string"},"descriptionHeader":{"type":"string"},"descriptionContent":{"type":"string"},"allergyContains":{"type":"string"},"allergyContainsDerived":{"type":"array","items":{"type":"string"}},"allergyContainsExtra":{"type":"string"},"allergyMayContain":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"glutenFree":{"type":"boolean"},"alsoGlutenFree":{"type":"boolean"},"vegan":{"type":"boolean"},"kosher":{"type":"boolean"},"preparationTimeMinutes":{"type":"integer","format":"int32"},"images":{"type":"array","items":{"$ref":"#/components/schemas/ProductImageResponse"}},"categoryId":{"type":"integer","format":"int64"},"categoryName":{"type":"string"},"active":{"type":"boolean"},"weekly":{"type":"boolean"},"spotted":{"type":"boolean"},"startingFromPrice":{"type":"number"},"orderable":{"type":"boolean"},"customTags":{"type":"array","items":{"type":"string"}}}},"CreateCategoryRequest":{"required":["name"],"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"displayOrder":{"type":"integer","format":"int32"}}},"CategoryResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"description":{"type":"string"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"displayOrder":{"type":"integer","format":"int32"},"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}}}},"PaymentLinkResponse":{"type":"object","properties":{"paymentUrl":{"type":"string"},"orderId":{"type":"integer","format":"int64"},"error":{"type":"string"}}},"PaymentConfirmResponse":{"type":"object","properties":{"orderId":{"type":"integer","format":"int64"},"status":{"type":"string"}}},"CreateOrderRequest":{"required":["customerName","phoneNumber"],"type":"object","properties":{"phoneNumber":{"type":"string"},"customerName":{"type":"string"},"deliveryAddress":{"type":"string"},"notes":{"type":"string"},"delivery":{"type":"boolean"},"requestedTime":{"type":"string","format":"date-time"}}},"AddToCartRequest":{"required":["productPackageId"],"type":"object","properties":{"productPackageId":{"type":"integer","format":"int64"},"quantity":{"minimum":1,"type":"integer","format":"int32"},"notes":{"type":"string"}}},"CreateAdminOrderRequest":{"type":"object","properties":{"userId":{"type":"integer","format":"int64"}}},"AddAdminOrderDraftItemRequest":{"required":["productPackageId"],"type":"object","properties":{"productPackageId":{"type":"integer","format":"int64"},"quantity":{"minimum":1,"type":"integer","format":"int32"},"notes":{"type":"string"}}},"AddAdminRequest":{"required":["email"],"type":"object","properties":{"email":{"type":"string"}}},"AvailabilityDateOption":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}}},"AvailabilityTimeSlot":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}}},"FulfillmentAvailabilityResponse":{"type":"object","properties":{"slotDurationMinutes":{"type":"integer","format":"int32"},"dates":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilityDateOption"}},"slotsByDate":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilityTimeSlot"}}}}},"ProductPackageOfferingResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"productDescription":{"type":"string"},"productImageUrl":{"type":"string"},"productImageFileId":{"type":"string","format":"uuid"},"glutenFree":{"type":"boolean"},"weekly":{"type":"boolean"},"packageTypeId":{"type":"integer","format":"int64"},"packageTypeName":{"type":"string"},"unitCount":{"type":"integer","format":"int32"},"price":{"type":"number"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"},"available":{"type":"integer","format":"int32"},"minOrderQuantity":{"type":"integer","format":"int32"},"maxOrderQuantity":{"type":"integer","format":"int32"}}},"ProductOfTheDayResponse":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/ProductResponse"},"pinned":{"type":"boolean"}}},"PackageTypeResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"displayOrder":{"type":"integer","format":"int32"},"active":{"type":"boolean"},"imageUrl":{"type":"string"},"imageFileId":{"type":"string","format":"uuid"}}},"CartValidationItemResponse":{"type":"object","properties":{"cartItemId":{"type":"integer","format":"int64"},"productPackageId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"packageTypeName":{"type":"string"},"requestedQuantity":{"type":"integer","format":"int32"},"availableQuantity":{"type":"integer","format":"int32"},"status":{"type":"string","enum":["OK","PARTIAL","UNAVAILABLE"]}}},"CartValidationResponse":{"type":"object","properties":{"canProceed":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/CartValidationItemResponse"}},"summary":{"$ref":"#/components/schemas/CartValidationSummaryResponse"}}},"CartValidationSummaryResponse":{"type":"object","properties":{"okCount":{"type":"integer","format":"int32"},"issueCount":{"type":"integer","format":"int32"},"allUnavailable":{"type":"boolean"}}},"UsageUserRowResponse":{"type":"object","properties":{"userId":{"type":"integer","format":"int64"},"displayName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"provider":{"type":"string"},"profileImageUrl":{"type":"string"},"accessCount":{"type":"integer","format":"int64"},"lastAccessAt":{"type":"string"},"createdAt":{"type":"string"}}},"UsageTimeseriesPointResponse":{"type":"object","properties":{"date":{"type":"string","format":"date"},"uniqueUsers":{"type":"integer","format":"int64"},"accessEvents":{"type":"integer","format":"int64"}}},"UsageSummaryResponse":{"type":"object","properties":{"uniqueUsers":{"type":"integer","format":"int64"},"accessEvents":{"type":"integer","format":"int64"},"newUsers":{"type":"integer","format":"int64"}}},"UsageAccessEventResponse":{"type":"object","properties":{"eventId":{"type":"integer","format":"int64"},"occurredAt":{"type":"string"},"userId":{"type":"integer","format":"int64"},"displayName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"provider":{"type":"string"},"profileImageUrl":{"type":"string"},"clientHint":{"type":"string"}}},"ProfitTimeseriesPointResponse":{"type":"object","properties":{"periodStart":{"type":"string","format":"date"},"revenue":{"type":"number"},"cost":{"type":"number"},"profit":{"type":"number"},"orderCount":{"type":"integer","format":"int64"}}},"ProfitSummaryResponse":{"type":"object","properties":{"revenue":{"type":"number"},"cost":{"type":"number"},"profit":{"type":"number"},"marginPercent":{"type":"number"},"orderCount":{"type":"integer","format":"int64"},"itemCount":{"type":"integer","format":"int64"},"costRaw":{"type":"number"},"costBags":{"type":"number"},"costStickers":{"type":"number"},"costPackage":{"type":"number"},"costLabor":{"type":"number"},"costClearingTxn":{"type":"number"},"costMonthlyClearing":{"type":"number"},"costClearing":{"type":"number"}}},"ProductProfitRowResponse":{"type":"object","properties":{"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"quantitySold":{"type":"integer","format":"int64"},"revenue":{"type":"number"},"cost":{"type":"number"},"profit":{"type":"number"},"marginPercent":{"type":"number"}}},"PackageProfitRowResponse":{"type":"object","properties":{"productPackageId":{"type":"integer","format":"int64"},"productId":{"type":"integer","format":"int64"},"productName":{"type":"string"},"packageTypeName":{"type":"string"},"quantitySold":{"type":"integer","format":"int64"},"revenue":{"type":"number"},"cost":{"type":"number"},"profit":{"type":"number"},"marginPercent":{"type":"number"}}},"Pageable":{"type":"object","properties":{"page":{"minimum":0,"type":"integer","format":"int32"},"size":{"minimum":1,"type":"integer","format":"int32"},"sort":{"type":"array","items":{"type":"string"}}}},"PageOrderResponse":{"type":"object","properties":{"totalPages":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"pageable":{"$ref":"#/components/schemas/PageableObject"},"first":{"type":"boolean"},"last":{"type":"boolean"},"numberOfElements":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"content":{"type":"array","items":{"$ref":"#/components/schemas/OrderResponse"}},"number":{"type":"integer","format":"int32"},"sort":{"type":"array","items":{"$ref":"#/components/schemas/SortObject"}},"empty":{"type":"boolean"}}},"PageableObject":{"type":"object","properties":{"paged":{"type":"boolean"},"unpaged":{"type":"boolean"},"pageNumber":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"offset":{"type":"integer","format":"int64"},"sort":{"type":"array","items":{"$ref":"#/components/schemas/SortObject"}}}},"SortObject":{"type":"object","properties":{"direction":{"type":"string"},"nullHandling":{"type":"string"},"ascending":{"type":"boolean"},"property":{"type":"string"},"ignoreCase":{"type":"boolean"}}}},"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 Authorization Code with PKCE (Keycloak). See https://cookiesun.com/auth.md","flows":{"authorizationCode":{"authorizationUrl":"https://devozs.com/auth/realms/cookiesun/protocol/openid-connect/auth","tokenUrl":"https://devozs.com/auth/realms/cookiesun/protocol/openid-connect/token","scopes":{"catalog:read":"Read the public catalog","cart:write":"Modify the cart","orders:write":"Create and manage orders"}}}}}}}