9421 - Colégio Santa Maria

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

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 pode ser acionada nos dados da empresa.

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

Webmail: pedidos@lojacolsantamaria.com.br

Gateways: REDE, Itaú Shopline (descontinuado) e Pix Shipay.


Funções do projeto:
- Ecommerce com acesso restrito;
- Ecommerce lista de materiais escolares;
- Importação de cadastro de produto e saldo de estoque do sistema RM Totvs;
- Importação de cadastro de Pessoas (alunos e responsáveis) do sistema RM Totvs;
- Exportação de cupom SAT emitidos para o sistema RM Totvs;
- Exportação de NFe emitidos para sistema RM Totvs.


Finalidade:

1 - Disponibilizar em plataforma web as listas de materiais no início 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 - Disponibilizar plataforma de Ecommerce aos pais de alunos para compra produtos da loja oficial do colégio, produtos não-pertencentes à lista de material que estarão disponíveis para compra em todo o ano letivo.

Acesso Ecommerce somente para usuários com vínculo ao Colégio:

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.

Cadastro dos pais e alunos por planilha Excel:

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 de Pais e Alunos por importação automática

Hoje o Atendesmart faz importação de cadastro de pais e alunos diretamente do sistema RM através de consumo API / ferramenta prjRMTotvs.exe (método não confirmado com a CWD).

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

Junto à estrutura do servidor Atende Loja, foi implantada ferramenta executável prjRMTotvs.exe . Seu funcionamento é como um "Integrador" entre API do sistema RM Totvs com o banco de dados local do PDV ( CONTROLP.FDB ).

Funções;
- Importar cadastro de produtos de RM Totvs para nosso sistema;
- Exportar para sistema RM Totvs os cupons SAT e as NF-e emitidas pelo Atende.
*Não são exportados os XML SAT e NF-e no padrão da SEFAZ - são exportados XML específicos que contém tags como número documento, produtos, valores etc, o layout desse XML de exportação foi desenhado pelo cliente de acordo com o padrão do sistema RMTotvs (como um JSon). Sendo assim, quando o cliente precisa de XML dos documentos fiscais emitidos, os resgata no Atende/pasta do PDV.
**Não está claro se a importação de cadastro de Pessoas é feita pelo executável prjRMTotvs.exe ou se é feita por trigger web.

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 fila que os cupons são enviados para Totvs.
Se limparmos a fila na tabela TBL_FLA_RM_TOTVS , a ferramenta prjRMTOTVS não enviará nada.

- É possível parametrizar o executável prjRMTOTVS para executar as cargas de exportação de cupons SAT de forma automática, a cada XX minutos. 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ã. Essa configuração de carga automática em produtos e exportação de XML está fixa na programação do executável.

***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 pode ser acionada pelos dados da empresa.

Atualização 26/04/2024 - o Suporte consegue Ativar/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.

Atualização 11/10/2024 - Separação dos parâmetros Modo Ecommerce Sim/Não por site

Ecommerce (SM) tem que deixar como SIM, e data vazia.

Ecommerce (KIT) tem que deixar como NAO e colocar a data limite que a lista irá aparecer no site para compra.

Observação em produto por Lista de Material - observação do Professor

Cada Lista de Material é uma Composição/Kit no Atendesmart.

Agora é possível cadastra uma observação junto ao produto pertencente de determinada Lista de Material.

Exemplo: "o professor da 1ª série ensino fundamental solicitou um caderno de folhas pautadas, e pede que para a turma dele, os pais escrevam na contra-capa o nome do aluno."

Essa observação vai aparecer somente para o produto cadastrado e somente na lista cadastrada, para que apareça nas demais listas, tem que ser cadastrado lista a lista.

É possível cadastrar observação de até 100 caracteres para cada produto.