-----------------------------------------------------
====== Tipo de Carteira Digital ======
A tela **Tipo de Carteira Digital** é utilizada para cadastrar e administrar os tipos de carteira disponíveis para utilização nas **Ofertas Carteira Digital**. O tipo funciona como uma **classificação da oferta**, permitindo separar diferentes finalidades de carteira, como: **Balde**; **Produtos em Geral**; Outros tipos que venham a ser cadastrados.
O cadastro é realizado no menu **Cadastro > Tipo de Carteira**.
{{:captura_de_tela_2026-08-24_151456.png?250|}}
**Importante:** o Tipo de Carteira não adiciona saldo ou produtos ao cliente. Ele serve para classificar as ofertas que posteriormente serão cadastradas em **Eventos > Ofertas Carteira Digital**.
-----------------------------------------------------
==== Tela principal ====
{{:captura_de_tela_2026-08-24_152021.png?1000|}}
A tela apresenta os tipos de carteira cadastrados no sistema.
São exibidas as seguintes informações:
* **Nome:** identificação do tipo de carteira.
* **Descrição:** texto explicativo associado ao tipo.
* **Status:** indica se o tipo está ativo.
* **Ações:** permite editar ou remover o cadastro.
Para cadastrar um novo **tipo**, clique em **+ Novo**. {{:captura_de_tela_2026-08-24_155212.png|}}
-----------------------------------------------------
==== Novo Tipo de Carteira ====
{{:captura_de_tela_2026-08-18_145815.png?400|}}
Ao clicar em **+ Novo**, será aberto o modal **Novo Tipo de Carteira**.
**CAMPOS:**
**Nome:** Campo obrigatório utilizado para identificar o tipo de carteira.Exemplos: Balde; Produtos em Geral.
**Descrição:** Texto explicativo sobre a finalidade do tipo. A descrição cadastrada aparece nas ofertas desse tipo no catálogo do **ecommerce**.
**Ativo:** Define se o tipo poderá ser utilizado em novas ofertas.
**Inativo:** deixa de ficar disponível para novas ofertas.
Desativar o tipo **não desativa ofertas que já estejam vinculadas a ele**.
-----------------------------------------------------
==== Editar Tipo de Carteira ====
{{:captura_de_tela_2026-08-18_145851.png?400|}}
A opção de edição permite alterar as informações de um tipo já cadastrado. É possível alterar: **Nome**, **Descrição**, **Status Ativo/Inativo.** Após realizar as alterações, clique em **Salvar**.
Ao tornar um tipo **inativo**, ele deixa de ficar disponível para uso em novas ofertas, porém as ofertas que já utilizam esse tipo **não** são automaticamente desativadas.
-----------------------------------------------------
==== Remover Tipo de Carteira ====
{{:captura_de_tela_2026-08-18_145916.png?400|}}
Ao clicar no botão de exclusão (**lixeira**), será exibido o modal **Remover tipo de carteira**. O sistema solicita uma confirmação antes da remoção. A remoção faz com que o tipo deixe de aparecer para utilização em novas ofertas.
A remoção do tipo **não desativa as ofertas que já apontam para ele**. Portanto, é necessário verificar previamente se existem ofertas utilizando o tipo antes de realizar a exclusão.
-----------------------------------------------------
==== Regra de Negócio ====
* O **Tipo de Carteira** é uma classificação utilizada pelas ofertas de Carteira Digital.
* A descrição cadastrada é apresentada no catálogo do **ecommerce** para ofertas relacionadas ao tipo.
* Apenas tipos **disponíveis** podem ser utilizados normalmente na criação de novas ofertas.
* **Inativar** um tipo **impede** seu uso em novas ofertas.
* **Inativar** um tipo **não desativa** ofertas que já estejam vinculadas a ele.
* **Remover** um tipo faz com que ele **deixe** de ficar disponível para novas ofertas.
* A remoção também **não desativa** automaticamente ofertas que já utilizam o tipo.
**Atenção:** Antes de **inativar ou remover** um **Tipo de Carteira**, verifique se existem ofertas vinculadas a ele. Como ofertas existentes podem continuar associadas ao tipo, alterações nesse cadastro devem ser realizadas com atenção para não gerar inconsistências na organização das ofertas da **Carteira Digital**.
-----------------------------------------------------
====== Saldo Carteira Digital ======
A tela **Saldo Carteira Digital** é utilizada para realizar a **correção manual de créditos de produto** da carteira digital dos clientes dentro do evento selecionado. Por meio dessa tela, o administrador pode: Consultar os saldos cadastrados, localizar um cliente pelo CPF, adicionar manualmente crédito de produto, alterar a quantidade de um crédito existente e remover um crédito da carteira do cliente.
O acesso é realizado pelo menu **Eventos > Saldo Carteira Digital**
{{:captura_de_tela_2026-08-24_180845.png?250|}}
**Importante:** esta tela é destinada a **ajustes administrativos de saldo**. Ela **não** representa uma venda realizada pelo ecommerce.
-----------------------------------------------------
==== Tela principal ====
{{:captura_de_tela_2026-08-18_145957.png?1000|}}
A tela trabalha com o **evento atualmente selecionado no painel**.
A listagem apresenta:
* **Cliente:** nome do cliente relacionado ao saldo.
* **Documento:** CPF/documento do cliente.
* **Produto:** produto disponível como crédito.
* **Quantidade:** quantidade de unidades disponíveis.
* **Ações:** editar ou remover o saldo.
Para adicionar um novo **saldo**, clique em **+ Novo**. {{:captura_de_tela_2026-08-24_155212.png|}}
**Filtro por Cliente:**
|{{:captura_de_tela_2026-08-24_182927.png?430|}}|{{:captura_de_tela_2026-08-24_182949.png?300|}}|
Na parte superior da tela existe o campo **Filtrar por cliente (CPF)**. Informe o CPF desejado e clique em **Buscar** para localizar os saldos relacionados ao cliente. Esse recurso facilita a consulta e a correção de créditos específicos.
-----------------------------------------------------
==== Novo Saldo de Carteira Digital ====
{{:captura_de_tela_2026-08-18_150010.png?400|}}
Ao clicar em **+ Novo**, será aberto o modal **Novo Saldo de Carteira Digital**.
O objetivo desse modal é adicionar manualmente **crédito de produto** à **carteira digital**.
**CAMPOS:**
**Evento:** O **evento** é apresentado automaticamente de acordo com o evento selecionado no **painel**.
**Cliente (CPF):** Permite localizar o **cliente** que receberá o crédito. Informe o CPF e clique em **Buscar**.
Após localizar o cadastro, o sistema apresenta o cliente selecionado juntamente com seu documento.
O cliente selecionado pode ser removido da seleção pelo botão **X**.
**Produto:** Campo obrigatório para selecionar o **produto** que será adicionado à carteira. Exemplo: **Pizza brotinho**
**Quantidade:** Define quantas **unidades** do produto serão adicionadas ao saldo.
-----------------------------------------------------
==== Editar Saldo ====
{{:captura_de_tela_2026-08-18_150049.png?400|}}
A ação de **edição** permite corrigir a quantidade de um saldo existente.
O modal apresenta: **Evento**; **Cliente**; **Produto**; **Quantidade**.
A quantidade pode ser alterada conforme a necessidade da correção.
Após realizar a alteração, clique em **Salvar**.
A edição **altera** diretamente a **quantidade de crédito** disponível para aquele produto na carteira do cliente.
-----------------------------------------------------
==== Remover Saldo ====
{{:captura_de_tela_2026-08-18_150057.png?400|}}
A opção de **exclusão** permite retirar o crédito de produto da carteira do cliente.
Antes da remoção, o sistema apresenta um modal de **confirmação** informando: Quantidade que será removida; Produto relacionado e Cliente relacionado. Exemplo: **Remover 1x Inteira do saldo do cliente X.**
A remoção tira o **crédito** do cliente. A própria interface alerta que essa ação **não** possui uma reversão simples pela tela.
-----------------------------------------------------
==== Regra de Negócio ====
* O saldo está relacionado ao **evento selecionado**.
* O saldo representa crédito de **produto em unidades** disponível para o cliente.
* O administrador pode adicionar créditos manualmente.
* O cliente pode ser localizado pelo CPF.
* Um saldo é associado a um **produto** e a uma determinada **quantidade**.
* A edição permite corrigir a quantidade existente.
* A remoção retira o crédito da carteira do cliente.
* Os ajustes realizados nesta tela são **administrativos** e não correspondem a uma nova compra no ecommerce.
**Atenção:** Sempre **confirme**: O evento selecionado, cliente/CPF, produto e quantidade.
A alteração **interfere** diretamente no crédito disponível para utilização pelo cliente. Remoções devem ser realizadas somente após a confirmação dos **dados**.
-----------------------------------------------------
====== Ofertas Carteira Digital ======
A tela **Ofertas de Carteira Digital** é utilizada para configurar as ofertas de recarga da Carteira Digital que serão disponibilizadas no ecommerce do evento. As ofertas podem trabalhar de duas formas:
**Monetária:** adiciona crédito em R$ à carteira.
**Produto:** adiciona uma quantidade determinada de um produto à carteira.
O acesso é realizado em: **Eventos > Ofertas Carteira Digital**.
{{:captura_de_tela_2026-08-24_190926.png?250|}}
**Importante:** antes de cadastrar uma oferta, verifique se o **evento correto** está selecionado e se o **Tipo de Carteira** que será utilizado já está cadastrado e ativo. A oferta será vinculada ao evento selecionado e utilizará o tipo de carteira definido no cadastro.
-----------------------------------------------------
==== Tela principal ====
{{:captura_de_tela_2026-08-18_150106.png?1000|}}
A listagem apresenta:
* **Nome:** nome da oferta.
* **Tipo:** Tipo de Carteira relacionado.
* **Modo:** forma de crédito da oferta.
* **Valor:** valor cobrado pela oferta.
* **Produto:** produto e quantidade, quando aplicável.
* **Status:** indica se a oferta está ativa.
* **Ações:** editar ou remover.
Para cadastrar uma nova **oferta**, clique em **+ Novo**. {{:captura_de_tela_2026-08-24_155212.png|}}
-----------------------------------------------------
==== Nova Oferta de Carteira Digital ====
{{:captura_de_tela_2026-08-18_150806.png?400|}}
Ao clicar em **+ Novo**, será aberto o modal **Nova Oferta de Carteira Digital**.
**CAMPOS:**
**Evento:** O evento é preenchido de acordo com o evento selecionado no painel.
**Tipo de Carteira:** Define a classificação da oferta. As opções são provenientes dos cadastros realizados em: **Cadastro > Tipo de Carteira**
**Nome da oferta:** É o nome utilizado para identificar a oferta. Exemplos: **Pizza**; **Balde de Petra**.
**Valor total (R$):** Representa o valor cobrado do cliente pela oferta.
**Taxa de serviço (R$):** Permite informar a taxa de serviço relacionada à oferta.
**Modo:** Campo obrigatório que define o tipo de crédito gerado pela compra. Existem **DOIS** modos:
* **Modo Monetária (recarga em R$):** a oferta representa uma recarga em dinheiro para a Carteira Digital. Nesse modelo, o benefício adquirido pelo cliente é representado por crédito monetário em R$, e não por uma quantidade específica de produto. O cliente adquire uma recarga monetária para utilização por meio da Carteira Digital.
{{:captura_de_tela_2026-08-24_193226.png?500|}}
* **Modo Produto (crédito de N unidades):** a oferta gera crédito de um produto específico. Ao selecionar esse modo, são utilizados os campos relacionados ao produto.
{{:captura_de_tela_2026-08-24_193213.png?500|}}
**Produto:** Define qual produto será creditado na carteira.
**Quantidade** Define quantas unidades serão creditadas.
**Valor unitário (R$):** Apresenta o valor unitário relacionado ao produto dentro da configuração da oferta.
**Imagem:** permite associar uma imagem à oferta para sua apresentação no ecommerce (suportam PNG, JPEG ou WEBP).
**Ativa:** Controla a disponibilidade da oferta no catálogo (se inativa não aparece no ecommerce).
Inativar uma oferta não apaga o histórico dos clientes que já realizaram a compra.
-----------------------------------------------------
==== Editar Oferta ====
{{:captura_de_tela_2026-08-18_150857.png?400|}}
A ação de **edição** permite: alterar uma oferta existente. Dependendo do **modo** da oferta, podem ser apresentados: Evento, Tipo de Carteira, Nome da oferta, Valor total, Taxa de serviço, Modo, Produto, Quantidade, Valor unitário, e Status Ativo/Inativo.
Após realizar as alterações, clique em **Salvar**.
-----------------------------------------------------
==== Remover Oferta ====
{{:captura_de_tela_2026-08-18_150908.png?400|}}
Ao clicar na opção de exclusão (**lixeira**), será exibido o modal **Remover oferta**. O sistema solicita confirmação antes de retirar a oferta.
Ao remover uma oferta, ela deixa de aparecer no catálogo do ecommerce imediatamente. Entretanto, o histórico dos clientes que já compraram a oferta continua armazenado.
-----------------------------------------------------
==== Regra de Negócio ====
* Cada oferta pertence ao **evento selecionado**.
* Toda oferta deve possuir um **Tipo de Carteira**.
* O Tipo de Carteira utilizado vem dos cadastros realizados em **Cadastro > Tipo de Carteira**.
* Toda oferta possui um nome e um valor total.
* A oferta pode operar em modo **Monetária** ou **Produto**.
* No modo Monetária, o benefício é crédito em R$.
* No modo Produto, o benefício é crédito de determinada quantidade de um produto.
* Ofertas inativas deixam de aparecer no catálogo.
* A inativação não apaga o histórico de quem já comprou.
* A remoção retira a oferta do catálogo, mas preserva o histórico de compras já realizadas.
**Atenção:** Antes de disponibilizar uma oferta, **valide**: evento, tipo de carteira, nome da oferta, valor total, taxa de serviço, modo, produto, quantidade e status da oferta. **Alterações** em ofertas já disponibilizadas devem ser realizadas com atenção, principalmente quando já existirem clientes que **efetuaram a compra**.
-----------------------------------------------------
====== Fluxo da Carteira Digital ======
O fluxo da **Carteira Digital** envolve três áreas administrativas: **Tipo de Carteira**, **Ofertas Carteira Digital** e **Saldo Carteira Digital**.
-----------------------------------------------------
==== 1. Tipo de Carteira ====
Acesse **Cadastro > Tipo de Carteira**.
Define a classificação utilizada nas ofertas, como **Balde** ou **Produtos em Geral**.
**Fluxo:** Tipo de Carteira -> + Novo -> Nome e Descrição -> Criar.
-----------------------------------------------------
==== 2. Ofertas de Carteira Digital ====
Acesse **Eventos > Ofertas Carteira Digital**.
Permite cadastrar as ofertas do evento, definindo:
**Tipo de Carteira**
**Nome da oferta**
**Valor total**
**Taxa de serviço**
**Modo**
**Imagem**
**Status**
O campo **Modo** possui as opções:
* **Monetária (recarga em R$)**
* **Produto (crédito de N unidades)**
No modo **Produto**, também são definidos o **Produto**, a **Quantidade** e o **Valor unitário**.
-----------------------------------------------------
==== 3. Saldo Carteira Digital ====
Acesse **Eventos > Saldo Carteira Digital**.
É utilizado para consultar e realizar **correções manuais de créditos de produto** dos clientes no evento selecionado. Permite:
* Buscar cliente pelo CPF.
* Adicionar crédito de produto.
* Alterar a quantidade.
* Remover crédito.
-----------------------------------------------------
==== Fluxo Resumido ====
**Tipo de Carteira** → classifica as ofertas;
↓
**Oferta Carteira Digital** → configura a oferta do evento (modo Monetária ou Produto);
↓
**Oferta** disponibilizada no **ecommerce**;
↓
**Saldo Carteira Digital** → consulta e correção administrativa de créditos dos produtos.
-----------------------------------------------------
**Atenção:** Antes de criar ou alterar qualquer configuração da Carteira Digital, sempre verifique o **evento selecionado**. Também devem ser conferidos o Tipo de Carteira, modo da oferta, valores, produto, quantidade e status antes de disponibilizar uma oferta no ecommerce. A edição ou remoção manual de saldo **interfere** diretamente nos créditos disponíveis para o cliente e deve ser realizada somente **após** a conferência das informações.
-----------------------------------------------------