Segmentação por Etiquetas (Tags)

O sistema de Tags permite a rotulagem dinâmica de utilizadores e organizações. Estas etiquetas são fundamentais para a Segmentação de Políticas de Acesso e aplicação de regras de negócio granulares, como descontos específicos ou permissões em estações de recarga selecionadas.

Escopo de Dados

As tags e os seus vínculos são estritamente restritos à Empresa (Company) do utilizador autenticado.

---

Listagem e Criação

Funcionalidade	Método	Caminho	Descrição
Listar Tags	GET	/tags	Retorna as etiquetas da empresa com contagem de membros.
Criar Tag	POST	/tag	Regista uma nova etiqueta ativa (requer name).

Exemplo de Resposta (Listagem)

{
    "data": [
      {
        "id": 1,
        "name": "Frota-Norte",
        "status": "active",
        "users_count": 15
      }
    ]
  }

---

Gestão de Vínculos

As tags podem ser associadas individualmente ou a organizações inteiras para propagação de permissões.

POST /add-tag

Corpo da Requisição

{
    "tag_id": 1,
    "direct_user_id": 123
  }

---

Manutenção

• PUT /tag/{id} — Atualizar nomenclatura.
• PUT /tag-inactivate/{id} — Alternar estado operacional da etiqueta.