{
  "openapi": "3.0.3",
  "info": {
    "title": "ZiadaPOS API",
    "version": "1.0.0",
    "description": "OpenAPI route contract for the registered ZiadaPOS API. It lists every registered method and path. Use the linked domain guides for complete request fields, response schemas, validation rules, and permissions. Default local origin is http://localhost:8080 and the default API_BASE_PATH is /api/v1.",
    "contact": {
      "name": "ZiadaPOS API source",
      "url": "https://github.com/Camel-Creatives/ZiadaPOS-GO-API"
    }
  },
  "servers": [
    {
      "url": "{protocol}://{host}",
      "description": "Choose the API host for Try it out. The default local API base path is /api/v1.",
      "variables": {
        "protocol": {
          "default": "http",
          "enum": [
            "http",
            "https"
          ],
          "description": "Use https for remote deployments."
        },
        "host": {
          "default": "localhost:8080",
          "description": "API hostname and optional port, without a path."
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Accounts and authentication",
      "description": "Accounts and authentication routes."
    },
    {
      "name": "Platform administration",
      "description": "Platform administration routes."
    },
    {
      "name": "AI conversations",
      "description": "AI conversations routes."
    },
    {
      "name": "Analytics",
      "description": "Analytics routes."
    },
    {
      "name": "Credit tabs",
      "description": "Credit tabs routes."
    },
    {
      "name": "Customers",
      "description": "Customers routes."
    },
    {
      "name": "Expenses",
      "description": "Expenses routes."
    },
    {
      "name": "Inventory",
      "description": "Inventory routes."
    },
    {
      "name": "Notebook",
      "description": "Notebook routes."
    },
    {
      "name": "Notifications",
      "description": "Notifications routes."
    },
    {
      "name": "Pharmacy",
      "description": "Pharmacy routes."
    },
    {
      "name": "Reports",
      "description": "Reports routes."
    },
    {
      "name": "Reviews",
      "description": "Reviews routes."
    },
    {
      "name": "Staff",
      "description": "Staff routes."
    },
    {
      "name": "Stores",
      "description": "Stores routes."
    },
    {
      "name": "Subscriptions",
      "description": "Subscriptions routes."
    },
    {
      "name": "Suppliers",
      "description": "Suppliers routes."
    },
    {
      "name": "Point of sale",
      "description": "Point of sale routes."
    },
    {
      "name": "Uploads",
      "description": "Uploads routes."
    },
    {
      "name": "System",
      "description": "System routes."
    }
  ],
  "paths": {
    "/api/v1/auth/register": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Register",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_register",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/otp/send": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Send OTP",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "phone": "0712345678",
                "purpose": "registration"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_otp_send",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/otp/verify": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Verify OTP",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "phone": "0712345678",
                "purpose": "registration",
                "code": "123456"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_otp_verify",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/login": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Login",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "identifier": "0712345678",
                "password": "<password>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_login",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/mfa/totp/verify": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Verify Admin TOTP",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_mfa_totp_verify",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/refresh": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Refresh",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "refresh_token": "<refresh-token>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_refresh",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/confirm-email": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Confirm Email",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Email verification token"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_auth_confirm_email",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/password/forgot": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Password Forgot",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "identifier": "0712345678"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_password_forgot",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/auth/password/reset": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Password Reset",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "identifier": "0712345678",
                "otp": "123456",
                "new_password": "<new-password>",
                "confirm_password": "<new-password>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_password_reset",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/accounts/mfa/totp/status": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Admin TOTPStatus",
        "description": "Access: Admin + MFA. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_mfa_totp_status",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/accounts/mfa/totp/setup": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Begin Admin TOTPSetup",
        "description": "Access: Admin + MFA. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_accounts_mfa_totp_setup",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/accounts/mfa/totp/verify": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Verify Admin TOTPSetup",
        "description": "Access: Admin + MFA. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_accounts_mfa_totp_verify",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/accounts/mfa/totp/disable": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Disable Admin TOTP",
        "description": "Access: Admin + MFA. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_accounts_mfa_totp_disable",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/auth/logout": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Logout",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_logout",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/auth/resend-confirmation": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Auth H Resend Confirmation",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_auth_resend_confirmation",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/accounts/me": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Acc H Me",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_me",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Acc H Update Me",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_patch_api_v1_accounts_me",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/accounts/organisation": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_organisation",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "patch": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_patch_api_v1_accounts_organisation",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/accounts/switch-store": {
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Acc H Switch Store",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "store_id": "<store-uuid>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_accounts_switch_store",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/accounts/users": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_users",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "post": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_post_api_v1_accounts_users",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/accounts/users/{id}": {
      "delete": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_delete_api_v1_accounts_users_id",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/accounts/ai-credits": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Acc H AICredits",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_ai_credits",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/accounts/sms-balance": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "Acc H Sm SBalance",
        "description": "Access: Bearer token. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_accounts_sms_balance",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/meta/business-types": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "GET Business-Types",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_meta_business_types",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/meta/regions": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "GET Regions",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_meta_regions",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/meta/regions/{slug}/districts": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "GET Districts",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "slug identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_meta_regions_slug_districts",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/meta/outlet-types": {
      "get": {
        "tags": [
          "Accounts and authentication"
        ],
        "summary": "GET Outlet-Types",
        "description": "Access: Public. Registered route in apps/accounts/routes.go. See the [Accounts and authentication integration guide](/rest-api/auth) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "accounts_and_authentication_get_api_v1_meta_outlet_types",
        "externalDocs": {
          "description": "Accounts and authentication integration guide",
          "url": "/rest-api/auth"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/admin/dashboard": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Dashboard",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_dashboard",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/organisations": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Organisations",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_organisations",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/organisations/{id}": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Organisation",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_organisations_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update Organisation",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_organisations_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/organisations/{id}/stores": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Organisation Stores",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_organisations_id_stores",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/organisations/{id}/users": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Organisation Users",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_organisations_id_users",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/users": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Users",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_users",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/users/{id}": {
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update User",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_users_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/stores": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Stores",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_stores",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/stores/{id}": {
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update Store",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_stores_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/products": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Products",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_products",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/products/{id}": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Product",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_products_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update Product",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_products_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/categories": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Categories",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_categories",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "post": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Create Category",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_post_api_v1_admin_categories",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/categories/{id}": {
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update Category",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_categories_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "delete": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Delete Category",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_delete_api_v1_admin_categories_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/transactions": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Transactions",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_transactions",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/transactions/{id}": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Transaction",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_transactions_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/transactions/summary": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Transaction Summary",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_transactions_summary",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/customers": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Customers",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_customers",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/credits": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Credits",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_credits",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/suppliers": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Suppliers",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_suppliers",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/suppliers/{id}/deliveries": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Supplier Deliveries",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_suppliers_id_deliveries",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/suppliers/{id}/payments": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Supplier Payments",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_suppliers_id_payments",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/expenses": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Expenses",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_expenses",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/reviews": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Reviews",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_reviews",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/reviews/{id}": {
      "patch": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Update Review",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_patch_api_v1_admin_reviews_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "delete": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Delete Review",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_delete_api_v1_admin_reviews_id",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/notes": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Notes",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_notes",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/notifications": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Notifications",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_notifications",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/ai/usage": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "AIUsage",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_ai_usage",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/subscriptions": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Subscriptions",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_subscriptions",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/analytics/overview": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Analytics Overview",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_analytics_overview",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/monitoring/overview": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Monitoring Overview",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_monitoring_overview",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/monitoring/activity": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Monitoring Activity",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_monitoring_activity",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/admin/monitoring/health": {
      "get": {
        "tags": [
          "Platform administration"
        ],
        "summary": "Monitoring Health",
        "description": "Access: Admin + MFA. Registered route in apps/admin/routes.go. See the [Platform administration integration guide](/rest-api/admin) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "platform_administration_get_api_v1_admin_monitoring_health",
        "externalDocs": {
          "description": "Platform administration integration guide",
          "url": "/rest-api/admin"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/ai/chat": {
      "post": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Start Chat",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_post_api_v1_ai_chat",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/ai/conversations/{id}/chat": {
      "post": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Continue Chat",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_post_api_v1_ai_conversations_id_chat",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/ai/conversations": {
      "get": {
        "tags": [
          "AI conversations"
        ],
        "summary": "List Conversations",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_get_api_v1_ai_conversations",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/ai/conversations/{id}": {
      "get": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Get Conversations",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_get_api_v1_ai_conversations_id",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Update Conversations",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_patch_api_v1_ai_conversations_id",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/ai/suggestions": {
      "get": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Suggestions",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_get_api_v1_ai_suggestions",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/ai/usage": {
      "get": {
        "tags": [
          "AI conversations"
        ],
        "summary": "Usage",
        "description": "Access: Bearer token. Registered route in apps/ai/routes.go. See the [AI conversations integration guide](/rest-api/ai) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "ai_conversations_get_api_v1_ai_usage",
        "externalDocs": {
          "description": "AI conversations integration guide",
          "url": "/rest-api/ai"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/analytics/overview": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Overview",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_overview",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/summary": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Summary",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_summary",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/trend": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Trend",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_trend",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/payment-mix": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Payment Mix",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_payment_mix",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/top-products": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Top Products",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_top_products",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/sales": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Sales",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_sales",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/products": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Products",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_products",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/customers": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Customers",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_customers",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/cashflow": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Cashflow",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_cashflow",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/dashboard": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Dashboard",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_dashboard",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/analytics/detail/{section}": {
      "get": {
        "tags": [
          "Analytics"
        ],
        "summary": "Detail",
        "description": "Access: Owner or admin. Registered route in apps/analytics/routes.go. See the [Analytics integration guide](/rest-api/analytics) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "section",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "section identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "analytics_get_api_v1_analytics_detail_section",
        "externalDocs": {
          "description": "Analytics integration guide",
          "url": "/rest-api/analytics"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/credits": {
      "get": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "List Credits",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_get_api_v1_credits",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/customers/{customer_id}": {
      "get": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Profile",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "customer_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_get_api_v1_credits_customers_customer_id",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/customers/{customer_id}/payments": {
      "post": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Pay",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "customer_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "amount": 5000,
                "method": "Cash",
                "note": "Part payment"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_post_api_v1_credits_customers_customer_id_payments",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/customers/{customer_id}/remind": {
      "post": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Send Reminder",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "customer_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_post_api_v1_credits_customers_customer_id_remind",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/customers/{customer_id}/messages": {
      "post": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Add Message",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "customer_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "kind": "whatsapp",
                "body": "Payment reminder sent"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_post_api_v1_credits_customers_customer_id_messages",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/customers/{customer_id}/notes": {
      "post": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Add Note",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "customer_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_post_api_v1_credits_customers_customer_id_notes",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/credits/{tab_id}/write-off": {
      "post": {
        "tags": [
          "Credit tabs"
        ],
        "summary": "Write Off",
        "description": "Access: Bearer token. Registered route in apps/credits/routes.go. See the [Credit tabs integration guide](/rest-api/credits) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "tab_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "tab_id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "credit_tabs_post_api_v1_credits_tab_id_write_off",
        "externalDocs": {
          "description": "Credit tabs integration guide",
          "url": "/rest-api/credits"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/customers": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List Customers",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_get_api_v1_customers",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Create Customers",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "name": "Asha Mushi",
                "phone": "0712345678",
                "email": "asha@example.test",
                "segment": "Regular"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_post_api_v1_customers",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/customers/credits": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Credit Customers",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_get_api_v1_customers_credits",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/customers/{id}": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get Customers",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_get_api_v1_customers_id",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Customers"
        ],
        "summary": "Update Customers",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_patch_api_v1_customers_id",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/customers/{id}/sms": {
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Send Sms",
        "description": "Access: Bearer token. Registered route in apps/customers/routes.go. See the [Customers integration guide](/rest-api/customers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "customers_post_api_v1_customers_id_sms",
        "externalDocs": {
          "description": "Customers integration guide",
          "url": "/rest-api/customers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/expenses/categories": {
      "get": {
        "tags": [
          "Expenses"
        ],
        "summary": "Categories",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_get_api_v1_expenses_categories",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Expenses"
        ],
        "summary": "Create Category",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_post_api_v1_expenses_categories",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/expenses/categories/{id}": {
      "patch": {
        "tags": [
          "Expenses"
        ],
        "summary": "Update Category",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_patch_api_v1_expenses_categories_id",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Expenses"
        ],
        "summary": "Delete Category",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_delete_api_v1_expenses_categories_id",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/expenses": {
      "get": {
        "tags": [
          "Expenses"
        ],
        "summary": "List Expenses",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_get_api_v1_expenses",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Expenses"
        ],
        "summary": "Create Expenses",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "title": "Transport",
                "amount": 12000,
                "category": "Operations",
                "payment_method": "Cash",
                "notes": "Supplier visit"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_post_api_v1_expenses",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/expenses/summary": {
      "get": {
        "tags": [
          "Expenses"
        ],
        "summary": "Summary",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_get_api_v1_expenses_summary",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/expenses/{id}": {
      "get": {
        "tags": [
          "Expenses"
        ],
        "summary": "Get Expenses",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_get_api_v1_expenses_id",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Expenses"
        ],
        "summary": "Update Expenses",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_patch_api_v1_expenses_id",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Expenses"
        ],
        "summary": "Delete Expenses",
        "description": "Access: Bearer token. Registered route in apps/expenses/routes.go. See the [Expenses integration guide](/rest-api/expenses) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "expenses_delete_api_v1_expenses_id",
        "externalDocs": {
          "description": "Expenses integration guide",
          "url": "/rest-api/expenses"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/categories": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List Categories",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_categories",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Create Category",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_categories",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/categories/{id}": {
      "patch": {
        "tags": [
          "Inventory"
        ],
        "summary": "Update Category",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_patch_api_v1_inventory_categories_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Inventory"
        ],
        "summary": "Delete Category",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_delete_api_v1_inventory_categories_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/units": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List Units",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_units",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Create Unit",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_units",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/units/{id}": {
      "patch": {
        "tags": [
          "Inventory"
        ],
        "summary": "Update Unit",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_patch_api_v1_inventory_units_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Inventory"
        ],
        "summary": "Delete Unit",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_delete_api_v1_inventory_units_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List Products",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_products",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Create Product",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "name": "Maji 500ml",
                "selling_price": 1000,
                "cost_price": 700,
                "stock": 24,
                "reorder_point": 6,
                "is_active": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_products",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/import": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Import",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_import",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products/{id}": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Get Product",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_products_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Inventory"
        ],
        "summary": "Update Product",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_patch_api_v1_inventory_products_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Inventory"
        ],
        "summary": "Delete Product",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_delete_api_v1_inventory_products_id",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products/barcode/{code}": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "By Barcode",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "code identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_products_barcode_code",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products/{id}/adjust": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Adjust Stock",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_products_id_adjust",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products/{id}/adjustments": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Adjustments",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_products_id_adjustments",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/batches": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List Batches",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_batches",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/products/{id}/batches": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Receive Batch",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_post_api_v1_inventory_products_id_batches",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/inventory/low-stock": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Low Stock",
        "description": "Access: Bearer token. Registered route in apps/inventory/routes.go. See the [Inventory integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "inventory_get_api_v1_inventory_low_stock",
        "externalDocs": {
          "description": "Inventory integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notebook": {
      "get": {
        "tags": [
          "Notebook"
        ],
        "summary": "List Notebook",
        "description": "Access: Bearer token. Registered route in apps/notebook/routes.go. See the [Notebook integration guide](/rest-api/notebook) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notebook_get_api_v1_notebook",
        "externalDocs": {
          "description": "Notebook integration guide",
          "url": "/rest-api/notebook"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Notebook"
        ],
        "summary": "Create Notebook",
        "description": "Access: Bearer token. Registered route in apps/notebook/routes.go. See the [Notebook integration guide](/rest-api/notebook) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notebook_post_api_v1_notebook",
        "externalDocs": {
          "description": "Notebook integration guide",
          "url": "/rest-api/notebook"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notebook/{id}": {
      "get": {
        "tags": [
          "Notebook"
        ],
        "summary": "Get Notebook",
        "description": "Access: Bearer token. Registered route in apps/notebook/routes.go. See the [Notebook integration guide](/rest-api/notebook) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notebook_get_api_v1_notebook_id",
        "externalDocs": {
          "description": "Notebook integration guide",
          "url": "/rest-api/notebook"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Notebook"
        ],
        "summary": "Update Notebook",
        "description": "Access: Bearer token. Registered route in apps/notebook/routes.go. See the [Notebook integration guide](/rest-api/notebook) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notebook_patch_api_v1_notebook_id",
        "externalDocs": {
          "description": "Notebook integration guide",
          "url": "/rest-api/notebook"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Notebook"
        ],
        "summary": "Delete Notebook",
        "description": "Access: Bearer token. Registered route in apps/notebook/routes.go. See the [Notebook integration guide](/rest-api/notebook) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notebook_delete_api_v1_notebook_id",
        "externalDocs": {
          "description": "Notebook integration guide",
          "url": "/rest-api/notebook"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notifications": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "List Notifications",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_get_api_v1_notifications",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Notifications"
        ],
        "summary": "Create Notifications",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_post_api_v1_notifications",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notifications/unread-count": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "Unread Count",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_get_api_v1_notifications_unread_count",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notifications/{id}": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "Get Notifications",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_get_api_v1_notifications_id",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Notifications"
        ],
        "summary": "Delete Notifications",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_delete_api_v1_notifications_id",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notifications/read-all": {
      "patch": {
        "tags": [
          "Notifications"
        ],
        "summary": "Mark All Read",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_patch_api_v1_notifications_read_all",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/notifications/{id}/read": {
      "patch": {
        "tags": [
          "Notifications"
        ],
        "summary": "Mark Read",
        "description": "Access: Bearer token. Registered route in apps/notifications/routes.go. See the [Notifications integration guide](/rest-api/notifications) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "notifications_patch_api_v1_notifications_id_read",
        "externalDocs": {
          "description": "Notifications integration guide",
          "url": "/rest-api/notifications"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/batches": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "GET Batches",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_batches",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/batches/{id}/movements": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "GET Movements",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_batches_id_movements",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/batches/{id}/dispose": {
      "post": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_post_api_v1_pharmacy_batches_id_dispose",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/pharmacy/batches/{id}/release": {
      "post": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_post_api_v1_pharmacy_batches_id_release",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/pharmacy/products/{id}/batches": {
      "post": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "POST Batches",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_post_api_v1_pharmacy_products_id_batches",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/expiry": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "GET Expiry",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_expiry",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/prescriptions": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "Require Prescription Register Access(deps DB",
        "description": "Access: Pharmacy personnel. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_prescriptions",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Pharmacy personnel"
      }
    },
    "/api/v1/pharmacy/products": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "GET Products",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_products",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pharmacy/products/{id}": {
      "get": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "GET Products",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_get_api_v1_pharmacy_products_id",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "put": {
        "tags": [
          "Pharmacy"
        ],
        "summary": "PUT Products",
        "description": "Access: Bearer token. Registered route in apps/pharmacy/routes.go. See the [Pharmacy integration guide](/rest-api/inventory) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "pharmacy_put_api_v1_pharmacy_products_id",
        "externalDocs": {
          "description": "Pharmacy integration guide",
          "url": "/rest-api/inventory"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/reports/types": {
      "get": {
        "tags": [
          "Reports"
        ],
        "summary": "Report Types",
        "description": "Access: Bearer token. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_get_api_v1_reports_types",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/reports/generate": {
      "post": {
        "tags": [
          "Reports"
        ],
        "summary": "Generate",
        "description": "Access: Bearer token. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "report_type": "sales",
                "range": "7d",
                "format": "json"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_post_api_v1_reports_generate",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/reports/exports": {
      "get": {
        "tags": [
          "Reports"
        ],
        "summary": "Exports",
        "description": "Access: Bearer token. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_get_api_v1_reports_exports",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/reports/exports/{id}/download": {
      "get": {
        "tags": [
          "Reports"
        ],
        "summary": "Download Export",
        "description": "Access: Bearer token. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_get_api_v1_reports_exports_id_download",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/reports/scheduled": {
      "get": {
        "tags": [
          "Reports"
        ],
        "summary": "List Scheduled",
        "description": "Access: Owner or admin. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_get_api_v1_reports_scheduled",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "post": {
        "tags": [
          "Reports"
        ],
        "summary": "Create Scheduled",
        "description": "Access: Owner or admin. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_post_api_v1_reports_scheduled",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/reports/scheduled/{id}": {
      "patch": {
        "tags": [
          "Reports"
        ],
        "summary": "Update Scheduled",
        "description": "Access: Owner or admin. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_patch_api_v1_reports_scheduled_id",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "delete": {
        "tags": [
          "Reports"
        ],
        "summary": "Delete Scheduled",
        "description": "Access: Owner or admin. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_delete_api_v1_reports_scheduled_id",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/reports/scheduled/{id}/send": {
      "post": {
        "tags": [
          "Reports"
        ],
        "summary": "Send Scheduled",
        "description": "Access: Owner or admin. Registered route in apps/reports/routes.go. See the [Reports integration guide](/rest-api/reports) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reports_post_api_v1_reports_scheduled_id_send",
        "externalDocs": {
          "description": "Reports integration guide",
          "url": "/rest-api/reports"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/reviews/public": {
      "get": {
        "tags": [
          "Reviews"
        ],
        "summary": "Public",
        "description": "Access: Public. Registered route in apps/reviews/routes.go. See the [Reviews integration guide](/rest-api/reviews) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reviews_get_api_v1_reviews_public",
        "externalDocs": {
          "description": "Reviews integration guide",
          "url": "/rest-api/reviews"
        },
        "x-ziadapos-access": "Public"
      }
    },
    "/api/v1/reviews": {
      "post": {
        "tags": [
          "Reviews"
        ],
        "summary": "Submit",
        "description": "Access: Bearer token. Registered route in apps/reviews/routes.go. See the [Reviews integration guide](/rest-api/reviews) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "reviews_post_api_v1_reviews",
        "externalDocs": {
          "description": "Reviews integration guide",
          "url": "/rest-api/reviews"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/staff": {
      "get": {
        "tags": [
          "Staff"
        ],
        "summary": "List Staff",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_get_api_v1_staff",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "post": {
        "tags": [
          "Staff"
        ],
        "summary": "Create Staff",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_post_api_v1_staff",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/kpis": {
      "get": {
        "tags": [
          "Staff"
        ],
        "summary": "KPIs",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_get_api_v1_staff_kpis",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/{id}": {
      "get": {
        "tags": [
          "Staff"
        ],
        "summary": "Get Staff",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_get_api_v1_staff_id",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "patch": {
        "tags": [
          "Staff"
        ],
        "summary": "Update Staff",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_patch_api_v1_staff_id",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "delete": {
        "tags": [
          "Staff"
        ],
        "summary": "Deactivate",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_delete_api_v1_staff_id",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/{id}/stats": {
      "get": {
        "tags": [
          "Staff"
        ],
        "summary": "Stats",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_get_api_v1_staff_id_stats",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/{id}/activity": {
      "get": {
        "tags": [
          "Staff"
        ],
        "summary": "Activity",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_get_api_v1_staff_id_activity",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/{id}/shift": {
      "patch": {
        "tags": [
          "Staff"
        ],
        "summary": "Update Shift",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_patch_api_v1_staff_id_shift",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/staff/{id}/permissions": {
      "patch": {
        "tags": [
          "Staff"
        ],
        "summary": "Update Permissions",
        "description": "Access: Owner or admin. Registered route in apps/staff/routes.go. See the [Staff integration guide](/rest-api/staff) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "staff_patch_api_v1_staff_id_permissions",
        "externalDocs": {
          "description": "Staff integration guide",
          "url": "/rest-api/staff"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "List Stores",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_get_api_v1_stores",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "post": {
        "tags": [
          "Stores"
        ],
        "summary": "Create Stores",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_post_api_v1_stores",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores/stats": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Stats",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_get_api_v1_stores_stats",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores/{id}": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Get Stores",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_get_api_v1_stores_id",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "patch": {
        "tags": [
          "Stores"
        ],
        "summary": "Update Stores",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_patch_api_v1_stores_id",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      },
      "delete": {
        "tags": [
          "Stores"
        ],
        "summary": "Delete Stores",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_delete_api_v1_stores_id",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores/{id}/staff": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Staff",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_get_api_v1_stores_id_staff",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores/{id}/week": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Week",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_get_api_v1_stores_id_week",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/stores/{id}/status": {
      "patch": {
        "tags": [
          "Stores"
        ],
        "summary": "Set Status",
        "description": "Access: Owner or admin. Registered route in apps/stores/routes.go. See the [Stores integration guide](/rest-api/stores) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "stores_patch_api_v1_stores_id_status",
        "externalDocs": {
          "description": "Stores integration guide",
          "url": "/rest-api/stores"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/subscriptions/admin/plans": {
      "get": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Admin Plans",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_get_api_v1_subscriptions_admin_plans",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/plans": {
      "post": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Create Plan",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_post_api_v1_subscriptions_plans",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/plans/{id}": {
      "patch": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Update Plan",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_patch_api_v1_subscriptions_plans_id",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      },
      "delete": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Deactivate Plan",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_delete_api_v1_subscriptions_plans_id",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/all": {
      "get": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Admin List",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_get_api_v1_subscriptions_all",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/all/{id}": {
      "get": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Admin Get",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_get_api_v1_subscriptions_all_id",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/all/{id}/activate": {
      "post": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Activate",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_post_api_v1_subscriptions_all_id_activate",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/subscriptions/all/{id}/extra-stores": {
      "patch": {
        "tags": [
          "Subscriptions"
        ],
        "summary": "Extra Stores",
        "description": "Access: Admin + MFA. Registered route in apps/subscriptions/routes.go. See the [Subscriptions integration guide](/rest-api/subscriptions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "subscriptions_patch_api_v1_subscriptions_all_id_extra_stores",
        "externalDocs": {
          "description": "Subscriptions integration guide",
          "url": "/rest-api/subscriptions"
        },
        "x-ziadapos-access": "Admin + MFA"
      }
    },
    "/api/v1/suppliers": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "List Suppliers",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Create Suppliers",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/stats": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Stats",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_stats",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/purchase-orders": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Purchase Orders",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_purchase_orders",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Create Purchase Order",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_purchase_orders",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/reorder-suggestions": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Reorder Suggestions",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_reorder_suggestions",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/purchase-orders/bulk": {
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Create Purchase Orders",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_purchase_orders_bulk",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/purchase-orders/{id}/receive": {
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Receive Purchase Order",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_purchase_orders_id_receive",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/deliveries": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "All Deliveries",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_deliveries",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Create Delivery Global",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_deliveries",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/deliveries/{id}": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Get Delivery",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_deliveries_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Update Delivery",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_patch_api_v1_suppliers_deliveries_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Delete Delivery",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_delete_api_v1_suppliers_deliveries_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/deliveries/{id}/pay": {
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_deliveries_id_pay",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/suppliers/payments": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "All Payments",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_payments",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/{id}": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Get Suppliers",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "patch": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Update Suppliers",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_patch_api_v1_suppliers_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Delete Suppliers",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_delete_api_v1_suppliers_id",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/{id}/deliveries": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Deliveries",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_id_deliveries",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Deliveries",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_id_deliveries",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/{id}/payments": {
      "get": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Supplier Payments",
        "description": "Access: Bearer token. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_get_api_v1_suppliers_id_payments",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/suppliers/{id}/pay": {
      "post": {
        "tags": [
          "Suppliers"
        ],
        "summary": "Middleware Require Owner(",
        "description": "Access: Owner or admin. Registered route in apps/suppliers/routes.go. See the [Suppliers integration guide](/rest-api/suppliers) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "suppliers_post_api_v1_suppliers_id_pay",
        "externalDocs": {
          "description": "Suppliers integration guide",
          "url": "/rest-api/suppliers"
        },
        "x-ziadapos-access": "Owner or admin"
      }
    },
    "/api/v1/pos/sale": {
      "post": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Complete Sale",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              },
              "example": {
                "lines": [
                  {
                    "product_id": "<product-uuid>",
                    "qty": 2
                  }
                ],
                "payment_method": "Cash",
                "customer_id": "<customer-uuid>",
                "notes": "Counter sale"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_post_api_v1_pos_sale",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/transactions": {
      "get": {
        "tags": [
          "Point of sale"
        ],
        "summary": "List Transactions",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_get_api_v1_pos_transactions",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/transactions/{id}": {
      "get": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Get Transaction",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_get_api_v1_pos_transactions_id",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/transactions/{id}/refund": {
      "post": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Refund",
        "description": "Access: Bearer + refund permission. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": false,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_post_api_v1_pos_transactions_id_refund",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer + refund permission"
      }
    },
    "/api/v1/pos/transactions/{id}/void": {
      "post": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Void",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": false,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_post_api_v1_pos_transactions_id_void",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/transactions/{id}/receipt": {
      "post": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Email Receipt",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "id identifier"
          }
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Use the endpoint guide for the request fields and validation rules.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_post_api_v1_pos_transactions_id_receipt",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/summary": {
      "get": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Summary",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_get_api_v1_pos_summary",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/pos/summary/hourly": {
      "get": {
        "tags": [
          "Point of sale"
        ],
        "summary": "Hourly Sales",
        "description": "Access: Bearer token. Registered route in apps/transactions/routes.go. See the [Point of sale integration guide](/rest-api/transactions) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "point_of_sale_get_api_v1_pos_summary_hourly",
        "externalDocs": {
          "description": "Point of sale integration guide",
          "url": "/rest-api/transactions"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/api/v1/uploads": {
      "post": {
        "tags": [
          "Uploads"
        ],
        "summary": "POST Uploads",
        "description": "Access: Bearer token. Registered route in apps/uploads/routes.go. See the [Uploads integration guide](/rest-api/uploads) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "image"
                    ]
                  },
                  "folder": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "uploads_post_api_v1_uploads",
        "externalDocs": {
          "description": "Uploads integration guide",
          "url": "/rest-api/uploads"
        },
        "x-ziadapos-access": "Bearer token"
      },
      "delete": {
        "tags": [
          "Uploads"
        ],
        "summary": "DELETE Uploads",
        "description": "Access: Bearer token. Registered route in apps/uploads/routes.go. See the [Uploads integration guide](/rest-api/uploads) for request fields, validation, side effects, and exact response behavior.",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "uploads_delete_api_v1_uploads",
        "externalDocs": {
          "description": "Uploads integration guide",
          "url": "/rest-api/uploads"
        },
        "x-ziadapos-access": "Bearer token"
      }
    },
    "/healthz": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "Liveness",
        "description": "Access: Public (system). Registered route in internal/server/server.go. See the [System integration guide](/rest-api/health) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "system_get_healthz",
        "externalDocs": {
          "description": "System integration guide",
          "url": "/rest-api/health"
        },
        "x-ziadapos-access": "Public (system)"
      }
    },
    "/": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "Info",
        "description": "Access: Public (system). Registered route in internal/server/server.go. See the [System integration guide](/rest-api/health) for request fields, validation, side effects, and exact response behavior.",
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "system_get_root",
        "externalDocs": {
          "description": "System integration guide",
          "url": "/rest-api/health"
        },
        "x-ziadapos-access": "Public (system)"
      }
    },
    "/api/v1/health": {
      "get": {
        "tags": [
          "System"
        ],
        "summary": "Health",
        "description": "Access: Public (system). Registered route in internal/server/server.go. See the [System integration guide](/rest-api/health) for request fields, validation, side effects, and exact response behavior.",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Email verification token"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response. The endpoint guide documents exact response status and payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          },
          "default": {
            "description": "Error response. See Responses and errors in the integration guide.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseEnvelope"
                }
              }
            }
          }
        },
        "operationId": "system_get_api_v1_health",
        "externalDocs": {
          "description": "System integration guide",
          "url": "/rest-api/health"
        },
        "x-ziadapos-access": "Public (system)"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Use the access_token returned by login or OTP verification."
      }
    },
    "schemas": {
      "ResponseEnvelope": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          },
          "data": {},
          "errors": {},
          "meta": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      }
    }
  },
  "x-route-count": 222,
  "x-source-of-truth": "https://github.com/Camel-Creatives/ZiadaPOS-GO-API/tree/main/apps"
}