Manuais Auto Serviço - APP
Ult. Alteração: 01/12/2021
Alterado por: Brenda
O que é Laundry Express (LE)?
É uma solução da Ideologica para a gestão de auto serviço de lavanderias para condomínios, lojas 100% autônomas e lojas mistas.
Definições da solução
Principais características da Solução?
Para cada solução existe uma característica principal
1. Condomínios: O principal ponto é a integração os moradores do condomínio com a lavanderia coletiva mediante a liberação de máquinas por uso de um cartão magnético. Outro ponto importante é a possibilidade de empréstimo de cartões por tempo definido entre moradores e a possibilidade de reservar máquina para um horário que for mais conveniente para o morador.
2. Lojas 100% autônomas: As lojas autônomas estão tem como principal caraterística a execução de 100% da operação mediante liberação das maquinas via aplicativo.
3. Lojas Mistas: Além do que existem na loja (100%) autônoma o consumidor poderá comprar o ciclo da máquina direto no PDV da loja (integrado somente com o AllegroNet ) e a atendente poderá fazer a liberação da máquina.
Como funciona a solução LE?
1. Placa configura é instalada na máquina avisa ao servidor que está livre para uso

2. Placa manda sinal para servidor deixando maquina disponível para uso:

3. Cliente usando o aplicativo faz a compra dos créditos das maquinas

4. Com processo de compra finalizado loja é creditada e cliente tem valor disponível para ser usado

5. Usando aplicativo ou cartão magnético o cliente faz a liberação da máquina

6. A maquina liberada ou em uso avisa o servidor que esta ocupada e não vai aceitar mais nenhuma solicitação de uso

7. Assim que é concluído o ciclo, o cliente retira a roupa e a máquina volta ao estado inicial
Padrão de Nomes (DESENVOLVIMENTO)
URL Gestão: <NumeroDaEmpresa>-autoservico.ideologica.com.br
URL Maquinas: <NumeroDaEmpresa>-m-<CodigoGenerico10posições>.ideologica.com.br
URL API Maquinas TST: <NumeroDaEmpresa>-m-<CodigoGenerico10posições>-tst.ideologica.com.br
URL Maquinas Completa: http://c-m-<CodigoGenerico10posições>.ideologica.com.br/PRD/api/comandos/processacomando
URL API: <CodigoGenerico10posições>-c-<CodigoGenerico10posições>.ideologica.com.br
URL API Clientes: <CodigoGenerico10posições>: 195-c-<CodigoGenerico10posições>-tst.ideologica.com.br
URL API Clientes: LEAutoServico_<NumeroDaEmpresa >_ambiente: LEAutoServico_195_PRD ou LEAutoServico_195_TST
Configurações (DESENVOLVIMENTO)
Configurar Domínios
Os domínios são criados no Painel da Uol a partir do nome incluindo o nome do cliente.
A configuração deve ser criada para cada matriz. O tempo de replicação é de 20 minutos.

Configurar Banco de Dados
Banco PRD: LEAutoServico_< NumeroDaEmpresa >_PRD
Usuário: dboASLExpress< NumeroDaEmpresa >
Senha: PWD.Id30.ASUN3xpr355< NumeroDaEmpresa >-< CodigoGenerico10posições >

Configurar IIS
É necessário configurar tanto o Application Pools quanto a criação do site.
Application Pools
Para cada tipo de uso (Clientes, Maquinas e Gestão) teremos uma AP configurado

Para cada site deveremos ter cadastrado o processo

Esses projetos usam API de pagamento de Shipay e de Braspag
Eles estão vinculado ao site cp.ideoloica.com.br
Braspag

Shipay

