9421 - Colégio Santa Maria

Descrição do produto: Ecommerce Lista de Material com integração ao sistema RM Totvs

Endereço do site em produção: https://colsantamaria.sslbr.net/inicio

*Cliente pediu pra mudar o subdomínio para acesso ao site em 19/01/2022 - https://colsantamaria.sslbr.net/inicio2022

Domínio hospedado com a ControlP: www.lojacolsantamaria.com.br

Webmail: pedidos@lojacolsantamaria.com.br

Gateways: REDE e Itaú Shopline



Funções do projeto:
- Ecommerce Padrão;
- Ecommerce lista de materiais escolares;
- Importação de cadastro de produto e saldo de estoque do sistema RM Totvs;
- Exportação de cupom SAT emitidos para o sistema RM Totvs.


Finalidade:
1 - Disponibilizar as listas de materiais de cada ano letivo, para que o pai de aluno acesse da segurança de sua casa, confirme a compra dos materiais pelo site, e só compareça ao colégio para retirar os produtos.
2 - Ter funcionalidade secundária de Ecommerce Padrão, permitindo ao pai de aluno comprar produtos avulsos disponibilizados no site, produtos que não sejam obrigatoriamente integrantes de lista de material.

Característica de acesso inicial:

Ao acessar o domínio https://colsantamaria.sslbr.net/inicio , o usuário é direcionado automaticamente para tela de login.

Não é possível ver a vitrine do site ou seus produtos, sem estar logado. O site não será acessível para todas as pessoas, somente para os pais de alunos que tenham vínculo com o Colégio Santa Maria. Portanto, para um usuário fazer login no site, ele precisa ter cadastro prévio no Atendesmart.

Como se dá o cadastro dos pais e alunos:

Na retaguarda Atendesmart, dentro do módulo Cadastros > Tabelas > Importar lista de alunos , importaremos planilha Excel num padrão específico. Os dados dessa planilha Excel alimentarão a tabela PESSOA do Atendesmart, os pais de aluno serão cadastrados como clientes.

A planilha terá sete colunas, conforme imagem abaixo:
Nome do filho/aluno;
Número de matrícula/RA do aluno no colégio;
Código da série - Código da série é igual ao código de barra do produto Lista de Material, no cadastro Atendesmart;
Nome do responsável (pai/mãe/responsável pelo aluno);
CPF do responsável;
E-mail do responsável;
CLIFOR do responsável - CLIFOR é um código de identificação do pai de aluno no sistema Totvs RM. É necessário guardarmos essa informação pois, ao enviar movimentação de vendas de PDVtouch para Totvs RM, o Totvs identificará o cliente do cupom pelo CLIFOR;

*No Atendesmart, o aluno/estudante será salvo como um CONTATO dentro do cadastro do pai (cliente).
**No Atendesmart, o CLIFOR será salvo dentro do campo CONTROLE no cadastro geral da pessoa-cliente.
***Ao fazer upload da planilha, o sistema checará pelo Código da Série se a lista de material já existe. Antes de fazer upload da planilha de pais e alunos, é necessário cadastrar as listas de material.

Cadastro da lista de material:

Lista de Material é um produto do tipo KIT no Atendesmart.

O cliente precisa ter seu cadastro de produtos alimentado na retaguarda web. Com os produtos unitários cadastrados, são criados os KITs e alimentado no campo COMPOSIÇÂO do KIT a lista dos produtos pertencentes àquela lista.

As listas de materiais serão cadastradas uma para cada ano letivo do colégio: uma lista de material para jardim de infância, uma lista para 1º ano do Ensino Fundamental, uma lista para 2º ano do EF... e assim até a lista do 3º ano do Ensino Médio.

O código de barra do produto KIt-lista de material é uma informação reservada do sistema, será utilizada para vinculação com a PESSOA_CONTATO aluno/estudante.
O código de barra poderia ser numérico, não tem problema. Para facilitar as pesquisas, cadastramos o código da série/kit com o nome da série, por exemplo: 1ANO, 2ANO... 3ANOEM, etc.

Importação e Exportação de Dados para Sistema Totvs RM

Somente cupons SAT emitidos no nosso PDV são transmitidos para o sistema RM Totvs. Após emissão de cupom SAT, nosso sistema envia para o Totvs numeração de cupom fiscal, chave do cupom SAT, dados do cliente-consumidor, produto, preço, quantidades, impostos, etc...

Até a data de 21/01/2022 a integração Atendesmart-RMTotvs não contempla o envio de NFe , somente cupom SAT.
O cliente está em tratativas junto ao setor comercial da ControlP para adicionar a NFe nessa integração em futuras atualizações, mas até a presente data, nosso sistema só envia o SAT para o Totvs.


Na pasta compartilhada \\192.168.0.7\Anderson Aplicativos para testar\RM TOTVS o setor de Desenvolvimento disponibiliza arquivos para essa integração.

Como Funciona:

- Ao apertar o botão wsProdutos manual, o executável prjRMTOTVS puxa os produtos do sistema Totvs e dá um update ou insert na tabela de PRODUTO do Atende. Essa importação traz nome de produto, preço de venda, saldo de estoque, CFOP, CST ICMS, Aliq ICMS, CST PIS e COFINS.

- Ao apertar o botão wsMov manual, o executável prjRMTOTVS envia a movimentação de cupons SAT emitidos no nosso PDV para o sistema Totvs.
As movimentações de cupom SAT emitidos são enviadas diretamente do nosso banco local CONTROLP.FDB.

Cada vez que um cupom SAT é emitido, é criada uma fila de exportação dentro da tabela TBL_FILA_RM_TOTVS no banco local CONTROLP.FDB.
É pela ordem dessa fica que os cupons são enviados para Totvs.
Se limparmos essa fila, a ferramenta prjRMTOTVS não enviará nada.

