openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "OpenAPI definition",
    "version": "v0"
  },
  "servers": [
    {
      "url": "http://localhost:8080",
      "description": "Generated server url"
    }
  ],
  "tags": [
    {
      "name": "Produtos",
      "description": "Gerenciamento de produtos da vitrine"
    },
    {
      "name": "Usuários",
      "description": "Cadastro e consulta de lojistas"
    },
    {
      "name": "Health",
      "description": "Verificação de disponibilidade do serviço e de suas dependências (Postgres, Redis)"
    },
    {
      "name": "Tipos de produto",
      "description": "Sub-categorias de produto criadas pela propria loja (ex.: Camisa, Action Figure)"
    },
    {
      "name": "PDV",
      "description": "Ponto de venda — requer plano Premium"
    },
    {
      "name": "Localização",
      "description": "Estados e cidades brasileiras para seleção no cadastro"
    },
    {
      "name": "Admin",
      "description": "Painel administrativo — requer ROLE_ADMIN"
    },
    {
      "name": "Atributos da loja",
      "description": "Atributos customizados de cada loja"
    },
    {
      "name": "Version",
      "description": "Identifica a versão/commit em execução"
    },
    {
      "name": "Tipos de negócio",
      "description": "Segmentos de loja, usados só para tracking/analytics no cadastro"
    },
    {
      "name": "Autenticação",
      "description": "Login, renovação e encerramento de sessão"
    }
  ],
  "paths": {
    "/api/users/{id}": {
      "get": {
        "tags": [
          "Usuários"
        ],
        "summary": "Busca lojista por ID — perfil público",
        "operationId": "getById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Usuários"
        ],
        "summary": "Atualiza dados do lojista",
        "operationId": "update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/{id}": {
      "get": {
        "tags": [
          "Produtos"
        ],
        "summary": "Busca produto por ID (inclui contadores de cliques)",
        "operationId": "getById_1",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "Produtos"
        ],
        "summary": "Atualiza um produto (multipart: 'data' JSON + 'images' opcional — substitui todas as fotos)",
        "operationId": "update_1",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ProductUpdateMultipartDoc"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Produtos"
        ],
        "summary": "Remove um produto por ID",
        "operationId": "delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/products/reorder": {
      "put": {
        "tags": [
          "Produtos"
        ],
        "summary": "Reordena produtos da loja (requer autenticação)",
        "description": "Recebe uma lista de IDs de produtos na nova ordem desejada. O sortOrder de cada produto é atualizado para o índice correspondente na lista (0, 1, 2...). Todos os produtos devem pertencer à loja autenticada.",
        "operationId": "reorder",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "example": [42, 7, 15, 3]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/pdv/employees/{id}": {
      "put": {
        "tags": [
          "PDV"
        ],
        "operationId": "updateEmployee",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvEmployeeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvEmployeeResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "PDV"
        ],
        "operationId": "deactivateEmployee",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          }
        }
      }
    },
    "/api/pdv/customers/{id}": {
      "put": {
        "tags": [
          "PDV"
        ],
        "operationId": "updateCustomer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvCustomerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCustomerResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "PDV"
        ],
        "operationId": "deleteCustomer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          }
        }
      }
    },
    "/api/admin/stores/{id}/subscription": {
      "put": {
        "tags": [
          "Admin"
        ],
        "summary": "Altera plano/status/datas da assinatura de uma loja",
        "operationId": "updateSubscription",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubscriptionAdminUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AdminStoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/{id}/promo-images": {
      "post": {
        "tags": [
          "Usuários"
        ],
        "summary": "Faz upload das fotos informativas da loja (até 3 — substitui todas as existentes)",
        "operationId": "uploadPromoImages",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "promoImages": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/{id}/logo": {
      "post": {
        "tags": [
          "Usuários"
        ],
        "summary": "Faz upload do logo da loja",
        "operationId": "uploadLogo",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "logo": {
                    "type": "string",
                    "format": "binary"
                  }
                },
                "required": [
                  "logo"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/{id}/cover-image": {
      "post": {
        "tags": [
          "Usuários"
        ],
        "summary": "Faz upload da foto de capa da loja",
        "operationId": "uploadCoverImage",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "coverImage": {
                    "type": "string",
                    "format": "binary"
                  }
                },
                "required": [
                  "coverImage"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Usuários"
        ],
        "summary": "Remove a foto de capa da loja",
        "operationId": "deleteCoverImage",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/register": {
      "post": {
        "tags": [
          "Usuários"
        ],
        "summary": "Cadastra um novo lojista — retorna access token para login imediato",
        "operationId": "register",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreRegisterRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/register/affiliate": {
      "post": {
        "tags": [
          "Usuários"
        ],
        "summary": "Cadastra um lojista afiliado — profileType definido internamente como AFFILIATE",
        "operationId": "registerAffiliate",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreRegisterRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products": {
      "post": {
        "tags": [
          "Produtos"
        ],
        "summary": "Cadastra um produto com fotos (multipart: 'data' JSON + até 5 'images')",
        "operationId": "create",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ProductCreateMultipartDoc"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/{id}/whatsapp-click": {
      "post": {
        "tags": [
          "Produtos"
        ],
        "summary": "Registra clique no botão de WhatsApp e retorna total de cliques",
        "operationId": "registerWhatsappClick",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "integer",
                  "format": "int64"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/{id}/affiliate-click": {
      "post": {
        "tags": [
          "Produtos"
        ],
        "summary": "Registra clique no link de afiliado e retorna total de cliques (apenas lojas AFFILIATE)",
        "operationId": "registerAffiliateClick",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "integer",
                  "format": "int64"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/product-types": {
      "get": {
        "tags": [
          "Tipos de produto"
        ],
        "summary": "Lista os tipos de produto cadastrados pela loja",
        "operationId": "list",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductTypeResponse"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Tipos de produto"
        ],
        "summary": "Cria um tipo de produto, exclusivo dessa loja",
        "operationId": "create_1",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductTypeCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductTypeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/attributes": {
      "get": {
        "tags": [
          "Atributos da loja"
        ],
        "summary": "Lista os atributos da loja, opcionalmente escopados a um ProductType",
        "operationId": "listEffective",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "productTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AttributeDefinitionResponse"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Atributos da loja"
        ],
        "summary": "Cria um atributo customizado, exclusivo dessa loja",
        "operationId": "createCustom",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttributeDefinitionCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AttributeDefinitionResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/attributes/{attributeDefinitionId}/options": {
      "post": {
        "tags": [
          "Atributos da loja"
        ],
        "summary": "Cadastra um valor de opcao pra um atributo do tipo lista (ENUM) da propria loja",
        "operationId": "addOption",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "attributeDefinitionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttributeOptionCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AttributeDefinitionResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/sync": {
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "sync",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvSyncRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvSyncResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/sales": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "listSales",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PagePdvSaleResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "createSale",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvSaleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvSaleResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/employees": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "listEmployees",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PdvEmployeeResponse"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "createEmployee",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvEmployeeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvEmployeeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/employees/pin": {
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "verifyPin",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvPinAuthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvEmployeeResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/customers": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "listCustomers",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PdvCustomerResponse"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "createCustomer",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvCustomerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCustomerResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/customers/{id}/credits": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "listCredits",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PdvCustomerCreditResponse"
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "addCredit",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvCustomerCreditRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCustomerCreditResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/customers/{customerId}/credits/{creditId}/payments": {
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "addPayment",
        "parameters": [
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "creditId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvCreditPaymentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCreditPaymentResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/cash-flow": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "listCashFlow",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PagePdvCashFlowResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "PDV"
        ],
        "operationId": "addCashFlow",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvCashFlowRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCashFlowResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/resend-verification": {
      "post": {
        "tags": [
          "Autenticação"
        ],
        "summary": "Reenvia o link de verificação de e-mail (autenticado)",
        "operationId": "resendVerification",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/refresh": {
      "post": {
        "tags": [
          "Autenticação"
        ],
        "summary": "Renova o access token usando o refresh token do cookie httpOnly",
        "operationId": "refresh",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/RefreshResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/logout": {
      "post": {
        "tags": [
          "Autenticação"
        ],
        "summary": "Encerra a sessão — invalida o refresh token e limpa o cookie",
        "operationId": "logout",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/auth/login": {
      "post": {
        "tags": [
          "Autenticação"
        ],
        "summary": "Autentica usuário — retorna access token no body; refresh token em cookie httpOnly (apenas lojistas)",
        "operationId": "login",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/admin/stores/{id}/subscription/extend": {
      "post": {
        "tags": [
          "Admin"
        ],
        "summary": "Estende o trial de uma loja (body: { \"days\": N })",
        "operationId": "extendTrial",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": {
                  "type": "integer",
                  "format": "int32"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AdminStoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/{id}/visibility": {
      "patch": {
        "tags": [
          "Produtos"
        ],
        "summary": "Toggle de visibilidade do produto",
        "operationId": "toggleVisibility",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/{id}/featured": {
      "patch": {
        "tags": [
          "Produtos"
        ],
        "summary": "Toggle de destaque do produto (máx. 3 por loja)",
        "operationId": "toggleFeatured",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/sales/{id}/cancel": {
      "patch": {
        "tags": [
          "PDV"
        ],
        "operationId": "cancelSale",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvSaleResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/products/{id}/stock": {
      "patch": {
        "tags": [
          "PDV"
        ],
        "operationId": "adjustStock",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdvStockPatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvStockResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/admin/stores/{id}/toggle-active": {
      "patch": {
        "tags": [
          "Admin"
        ],
        "summary": "Ativa ou inativa uma loja",
        "operationId": "toggleActive",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AdminStoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/version": {
      "get": {
        "tags": [
          "Version"
        ],
        "summary": "Retorna o commit em execução e há quanto tempo a instância está de pé (público)",
        "operationId": "version",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {

                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/users/store/{slug}": {
      "get": {
        "tags": [
          "Usuários"
        ],
        "summary": "Perfil público da loja por slug. Retorna 301 se o slug for histórico.",
        "operationId": "getBySlug",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/me": {
      "get": {
        "tags": [
          "Usuários"
        ],
        "summary": "Perfil completo do lojista autenticado — usado pela própria tela de configurações",
        "operationId": "getMe",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/StoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/users/me/attributes": {
      "get": {
        "tags": [
          "Usuários"
        ],
        "summary": "Lista atributos do lojista autenticado, filtrados por tipo de produto",
        "operationId": "listMyAttributes",
        "parameters": [
          {
            "name": "productTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AttributeDefinitionResponse"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}": {
      "get": {
        "tags": [
          "Produtos"
        ],
        "summary": "Lista todos os produtos de uma loja — painel do lojista (paginado, 15/página)",
        "operationId": "listAll",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PageResponseProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/search": {
      "get": {
        "tags": [
          "Produtos"
        ],
        "summary": "Busca produtos visíveis com filtros combinados (público)",
        "operationId": "search",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/ProductFilter"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PageResponseProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/public": {
      "get": {
        "tags": [
          "Produtos"
        ],
        "summary": "Lista produtos visíveis de uma loja — vitrine pública (paginado, 15/página)",
        "operationId": "listPublic",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PageResponseProductResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/featured": {
      "get": {
        "tags": [
          "Produtos"
        ],
        "summary": "Lista produtos em destaque de uma loja (vitrine pública)",
        "operationId": "listFeatured",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductResponse"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/sales/{id}": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "getSale",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvSaleResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/pdv/cash-flow/summary": {
      "get": {
        "tags": [
          "PDV"
        ],
        "operationId": "getCashFlowSummary",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PdvCashFlowSummaryResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/locations/states": {
      "get": {
        "tags": [
          "Localização"
        ],
        "summary": "Lista todos os estados brasileiros ordenados por nome",
        "operationId": "listStates",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StateResponse"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/locations/states/{stateId}/cities": {
      "get": {
        "tags": [
          "Localização"
        ],
        "summary": "Lista cidades de um estado ordenadas por nome",
        "operationId": "listCitiesByState",
        "parameters": [
          {
            "name": "stateId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CityResponse"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "tags": [
          "Health"
        ],
        "summary": "Retorna status da aplicação e de suas dependências — Postgres e Redis (público)",
        "operationId": "health",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {

                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/business-types": {
      "get": {
        "tags": [
          "Tipos de negócio"
        ],
        "summary": "Lista todos os tipos de negócio disponíveis para o cadastro da loja",
        "operationId": "listAll_1",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BusinessTypeResponse"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/auth/verify-email": {
      "get": {
        "tags": [
          "Autenticação"
        ],
        "summary": "Verifica o e-mail do lojista via token enviado no cadastro",
        "operationId": "verifyEmail",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/admin/stores": {
      "get": {
        "tags": [
          "Admin"
        ],
        "summary": "Lista todas as lojas com filtros opcionais",
        "operationId": "listStores",
        "parameters": [
          {
            "name": "filter",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/AdminStoreFilter"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PageResponseAdminStoreResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/admin/stores/{id}": {
      "get": {
        "tags": [
          "Admin"
        ],
        "summary": "Detalhe completo de uma loja",
        "operationId": "getStore",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AdminStoreResponse"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Admin"
        ],
        "summary": "Exclui uma loja e seus dados",
        "operationId": "deleteStore",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/admin/stats": {
      "get": {
        "tags": [
          "Admin"
        ],
        "summary": "Totais da plataforma",
        "operationId": "getStats",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/PlatformStatsResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/products/store/{storeId}/product-types/{productTypeId}": {
      "delete": {
        "tags": [
          "Tipos de produto"
        ],
        "summary": "Remove um tipo de produto (bloqueado se algum produto ainda o usa)",
        "operationId": "delete_1",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "productTypeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api/products/store/{storeId}/attributes/{attributeDefinitionId}": {
      "delete": {
        "tags": [
          "Atributos da loja"
        ],
        "summary": "Remove um atributo customizado da loja (bloqueado se algum produto ainda o usa)",
        "operationId": "deleteCustom",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "attributeDefinitionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PatchFieldString": {
        "type": "object",
        "properties": {
          "present": {
            "type": "boolean"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "StoreUpdateRequest": {
        "type": "object",
        "properties": {
          "userName": {
            "type": "string",
            "maxLength": 100,
            "minLength": 2
          },
          "storeName": {
            "type": "string",
            "maxLength": 100,
            "minLength": 2
          },
          "whatsappNumber": {
            "type": "string",
            "pattern": "\\d{10,15}"
          },
          "storeDescription": {
            "type": "string",
            "maxLength": 500,
            "minLength": 0
          },
          "addressStreet": {
            "type": "string",
            "maxLength": 150,
            "minLength": 0
          },
          "addressNumber": {
            "type": "string",
            "maxLength": 20,
            "minLength": 0
          },
          "addressNeighborhood": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0
          },
          "addressZipCode": {
            "type": "string",
            "pattern": "\\d{5}-?\\d{3}"
          },
          "stateId": {
            "type": "integer",
            "format": "int64"
          },
          "cityId": {
            "type": "integer",
            "format": "int64"
          },
          "businessTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "profileType": {
            "type": "string",
            "enum": [
              "STANDARD",
              "AFFILIATE"
            ]
          },
          "storeNameFont": {
            "$ref": "#/components/schemas/PatchFieldString"
          },
          "coverColor": {
            "$ref": "#/components/schemas/PatchFieldString"
          },
          "storeTheme": {
            "$ref": "#/components/schemas/PatchFieldString"
          }
        }
      },
      "StoreResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "email": {
            "type": "string"
          },
          "userName": {
            "type": "string"
          },
          "storeName": {
            "type": "string"
          },
          "whatsappNumber": {
            "type": "string"
          },
          "storeDescription": {
            "type": "string"
          },
          "logoUrl": {
            "type": "string"
          },
          "coverImageUrl": {
            "type": "string"
          },
          "promoImageUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isActive": {
            "type": "boolean"
          },
          "addressStreet": {
            "type": "string"
          },
          "addressNumber": {
            "type": "string"
          },
          "addressNeighborhood": {
            "type": "string"
          },
          "addressZipCode": {
            "type": "string"
          },
          "stateId": {
            "type": "integer",
            "format": "int64"
          },
          "stateName": {
            "type": "string"
          },
          "stateAbbreviation": {
            "type": "string"
          },
          "cityId": {
            "type": "integer",
            "format": "int64"
          },
          "cityName": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "businessTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "businessTypeName": {
            "type": "string"
          },
          "profileType": {
            "type": "string",
            "enum": [
              "STANDARD",
              "AFFILIATE"
            ]
          },
          "emailVerified": {
            "type": "boolean"
          },
          "subscription": {
            "$ref": "#/components/schemas/SubscriptionResponse"
          },
          "storeNameFont": {
            "type": "string"
          },
          "coverColor": {
            "type": "string"
          },
          "storeTheme": {
            "type": "string"
          }
        }
      },
      "SubscriptionResponse": {
        "type": "object",
        "properties": {
          "plan": {
            "type": "string",
            "enum": [
              "FREE",
              "BASIC",
              "PRO",
              "PREMIUM"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "TRIAL",
              "ACTIVE",
              "PAST_DUE",
              "CANCELLED",
              "EXPIRED"
            ]
          },
          "startedAt": {
            "type": "string",
            "format": "date-time"
          },
          "trialEndsAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "active": {
            "type": "boolean"
          }
        }
      },
      "ProductUpdateMultipartDoc": {
        "type": "object",
        "description": "Multipart para atualização de produto",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ProductUpdateRequest",
            "description": "Campos a atualizar"
          },
          "images": {
            "type": "array",
            "description": "Novas fotos (opcional, substitui todas as existentes)",
            "items": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "ProductUpdateRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 150,
            "minLength": 2
          },
          "description": {
            "type": "string",
            "maxLength": 2000,
            "minLength": 0
          },
          "isVisible": {
            "type": "boolean"
          },
          "featured": {
            "type": "boolean"
          },
          "price": {
            "type": "number",
            "minimum": 0.01
          },
          "attributes": {
            "type": "object",
            "additionalProperties": {

            }
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "affiliateUrl": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 0
          }
        }
      },
      "ProductResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "imageUrl": {
            "type": "string"
          },
          "imageUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isVisible": {
            "type": "boolean"
          },
          "featured": {
            "type": "boolean"
          },
          "price": {
            "type": "number"
          },
          "storeId": {
            "type": "string",
            "format": "uuid"
          },
          "whatsappUrl": {
            "type": "string"
          },
          "clickCount": {
            "type": "integer",
            "format": "int64"
          },
          "affiliateUrl": {
            "type": "string"
          },
          "affiliateClickCount": {
            "type": "integer",
            "format": "int64"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": {

            }
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "productTypeLabel": {
            "type": "string"
          }
        }
      },
      "PdvEmployeeRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0
          },
          "pin": {
            "type": "string",
            "maxLength": 6,
            "minLength": 4,
            "pattern": "\\d*"
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "MANAGER",
              "CASHIER"
            ]
          }
        },
        "required": [
          "name"
        ]
      },
      "PdvEmployeeResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "MANAGER",
              "CASHIER"
            ]
          },
          "isActive": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PdvCustomerRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0
          },
          "phone": {
            "type": "string"
          },
          "cpf": {
            "type": "string",
            "maxLength": 14,
            "minLength": 0
          },
          "address": {
            "type": "string",
            "maxLength": 200,
            "minLength": 0
          }
        },
        "required": [
          "name"
        ]
      },
      "PdvCustomerResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "cpf": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "openCreditsCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalBalance": {
            "type": "number"
          }
        }
      },
      "SubscriptionAdminUpdateRequest": {
        "type": "object",
        "properties": {
          "plan": {
            "type": "string",
            "enum": [
              "FREE",
              "BASIC",
              "PRO",
              "PREMIUM"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "TRIAL",
              "ACTIVE",
              "PAST_DUE",
              "CANCELLED",
              "EXPIRED"
            ]
          },
          "trialEndsAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "cancelledAt": {
            "type": "string",
            "format": "date-time"
          },
          "paymentProvider": {
            "type": "string",
            "enum": [
              "STRIPE",
              "PAGSEGURO",
              "ASAAS",
              "MANUAL"
            ]
          },
          "externalId": {
            "type": "string"
          }
        }
      },
      "AdminStoreResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "email": {
            "type": "string"
          },
          "userName": {
            "type": "string"
          },
          "storeName": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "isActive": {
            "type": "boolean"
          },
          "emailVerified": {
            "type": "boolean"
          },
          "profileType": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "subscription": {
            "$ref": "#/components/schemas/SubscriptionResponse"
          }
        }
      },
      "StoreRegisterRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 150,
            "minLength": 0
          },
          "password": {
            "type": "string",
            "maxLength": 128,
            "minLength": 8
          },
          "userName": {
            "type": "string",
            "maxLength": 100,
            "minLength": 2
          },
          "storeName": {
            "type": "string",
            "maxLength": 100,
            "minLength": 2
          },
          "whatsappNumber": {
            "type": "string",
            "minLength": 1,
            "pattern": "\\d{10,15}"
          },
          "storeDescription": {
            "type": "string",
            "maxLength": 500,
            "minLength": 0
          },
          "stateId": {
            "type": "integer",
            "format": "int64"
          },
          "cityId": {
            "type": "integer",
            "format": "int64"
          },
          "businessTypeId": {
            "type": "integer",
            "format": "int64"
          }
        },
        "required": [
          "email",
          "password",
          "storeName",
          "userName",
          "whatsappNumber"
        ]
      },
      "LoginResponse": {
        "type": "object",
        "properties": {
          "accessToken": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "storeId": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "ProductCreateMultipartDoc": {
        "type": "object",
        "description": "Multipart para criação de produto",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ProductCreateRequest",
            "description": "Dados do produto"
          },
          "images": {
            "type": "array",
            "description": "Fotos do produto (opcional, até 5)",
            "items": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "ProductCreateRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 150,
            "minLength": 2
          },
          "description": {
            "type": "string",
            "maxLength": 2000,
            "minLength": 0
          },
          "storeId": {
            "type": "string",
            "format": "uuid"
          },
          "isVisible": {
            "type": "boolean"
          },
          "imageUrls": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 2048,
              "minLength": 0
            }
          },
          "price": {
            "type": "number",
            "minimum": 0.01
          },
          "attributes": {
            "type": "object",
            "additionalProperties": {

            }
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "affiliateUrl": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 0
          }
        },
        "required": [
          "name",
          "productTypeId",
          "storeId"
        ]
      },
      "ProductTypeCreateRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0,
            "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
          },
          "label": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "required": [
          "key",
          "label"
        ]
      },
      "ProductTypeResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "AttributeDefinitionCreateRequest": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0,
            "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
          },
          "label": {
            "type": "string",
            "maxLength": 100,
            "minLength": 0
          },
          "required": {
            "type": "boolean"
          },
          "filterable": {
            "type": "boolean"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          },
          "enumOptions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 2147483647,
            "minItems": 1
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          }
        },
        "required": [
          "key",
          "label"
        ]
      },
      "AttributeDefinitionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "NUMBER",
              "ENUM",
              "BOOLEAN"
            ]
          },
          "unit": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "filterable": {
            "type": "boolean"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          },
          "enumOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "AttributeOptionCreateRequest": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "maxLength": 255,
            "minLength": 0
          }
        },
        "required": [
          "value"
        ]
      },
      "PdvCashFlowRequest": {
        "type": "object",
        "properties": {
          "offlineId": {
            "type": "string",
            "minLength": 1
          },
          "type": {
            "type": "string",
            "enum": [
              "IN",
              "OUT"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "SALE",
              "CREDIT_PAYMENT",
              "OPENING",
              "EXPENSE",
              "WITHDRAWAL",
              "OTHER"
            ]
          },
          "amount": {
            "type": "number",
            "minimum": 0.01
          },
          "description": {
            "type": "string"
          },
          "flowDate": {
            "type": "string",
            "format": "date-time"
          },
          "operatorId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "amount",
          "category",
          "flowDate",
          "offlineId",
          "type"
        ]
      },
      "PdvSaleItemRequest": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "integer",
            "format": "int64"
          },
          "productName": {
            "type": "string",
            "minLength": 1
          },
          "unitPrice": {
            "type": "number",
            "minimum": 0
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "minimum": 1
          }
        },
        "required": [
          "productName",
          "unitPrice"
        ]
      },
      "PdvSaleRequest": {
        "type": "object",
        "properties": {
          "offlineId": {
            "type": "string",
            "minLength": 1
          },
          "customerId": {
            "type": "string",
            "format": "uuid"
          },
          "paymentMethod": {
            "type": "string",
            "enum": [
              "CASH",
              "PIX",
              "CARD",
              "CREDIT"
            ]
          },
          "amountPaid": {
            "type": "number",
            "minimum": 0
          },
          "saleDate": {
            "type": "string",
            "format": "date-time"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvSaleItemRequest"
            },
            "minItems": 1
          },
          "note": {
            "type": "string"
          },
          "operatorId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "amountPaid",
          "items",
          "offlineId",
          "paymentMethod",
          "saleDate"
        ]
      },
      "PdvSyncRequest": {
        "type": "object",
        "properties": {
          "sales": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvSaleRequest"
            }
          },
          "cashFlows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvCashFlowRequest"
            }
          }
        }
      },
      "PdvSyncResponse": {
        "type": "object",
        "properties": {
          "salesProcessed": {
            "type": "integer",
            "format": "int32"
          },
          "salesSkipped": {
            "type": "integer",
            "format": "int32"
          },
          "cashFlowsProcessed": {
            "type": "integer",
            "format": "int32"
          },
          "cashFlowsSkipped": {
            "type": "integer",
            "format": "int32"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "PdvSaleItemResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "productId": {
            "type": "integer",
            "format": "int64"
          },
          "productName": {
            "type": "string"
          },
          "unitPrice": {
            "type": "number"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "subtotal": {
            "type": "number"
          }
        }
      },
      "PdvSaleResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "offlineId": {
            "type": "string"
          },
          "customerId": {
            "type": "string",
            "format": "uuid"
          },
          "customerName": {
            "type": "string"
          },
          "operatorId": {
            "type": "string",
            "format": "uuid"
          },
          "operatorName": {
            "type": "string"
          },
          "paymentMethod": {
            "type": "string",
            "enum": [
              "CASH",
              "PIX",
              "CARD",
              "CREDIT"
            ]
          },
          "totalAmount": {
            "type": "number"
          },
          "amountPaid": {
            "type": "number"
          },
          "changeAmount": {
            "type": "number"
          },
          "status": {
            "type": "string",
            "enum": [
              "COMPLETED",
              "CANCELLED"
            ]
          },
          "note": {
            "type": "string"
          },
          "saleDate": {
            "type": "string",
            "format": "date-time"
          },
          "syncedAt": {
            "type": "string",
            "format": "date-time"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvSaleItemResponse"
            }
          }
        }
      },
      "PdvPinAuthRequest": {
        "type": "object",
        "properties": {
          "employeeId": {
            "type": "string",
            "format": "uuid"
          },
          "pin": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "employeeId",
          "pin"
        ]
      },
      "PdvCustomerCreditRequest": {
        "type": "object",
        "properties": {
          "originSaleId": {
            "type": "string",
            "format": "uuid"
          },
          "totalDue": {
            "type": "number",
            "minimum": 0.01
          },
          "dueDate": {
            "type": "string",
            "format": "date-time"
          },
          "note": {
            "type": "string",
            "maxLength": 500,
            "minLength": 0
          }
        },
        "required": [
          "totalDue"
        ]
      },
      "PdvCreditPaymentResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "amount": {
            "type": "number"
          },
          "paymentMethod": {
            "type": "string",
            "enum": [
              "CASH",
              "PIX",
              "CARD",
              "CREDIT"
            ]
          },
          "paidAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PdvCustomerCreditResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "originSaleId": {
            "type": "string",
            "format": "uuid"
          },
          "totalDue": {
            "type": "number"
          },
          "amountPaid": {
            "type": "number"
          },
          "balance": {
            "type": "number"
          },
          "dueDate": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "enum": [
              "OPEN",
              "PARTIAL",
              "PAID",
              "OVERDUE"
            ]
          },
          "note": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvCreditPaymentResponse"
            }
          }
        }
      },
      "PdvCreditPaymentRequest": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "number",
            "minimum": 0.01
          },
          "paymentMethod": {
            "type": "string",
            "enum": [
              "CASH",
              "PIX",
              "CARD",
              "CREDIT"
            ]
          },
          "paidAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "amount",
          "paymentMethod"
        ]
      },
      "PdvCashFlowResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "offlineId": {
            "type": "string"
          },
          "operatorId": {
            "type": "string",
            "format": "uuid"
          },
          "operatorName": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "IN",
              "OUT"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "SALE",
              "CREDIT_PAYMENT",
              "OPENING",
              "EXPENSE",
              "WITHDRAWAL",
              "OTHER"
            ]
          },
          "amount": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "flowDate": {
            "type": "string",
            "format": "date-time"
          },
          "syncedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "RefreshResponse": {
        "type": "object",
        "properties": {
          "accessToken": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "LoginRequest": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "minLength": 1
          },
          "password": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "email",
          "password"
        ]
      },
      "PdvStockPatchRequest": {
        "type": "object",
        "properties": {
          "quantityDelta": {
            "type": "integer",
            "format": "int32"
          },
          "trackStock": {
            "type": "boolean"
          }
        },
        "required": [
          "quantityDelta"
        ]
      },
      "PdvStockResponse": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "integer",
            "format": "int64"
          },
          "productName": {
            "type": "string"
          },
          "trackStock": {
            "type": "boolean"
          },
          "stockQuantity": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "PageResponseProductResponse": {
        "type": "object",
        "properties": {
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductResponse"
            }
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "last": {
            "type": "boolean"
          }
        }
      },
      "ProductFilter": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string"
          },
          "minPrice": {
            "type": "number"
          },
          "maxPrice": {
            "type": "number"
          },
          "productTypeId": {
            "type": "integer",
            "format": "int64"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "PagePdvSaleResponse": {
        "type": "object",
        "properties": {
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "pageable": {
            "$ref": "#/components/schemas/PageableObject"
          },
          "numberOfElements": {
            "type": "integer",
            "format": "int32"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvSaleResponse"
            }
          },
          "number": {
            "type": "integer",
            "format": "int32"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "first": {
            "type": "boolean"
          },
          "last": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          }
        }
      },
      "PageableObject": {
        "type": "object",
        "properties": {
          "unpaged": {
            "type": "boolean"
          },
          "pageNumber": {
            "type": "integer",
            "format": "int32"
          },
          "paged": {
            "type": "boolean"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          }
        }
      },
      "SortObject": {
        "type": "object",
        "properties": {
          "unsorted": {
            "type": "boolean"
          },
          "sorted": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          }
        }
      },
      "PagePdvCashFlowResponse": {
        "type": "object",
        "properties": {
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "pageable": {
            "$ref": "#/components/schemas/PageableObject"
          },
          "numberOfElements": {
            "type": "integer",
            "format": "int32"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PdvCashFlowResponse"
            }
          },
          "number": {
            "type": "integer",
            "format": "int32"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "first": {
            "type": "boolean"
          },
          "last": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          }
        }
      },
      "PdvCashFlowSummaryResponse": {
        "type": "object",
        "properties": {
          "totalIn": {
            "type": "number"
          },
          "totalOut": {
            "type": "number"
          },
          "balance": {
            "type": "number"
          },
          "countIn": {
            "type": "integer",
            "format": "int64"
          },
          "countOut": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "StateResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "abbreviation": {
            "type": "string"
          }
        }
      },
      "CityResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "stateId": {
            "type": "integer",
            "format": "int64"
          },
          "stateAbbreviation": {
            "type": "string"
          }
        }
      },
      "BusinessTypeResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "AdminStoreFilter": {
        "type": "object",
        "properties": {
          "search": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "storeName": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "plan": {
            "type": "string",
            "enum": [
              "FREE",
              "BASIC",
              "PRO",
              "PREMIUM"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "TRIAL",
              "ACTIVE",
              "PAST_DUE",
              "CANCELLED",
              "EXPIRED"
            ]
          }
        }
      },
      "PageResponseAdminStoreResponse": {
        "type": "object",
        "properties": {
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AdminStoreResponse"
            }
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "last": {
            "type": "boolean"
          }
        }
      },
      "PlatformStatsResponse": {
        "type": "object",
        "properties": {
          "totalStores": {
            "type": "integer",
            "format": "int64"
          },
          "activeStores": {
            "type": "integer",
            "format": "int64"
          },
          "totalProducts": {
            "type": "integer",
            "format": "int64"
          },
          "totalWhatsappClicks": {
            "type": "integer",
            "format": "int64"
          },
          "totalAffiliateClicks": {
            "type": "integer",
            "format": "int64"
          }
        }
      }
    }
  }
}