Primeiros Operadores
Deveremos receber do Departamento Comercial a lista de pessoas que terão acessos administrativos na ferramenta e assim poderão fazer inclusão de operadores e ajuste que acharem necessários
Aplicativos
Comercial deve enviar:
- Imagens que deverão se incluídas como ícone e como tela de abertura para aplicativo;
- Nome do aplicativo que será publicado na loja da Apple e do Google;
- Nome da tecnico responsável do cliente responsável pelas lojas da Apple e Google no cliente.
Os aplicativos devem ser compilados e publicados pelo time de desenvolvimento nas lojas e fazer o acompanhamento para a geração do QRCode dos aplicativos nas lojas.
Os fontes dos aplicativos ficam hospedado no GitHub. Cada matriz tem a sua pasta para diferencias as imagens.
Todas as funcionalidades devem sempre estar espelhadas em todos de todos os clientes a versão de todos dever estar andando em paralelo.
Validações de APIs
A partir do momento que IIS deverá ser testado as APIs de maquina ver a disponibilidade e teste de uso. A API de clientes deve ser testada durante a utilização dos APP para compra, estorno de créditos e liberação manual de máquina (site de gestão).
EXE e Sites
O site de gestão deve ser testado e disponibilizado junto com o EXE que fica disponível sempre no G:\Presto\AllegroNetCorporativ
Cada cliente tem um EXE que deve ser copiado para a máquina local.
Todas as vezes que uma nova versão for disponibilizada o desenvolvimento deve mudar versão no banco de dados e também colocar a nova versão nestas pastas.
Só é possível executar o programa se for a versão compatível com o sistema.
GitHub
Importante lembrar que todos os fontes estão no GitHub nos seguintes repositórios
APIs: ideologica / ANetCorporativo-API
Sites (gestão e clientes): ideologica / ANetCorporativo-Site
Desktop: ideologica / ANetCorporativo-Desktop
Cadastro da Matriz (IMPLANTAÇÃO)
Para o cadastro da matriz é sempre ter algumas informações que devem ser enviadas pelo Comercial. São elas:
- Razão social e CNPJ
- Dados de contato (nome, email e telefone)
- Chave da Braspag contendo o Merchant ID e o Client Secret
- Percentuais e taxas que foram acertadas entre a Braspag e a matriz
- Em caso de ter recebimento por boleto, dados do cedente:
- Nome o cedente, cnpj, quantidade de dias para vencimento do boleto a partir da emissão, banco emissor e instruções de pagamento que serão impressos no boleto.
- Descrição de como o serviço será impresso na fatura de Cartão de Credito do consumidor. Ex: OMOSelfServ, 5asecAutoSer, etc...
Com esses dados o processo de implantação pode ser iniciado preenchendo os dados no meu Clientes > Gestores e no menu Gestão > Configurações nas Abas Braspag e Shipay.
Split de Pagamentos (IMPLANTAÇÃO)
Split é o nome que que se dá para a divisão de valores entre a matriz e os outros participantes.
Royalties e Fundo de propaganda também poder ser feitos automaticamente fazendo parte split. Existem duas formas de aplicar o Royalties e o FP. Sobre valor Líquido ou Bruto.
- Valor Bruto = Valor original de pagamentos
- Valor Líquido = Valor do pagamento – Taxas
- Para usar o valor bruto no processo de Royalties devemos cadastrar o percentual e as chaves no tela de Configurações > Aba Braspag > Aba Royalties e Fundo de propaganda.
- Se o valor for líquido, esses percentuais devem estar cadastrados no menu Clientes > Ponto de venda
- Sempre que o roy ou fp forem creditados em contas diferentes deles devem estar cadastrados na matriz e no PDV.
No momento que fazer a apresentação da foram de calculo é sempre importante apresentar a planilha para o cliente entender e simular os dos cenários.
- Existem planilhas em L:\Produtos\Auto serviço\Split – Braspag planilha que pode ser usada como exemplo
Se a Ideologica fizer parte do processo de pagamento, recebendo parte do valor, basta colocar a chave da Ideologica da tela de gestão > configurações > Braspag e o percentual na tela de cliente > ponto de venda.
Para a Shipay não existe split de pagamento. É importante deixar claro para a matriz que a contratação é feita a partir da Ideologica e o valor é cobrado direto da loja/condomínio.
Deve-se manter contato sempre com o financeiro para que em caso de inadimplência do cliente possamos fazer a suspenção do serviço da Shipay ou da Braspag.
Placas e Máquinas (IMPLANTAÇÃO)
O processo de cadastro de máquinas e placas é a principal parte no processo de configuração. Conceito é simples:
- Primeiro são criadas as placas e as máquinas individualmente
- Para as maquinas sempre usamos o conceito de maquina final par para Lavadora e final impar para secadora:
Ex. Lavadora 00002L e Secadora 00001S. - Para as placas também usamos o mesmo critério.
Ex, 00002L e 00001L - Assim ficará visível sempre a combinação.

- Após as placas criadas é hora de instalar a placa na máquina. No menu Equipamentos > Administrar Placas eu vou pegar uma placa livre e instalar em uma máquina.