- É possível parametrizar o executável prjRMTOTVS para executar as cargas de produto e exportação de cupons SAT de forma automática. Para tanto, entre nas configurações (senha do dia igual à do PDVtouch), na aba Geral, marcar Sincronização Automática = SIM. Voltar para tela inicial da ferramenta prjRMTOTVS e apertar o botão para iniciar sincronização.

*Data de corte: é um registro da última atualização executada. Ao ativar Sincronização Automática, marcar como data anterior ao dia da ativação da Sincronização.

**O executável prjRMTOTVS já está programado para, assim que a Sincronização Automática estiver ativa, executar a carga em produto e a carga em exportação de movimentos 1 vez por dia, todos os dias às 5h da manhã.

***Como se trata de aplicativo desktop, para a Sincronização funcionar de forma automática, dependerá de o PC servidor Atendesmart nunca ser desligado.

Link para baixar modelo da planilha de cadastro de pai de aluno (clientes do Atendesmart)

https://app.box.com/s/fy7txs0v75turk81g49cd18z1q3kl6xv

Primeiro acesso de usuário no site

No primeiro acesso, o usuário é obrigado a preencher seus dados cadastrais (telefones e endereço) para poder avançar para lista de material de aluno.

Meios de entrega para Ecommerce

Estão cadastrados na retaguarda web do cliente, no módulo Transportadoras
- Correios (Sedex)
- Transportadora (Entregar na residência - transportadora própria)
- Click e retire
- Entregar na sala de aula
- Drive Thru (não está ativa no Ecommerce)

Ao ativar/inativar na retaguarda web, a opção de entrega fica ativa/inativa no Ecommerce (com exceção do Drive Thru).

Controle de estoque de produtos para venda no Ecommerce

Quando em modo lista de material, no cadastros dos produtos, marcar parâmetro "Baixa Estoque = NAO" - o site vai permitir comprar até 1000 unidades de cada produto.

Quando em modo Ecommerce, marcar parâmetro "Baixa Estoque = SIM" - o site vai limitar compra de acordo com saldo disponível no Atende.

Cadastrar mensagem para Ecommerce - retirar pedidos no Colégio.

Nos dados da empresa > Ecommerce > campo "Mensagem Retirada" é possível configurar uma mensagem/aviso que será exibida na página https://colsantamaria.sslbr.net/formas_pagamento e também será exibida no corpo do e-mail de aviso de pedido ao cliente, dando instruções ao comprador sobre a retirada do seu pedido.

Cupom de desconto para o Ecommerce Santa Maria

O Ecommerce específico do Santa Maria pode usar o cupom de desconto (Atendesmart) normalmente como qualquer Ecommerce, detalhamento do funcionamento do cupom de desconto nesse forum - https://atendesmart.forumeiros.com/t442-cupom-de-desconto-para-ecommerce-app-e-web-delivery?highlight=cupom

Particularidades no uso do cupom de desconto pelo colégio Santa Maria:

1 - Dar desconto a funcionários (normalmente desconto de 10%, amarrado ao cadastro de um cliente do colégio, o desconto no site do Santa Maria só se aplica em cima do PIX ou BOLETO BANCARIO, o cupom de desconto no Ecommerce Santa Maria ignora propositalmente o pagamento via cartões da Rede, essa particularidade foi solicitada pelo sr Alexandre.

2 - Dar desconto a bolsista, no caso do bolsista, o cupom é vinculado ao cadastro de cliente, é cadastrado com valor = zero e tipo = % desconto, dessa forma, ao aplicar o cupom no site, o site permitirá transmitir e finalizar seu pedido SEM PAGAMENTO, o pedido será recepcionado na retaguarda web normalmente com pagamento identificado como BOLSISTA (a cobrança ocorre internamente entre e loja do colégio e o estudante bolsista).

Atualização Integrador Totvs.exe - 23/11/2023

Atualizada versão do Integrador para identificar a série do equipamento SAT que emitiu cupom, e transmitir ao RM Totvs a respectiva série junto ao cupom SAT.

As séries dos equipamentos SAT em uso são parametrizadas junto ao Integrador Totvs.exe

Na aba " De > Para " , dentro da chave [SERIESAT] , à ligar a Série SAT (esquerda) ao código respectivo à Série SAT do RM Totvs (direita, esse código respectivo é o sr Alexandre que vai informar).

Já deixar parametrizado as séries SAT de todos os equipamentos SAT que o cliente possuir.

Ativação do segundo Ecommerce - Colégio Santa Maria agora tem 2 Ecommerces:

9421 - Colégio Santa Maria tem 2 Ecommerces:

- https://colsantamaria.sslbr.net/ - funciona como Ecommerce Padrão;

- https://kitescolarcsm.sslbr.net/ - Funciona para listas de material, e só é ativado nas épocas de "volta às aulas", sua ativação/desativação se dá por solicitação do cliente, onde é gerada tarefa para setor de desenvolvimento.

O Suporte não tem ferramenta para Ativar/Desativar o site de lista de material, deve ser aberta tarefa para setor de desenvolvimento.

Atualização 26/04/2024 - o Suporte consegue Ativer/Desativar a transmissão de listas de material pelo Ecommerce.

Atendesmart - Dados da empresa - Módulo Ecommerce:
- botão Modo Ecommerce: Sim/Nao - esse botão mostra ou esconde a opção no site de visualizar "meus filhos/minhas listas"
- Data limite lista: se estiver vazio ou data inferior a data de hoje, não permite aos usuários transmitir novas listas de material.