- Com as placas instaladas o próximo passo é a instalação da maquina na loja ou no condomínio.
- Em sua maioria (98%) as maquinas são do padrão Stack (Secadora na parte Superior e lavadora na parte inferior). Essas maquinas tem o mesmo numero de série então para fazermos a diferenciação sempre cadastramos elas com L ou S no final.
No processo de instalação de máquinas sempre existe um subconjunto de maquinas criadas e vinculadas a um ponto de venda chamado “reserva da máquina”. Com isso não é preciso ficar criando maquinas. Basta desvincular deste ponto de venda e vincular a um ponto de venda correto.
Para saber se a placa e maquinas foram vinculadas corretamente basta ir no menu Equipamentos > Painel de Máquinas e selecionar o PDV para ver o status da máquina.

Este acompanhamento também pode ser visto no site e gestão.
Suporte: se a maquina não se comunica com o servidor, peça para ser revista a internet do lugar.
Cadastro das Lojas (IMPLANTAÇÃO)
Antes de fazer o cadastro de uma loja é muito importante saber: a operação é PRE- PAGA ou PÓS-PAGA.
- Se for Pré-paga é necessário criar a tabela e no momento da criação do PDV fazer o vínculo com o PDV. Uma tabela de preço pode estar vinculada a mais de um PDV.
O cadastro as lojas ou condomínios é feito no menu clientes e Ponto de Vendas.

Quando um cliente faz a solicitação de cancelamento a exclusão do ponto de venda neste cadastro faz com que as maquinas e todas as compras e acessos vinculados a aquele PDV fiquem bloqueados.
Alguns detalhes importantes:
Tipo de ponto de venda: operação própria, franqueado ou gerenciamento.
Possui reserva: Usado somente em Condomínios. Os consumidores podem reservar um horário para a utilização das máquinas. Para as reservas existem regras que devem ser observadas:
- Antecipação: tempo máximo que posso fazer a reserva de antecipação. Não posso fazer a reserva com menos de x tempo.
- Atraso: Tempo máximo que posso me atrasar para dar início a liberação de máquina levando em consideração o horário da reserva.
- Cancelamento: tempo máximo que posso fazer o cancelamento antes do horário de reserva da máquina.
- O valor da cobrança da reserva é criada na tabela de preço
Pós Pago: Para condomínio que fazem a escolha do pós pago, o sistema fará a marcação de sempre “permitir saldo
negativo”. Não existe relatório financeiro para pós pago. As cobranças são de responsabilidade do condomínio. No sistema o gestor pode extrair o relatório de uso por consumidor.
Permite saldo negativo: Além de ser usado por condomínios pós pago também pode ser usado por pré pago.
Cadastro de Operadores (IMPLANTAÇÃO)
Operadores são as pessoas que acessam a ferramenta para fazer a gestão. Temos 4 tipos:
- Ponto de Venda: São os operadores que podem acessar todos os relatórios do site de gestão e fazer a liberação de máquinas manualmente. Eles não podem fazer mudanças de chaves e não podem fazer ajustes nos cadastros de chaves de gateway de pagamento, cadastro e administração de placas e máquinas.
- Gerencia: Pode fazer e ver tudo que o ponto de venda faz além de manutenção nas placas. Pode também fazer o cadastro de novos pontos de venda. Além disso tem acesso aos relatórios financeiros de todos os pontos de venda. Tem acesso ao estorno e chargeback no site de gestão.
- Suporte: Pode fazer o que a gerencia faz além de simular máquinas.
- Master: Módulo de Clientes e Módulo de Equipamentos. Todos os operadores que podem fazer a gestão das contas incluindo colocar e retirar permissões. No aplicativo desktop esta permissão esta vinculada somente ao time Ideologica (Campanari e Luciana).
Validação de Placas (SUPORTE)
Para saber se uma Placa está corretamente configurada:
- Verificar se a maquina aparece como disponível no menu equipamentos > painel de máquina
- Pegar um leitor qualquer de QRCode e verificar se o código é composto pelo números da loja e da placa. Assim é possível saber se esta configurado e vinculado corretamente.
Compra de Créditos:
- Compra de credito é realizada pelo aplicativo ou pelo site.
- Compras vias boleto: compensação em até 72 horas.
Estorno de Compra e Chargeback
Liberação de Máquinas:
- A liberação de máquinas é feito no autoserviço
Relatório de Uso
Cadastro de Cartões
Cadastro de Clientes
MANUAL EM ANDAMENTO (POWER POINT DE TREINAMENTO DO CAMPANARI)
Created with the Personal Edition of HelpNDoc: Easily create EBooks