Histórico da Página

...

Expandir

title	Parâmetros da Integração

Novo!

Aba Parâmetros Gerais

Nesta aba foi adicionado um novo parâmetro para o usuário informar a URL do Processo Seletivo:

URL Processo Seletivo: o usuário deve definir qual é a URL base do Portal, incluindo a barra no final. Exemplo: Esse parâmetro é necessário para os Regionais que possuem vários servidores diferentes para o portal.

Observações: a URL do Processo seletivo deverá ter essa estrutura sem a / ao final

Aba Dados Financeiros

Será disponibilizado nos Parâmetros da Integração VTEX, a aba Dados Financeiros. O usuário deverá informar nesta aba, as formas de pagamento que serão utilizadas no processo de baixa automática de lançamentos financeiros no TOTVS Educacional.

A parametrização está disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX | Parâmetros | Dados Financeiros

Na interface, os parâmetros serão armazenados por contexto (Coligada, Filial e Nível de Ensino), para os quais o usuário deverá efetuar as seguintes parametrizações:

Neste item deverão ser informados os parâmetros correspondentes às formas de pagamento já cadastradas no SGE, sendo elas:

Boleto: Código da forma de pagamento referente ao Boleto;
PIX: Código da forma de pagamento referente ao PIX;
Cartão de Débito: Código da forma de pagamento referente ao Cartão de Débito;
Cartão de Crédito: Código da forma de pagamento referente ao Cartão de Crédito.

Novo!

Motivo de baixa - Boleto: Lista de motivo da baixa cadastrada no SGE e o usuário deverá preencher para cada forma de pagamento.
Motivo de baixa - Cartão de Débito: Lista de motivo da baixa cadastrada no SGE e o usuário deverá preencher para cada forma de pagamento.
Motivo de baixa - Cartão de Crédito: Lista de motivo da baixa cadastrada no SGE e o usuário deverá preencher para cada forma de pagamento.
Motivo de baixa - PIX: Lista de motivo da baixa cadastrada no SGE e o usuário deverá preencher para cada forma de pagamento.

Para integração nativa entre RM e Protheus no mesmo momento em que é enviado o meio de pagamento de acordo com a forma de pagamento (boleto, pix, cartão de crédito ou débito), a customização também irá enviar o Motivo da Baixa com os códigos correspondentes informados nos parâmetros. Esta informação não fica armazenada em tabelas do RM, ela é preenchida no momento em que a baixa acontece é enviada diretamente para o Protheus através do XML da integração.

Aviso
Não foi realizado tratamento para integrações que não sejam a nativa (outros backoffices ou Protheus) .

Aba: E-mail

Nesta aba é possível parametrizar todos os dados necessários para o usuário definir um textão padrão do envio automático de e-mail (para o responsável do curso) , nos casos em que o número de vagas disponíveis para a oferta de curso tenha se esgotado e existam candidatos/inscritos com pendência de matrícula.

Aviso
O SGE não garante o recebimento do e-mail, já que não é possível saber se o endereço do destinatário existe ou se a caixa está cheia, impedindo o recebimento. Será possível mapear apenas o envio.

Aba: E-mail Link de Matrícula

Nesta aba, é possível parametrizar todos os dados necessários para o usuário definir um textão padrão do envio automático de e-mail, nos casos em que o aluno que ainda não efetivou sua matrícula e/ou para aqueles que tiveram erro durante o processo de matrícula.

Novo!

Foram adicionados dois novos campos para configuração de envio de email:

Intervalo de horas/minutos para envio de email: o usuário deverá especificar as horas/minutos a serem considerados como intervalo entre cada envio de e-mail do link de matrícula.
Número máximo de envio de email: o usuário deverá definir a quantidade de vezes que um email deverá ser reenviado para o aluno. Quando atingir esse valor o aluno não receberá mais o email com o link de matrícula.

Exemplo de Agendamento Automático:

O processo está configurado para exportar, a cada duas horas, os dados para VTEX, incluindo o e-mail para aluno com o link de matrícula.

Após duas horas (na próxima execução do processo), ele será ajustado para identificar se poderá enviar o e-mail neste momento. Caso o intervalo de horas para o envio de email ainda não tenha sido atingido (superior a 2 horas), ele não poderá ser enviado neste processamento. Além disso, caso o número máximo de envio de e-mail seja atingido, o email também não poderá ser enviado.

O período de intervalo em horas, o número máximo de envio e a recorrência de agendamento serão definidas por parâmetros.

Além disso foi criado uma nova tag para concatenação dos cursos e link da matrícula dos mesmo para (Parametros|E-mail Link de Matrícula|Template e-mail), mantendo as tags individuais das mesmas.

Informações

Este parâmetro é armazenado por Filial.

O parâmetro e-mail link de matrícula faz parte do Projeto FS008837.

...

Expandir

title	Monitor de Vendas - Pagamentos VTEX

No Monitor de vendas, é possível visualizar os dados associados aos pagamentos provenientes de inscrições/vendas efetuadas na plataforma VTEX.

A visualização da relação de pagamentos está disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX l Monitor de Vendas.

A tela do Monitor de Vendas, reúne as seguintes informações:

Aba Identificação: Nesta aba estão relacionados os dados relacionados ao pedido, tais como:

Número do Pedido: Código identificador do pedido gerado no VTEX;

Data da venda: Data de processamento da venda;

Status do Pedido: Pronto para manuseio; Preparando entrega; Pagamento Aprovado; Faturado; Cancelado ou Pedido confirmado (Seller).

Valor do Pedido: Valor do pagamento efetuado;

Valor Pago: Valor incluindo desconto (caso exista);

Valor do Desconto: Valor do desconto aplicado;

Valor Total Repasse: Soma dos valores de repasse de cada item vinculado ao pedido;

Nome Seller: Nome do Seller que realizou a compra;

Canal de Venda: Onde será informado se a venda foi proveniente de oferta B2B ou B2C;

Cliente Fornecedor: Este campo ficará habilitado apenas para vendas proveniente de oferta B2B.

Aviso
Os campos Status Protheus e Nome do Seller, são exclusivos do SENAI DN.

Aba Dados Cliente: Nesta aba estão listados os dados relacionados ao Responsável Financeiro vinculado ao pedido, tais como:

Nome: Nome do Responsável Financeiro que realizou a compra no VTEX;

Tipo de Documento: CPF/CNPJ;

E-mail: Endereço de e-mail do Responsável Financeiro que realizou a compra no VTEX;

CPF/CNPJ do Responsável: Inscrição CPF/CNPJ Responsável Financeiro que realizou a compra no VTEX;

Endereço completo: Endereço do Responsável Financeiro que realizou a compra no VTEX, incluindo CEP, Logradouro, Número, Complemento, Bairro, Estado, País, Cidade;

Telefones: Telefones do Responsável Financeiro que realizou a compra no VTEX, incluindo telefone principal, telefone celular e telefone comercial.

A aba 'Dados do Cliente', poderá ser editada pra atualização do cadastro.

Aviso

A edição dos dados na aba Dados do Cliente, só poderá ser realizada por um usuário com as devidas permissões. Essa permissão é defina na árvore nativa de Perfis. Conforme exemplo abaixo:

Expandir

title	Anexo: Histórico de Alteração de Dados - Cliente

Sempre que houver alteração nos dados do cliente (conforme citado acima), será gravado no Anexo Histórico de Alteração de Dados - Cliente.

O anexo estará disponível no Monitor de Vendas e trará os campos abaixo:

Dado alterado: será exibido o nome do campo que sofreu alteração;

Dado Anterior: será exibido o dado registrado anteriormente (conforme consulta feita na plataforma VTEX);

Dado Atual: será exibido o dado atual (com a modificação realizada pelo usuário);

Usuário: será exibido o usuário que realizou a alteração.

Será apresentado na grid uma linha para cada registro alterado.

Expandir

title	Anexo - Pagamentos

Anexo - Pagamentos no registro de Pedidos do Monitor de Vendas:

Neste anexo estão relacionados os dados vinculados ao pagamento do pedido, tais como:

Data de Pagamento: Data do pagamento efetuado no VTEX;

Número de Parcelas: Quantidade de parcelas;

Modalidade do pagamento: Boleto, PIX, Cartão de Crédito ou Débito;

Nosso Número: Nosso número do boleto gerado;

Código de barras do Boleto: Código de barras do boleto;

NSU: NSU cartão de crédito utilizado no pagamento;

Final Cartão: Últimos dígitos cartão de crédito utilizado no pagamento;

Código da Transação: Código de autorização da compra gerado pelo gateway;

Id da Transação (TID): ID da transação (Cartão de crédito e PIX);

Valor do Pedido: Valor do pagamento efetuado;

Valor total Venda: Valor incluindo desconto (caso exista);

Valor Desconto: Desconto aplicado.

Expandir

title	Anexo - Itens do Pedido

Cada Pedido pode contar um ou mais itens. A visualização da relação de Itens do Pedido, estará disponível no Anexo do Monitor de vendas:

TOTVS Educacional | Sistema Indústria | Integração VTEX l Monitor de Vendas l Anexos l Itens do Pedido.

Neste anexo estão relacionados os dados vinculados aos itens/produtos do pedido, que podem ser visualizados separadamente, tais como:

Referência da Turma: Código referência SKU;

SKU: SKU da Turma;

Produto: Identificador do Curso;

Turma: Nome da Turma;

Valor: Valor do item/produto;

Valor Venda: Valor incluindo desconto (caso exista);

Valor Desconto: Desconto aplicado (caso exista);

Valor Repasse: Valor de comissão repassado ao DN por uma venda de Seller;

CNPJ Seller: CNPJ do Seller que realizou a venda na loja principal;

Nome Seller: Nome do Seller que realizou a venda na loja principal;

Qtde. de Vagas adquiridas: Quantidade de vagas adquiridas (campo disponível apenas para pedidos B2B).

Unidade: Filial vinculada ao produto.

Link de Matrícula: URL para inscrição no Curso (Campo indisponível para vendas de Seller/ Parceiro).

Copiar: Função de copiar o link de matrícula informado no campo.

Para pedidos realizados por Seller/Parceiro, onde não está disponível o SKU (Turma), não será possível informar o link de matrícula e o campo ficará oculto.

Estes casos serão sinalizados pela marcação da campo checkbox, conforme imagem abaixo:

Expandir

title	Processo para envio de e-mail (Link de matrícula)

O processo permite enviar ou reenviar o e-mail para os alunos com o link da matrícula, nos casos em que o aluno ainda não efetivou, ou para os alunos que por algum erro não conseguiram concluir o processo de matrícula.

O processo está disponível no Menu: TOTVS Educacional | Sistema Indústria | Integração VTEX | Envio de e-mail de link de matrícula.

Novo!

Ao executar o processo serão consideradas as seguintes novas regras de envio:

Intervalo de horas/minutos para envio de email: será considerado como intervalo entre um envio de email e outro.
Número máximo de envio de email: será considerado a quantidade máxima de vezes que um email deve ser reenviado para o aluno.

Aviso
Só serão enviados e-mails para pedidos com status faturado, campos matrícula efetivada desmarcado e URL de matrícula preenchido no campo link de matrícula.

Esse processo poderá ser agendado, conforme recurso nativo, executado manualmente pelo Menu citado acima, ou diretamente pela tela do Monitor de Vendas.

Novo!

O Monitor de Vendas será foi alterado para enviar informações do link de matrícula no Pedido e não mais no item, agrupando todos os link de matrícula num único e-mail, o novo menu ficará disponível em: TOTVS Educacional |Sistema Indústria | Integração VTEX | Monitor de Vendas | Processos | Envio de Email - Link de Matrícula.

Ao executar o processo serão consideradas as seguintes novas regras de envio:

1- Para os pedidos com mais de um item vinculado, cada item irá possuir um link de matrícula, porém os links serão encaminhados em um único email de forma agrupada por pedido.

Ao exibir o link de matrícula a customização deverá concatenar o link com o nome do curso, para facilitar a visualização do aluno.

2- Para pedidos originais de Plano de assinatura, o processo não enviará o email.

Ao final da realização do processo, será exibido um log com os e-mails enviados e eventuais erros apresentados. O usuário deverá corrigir a informação e realizar novamente o processo de envio.

Aviso
O registro de log será modificado para refletir o envio de e-mails por pedido e não mais por itens. Apesar da alteração, a funcionalidade permanecerá inalterada.

Expandir

title	Pedidos B2B

Para pedidos de Pessoa física, onde o aluno já realiza a matrícula através do VTEX, a alteração de status do pedido para 'entregue' acontece quando a matrícula é efetivada no SGE.

Para os pedidos de Pessoa Jurídica, a venda acontece no VTEX, mas o comprador não possui opção de realizar a matrícula. Neste caso, a informação da venda chegará no SGE através do processo de Consulta de Pagamentos VTEX. Portanto, será este processo de consulta que deverá disparar a alteração de status do pedido para 'entregue' no VTEX.

Em resumo, segue fluxo do Pedido Pessoa Jurídica:

Cliente realiza Pedido VTEX.
SGE Consulta Dados do Pedido e Pagamento.
SGE grava os dados no Monitor de Vendas.
SGE envia dados da fatura (fictícia) para VTEX e altera o status do pedido para 'Entregue'.

Expandir

title	Controle de Matrículas

Para que o uma Inscrição/Matrículas seja finalizada, será realizada algumas validações referentes à compra/pagamento na plataforma VTEX como:

Disponibilidade de vagas;

Geração de Lançamentos Financeiros;

Baixas e vinculação do Responsável Financeiro;

Turmas com vagas Esgotadas;

Matrículas Pendentes por erro.

Expandir

title	Matrícula em Turmas com Vagas esgotadas

Ao avançar para a etapa de matrícula após a confirmação de pagamento, a customização irá validar/contabilizar o número de vagas da turma de oferta com o número de matrículas já realizadas. As vagas disponíveis na turma podem ser verificadas no cadastro da Turma, através dos campos: Número máximo de alunos e Alunos matriculados.

Havendo disponibilidade de vagas, a matrícula será efetivada/concluída no TOTVS Educacional (SGE).
Porém, se já atingido o número de candidatos/inscritos às vagas ofertadas, será apresentada uma mensagem de alerta para que o candidato/inscrito aguarde o contato da secretaria escolar, como apresentamos no cenário a seguir.

O controle de matrículas em turma com vagas esgotadas, reúne as informações referentes à compra/pagamento na plataforma VTEX do candidato/inscrito que não teve a sua matrícula efetivada no TOTVS Educacional (SGE), devido a indisponibilidade de vagas da turma de oferta de curso. Os dados armazenados durante a inscrição serão utilizados pela secretaria escolar no processo manual de efetivação da matrícula.

Estado

colour	Green
title	Exemplo:

Turma: APP.CPI.001.I (Aperfeiçoamento Profissional em Costureiro Industrial do Vestuário).
Vagas: 03
Relação de Candidatos/Inscritos:

Candidato/Inscrito 01: Matrícula não-efetivada (aguardando confirmação de pagamento). Gerado boleto bancário via plataforma VTEX;
Candidato/Inscrito 02: Matrícula efetivada. Pagamento via cartão de crédito na plataforma VTEX;
Candidato/Inscrito 03: Matrícula efetivada. Pagamento via cartão de crédito na plataforma VTEX;
Candidato/Inscrito 04: Matrícula presencial (Via secretaria escolar).

Diante o cenário, o candidato/inscrito 01 aguarda a confirmação de pagamento para que possa prosseguir à sua matrícula.
Já os demais candidatos/inscritos 02 e 03 tiveram as matrículas efetivadas no TOTVS Educacional (RM) por terem realizado pagamento via cartão de crédito.

Assim, o candidato 04 que compareceu a secretaria escolar, teve também a sua matrícula efetivada no TOTVS Educacional (RM), uma vez que no momento do seu comparecimento, o candidato/inscrito 01 ainda não prosseguiu à efetivação da matrícula devido ao período de confirmação/compensação do pagamento realizado via boleto bancário.
Considerando que as vagas da turma foram assim preenchidas, após o período de confirmação/compensação do pagamento do boleto bancário, ao prosseguir à finalização de sua matrícula, será apresentada ao candidato/inscrito 01 a mensagem (padrão) de alerta:

Desta forma, a customização armazenará através do Monitor de Vendas, os dados cadastrais do aluno, bem como os dados e status de matrícula, pagamentos e responsável financeiro.
Já o responsável pelo curso será notificado via e-mail que proceda à verificação da pendência de matrícula para este candidato/inscrito (descrito no próximo item).

Analisada a situação, a secretaria escolar, poderá utilizar os dados armazenados durante a inscrição no processo manual de efetivação da matrícula.

Expandir

title	Envio automático de e-mail - Turmas com vagas esgotadas

Realizada uma venda via plataforma VTEX relacionada a oferta de turma cujas vagas já tenham sido preenchidas no TOTVS Educacional (SGE), será disparado um e-mail de notificação ao o endereço definido na parametrização de e-mail da customização. (Aba 'E-mail' descrito no item 'parâmetros').

O envio de e-mail ao responsável do curso visa a notificação de matrículas pendentes em turma com vagas esgotadas no TOTVS Educacional (SGE), para que a secretaria escolar possa realizar manualmente as matrículas necessárias.

A partir do recebimento do e-mail de notificação, o responsável deverá entrar em proceder à conclusão da matrícula no TOTVS Educacional (SGE), considerando que o aluno já efetuou o pagamento correspondente à oferta do curso.

Expandir

title	Matrículas - TOTVS Educacional (SGE)

O controle de matrículas pendentes por erro no TOTVS Educacional (SGE), é realizado a partir dos dados da inscrição do candidato/inscrito, incluindo os dados do pagamento realizado na plataforma VTEX que estarão disponíveis para que a secretaria escolar realize manualmente a efetivação da matrícula para que sejam utilizados pela secretaria escolar no processo manual de efetivação da matrícula.

O Monitor de vendas pagamentos VTEX, também realiza o armazenamento de dados/status associados às inscrições/vendas que não possuem vínculo de matrículas registrados no TOTVS Educacional (SGE).

Sempre que houver alguma pendência para o processamento de matrícula por falta de vagas na turma ou algum outro motivo de erro, essa matrícula pendente será gravada no Anexo Matrículas na tela do Itens do Pedido e exibido a mensagem padrão ao usuário:

Novo!

Atualmente o anexo de matrículas é preenchido no Monitor de Vendas apenas para as matrículas que apresentaram algum erro. A integração foi ajustada para garantir que todas as matrículas sejam gravadas no anexo ‘Matrículas’, independentemente do status.

Além disso a flag ‘Matrícula Efetivada’, foi ajustada a regra para que esteja disponível para marcações manuais pelo usuário, quando ele não estiver preenchido, independente do status do pedido (Matrícula Pendente, Matrícula Finalizada).

Após marcado, o status do pedido será alterado para “Matrícula Finalizada” e o campo não poderá mais ser desmarcado.

Ao marcar o “Matrícula Efetivada”, será exibida mensagem de confirmação para o usuário, já que a ação não poderá ser desfeita.

No caso das matrículas efetivadas pela loja VTEX, as regras do escopo original permanecerão inalteradas, com a flag "Matrícula Efetivada" sendo marcada automaticamente.

Na tela é possível visualizar:

Data da inscrição: Data de criação do registro;

Identificador: Identificador sequencial da inscrição;

Dados Recebidos: Relação dos dados recebidos pelo VTEX na URL de inscrição/matrícula, em formato JSON.

Status do Pedido: Preenchido inicialmente com o valor Pendente, mas que compreende os seguintes status:

Pendente: Pagamento realizado no VTEX sem matrícula gerada no SGE;

Pendente com Erro: Pagamento realizado no VTEX, sem matrícula gerada no SGE;

Vaga indisponível: Pagamento realizado no VTEX, sem matrícula no SGE por falta de vagas;

Baixa Pendente: Pagamento realizado no VTEX, matrícula gerada no SGE com baixa de lançamento pendente;

Matrícula Finalizada: Pagamento realizado no VTEX, matrícula gerada no SGE com lançamento baixado.

Após a conferência de dados e realizada a matrícula pelo usuário, para permitir a gestão e controle interno do usuário, serão automaticamente preenchidos os campos:

Matrícula Efetivada: Após efetivação da matrícula, a flag será automaticamente preenchida;

Data da Efetivação: Preenchida automaticamente com a data corrente na qual a matrícula foi realizada;

Usuário Responsável: Este campo será preenchido apenas quando a flag: matrícula efetuada for marcada manualmente.

Informações

Caso seja apresentado erro para o processamento da matrícula e que o erro não esteja relacionado ao número de vagas já preenchidas na turma de oferta, a customização irá gravar uma mensagem de erro na aba 'Mensagem' do anexo de matrículas:

Para que a secretaria escolar realize manualmente a efetivação da matrícula, o usuário do SGE poderá acessar/consultar os dados do candidato através da Aba 'Dados do Aluno':

Após a efetivação da matricula do aluno, para que se tenha um gestão eficaz das matriculas que estavam como "pendentes", o usuário deverá marcar manualmente a flag: Matricula Efetivada.

Quando o campo 'Matrícula Efetivada' for marcado: Usuário Responsável será preenchido automaticamente com o login do usuário responsável pele efetivação. Neste momento, será acionada API do VTEX para alteração do status do pedido para 'entregue', conforme imagem abaixo:

Expandir

title	Matrículas com Sucesso - Monitor de Vendas

As matrículas executadas com sucesso também são registradas no anexo 'Matrículas' do Item de Pedido do Monitor de Vendas.

Na tela é possível visualizar:

Data da inscrição: Data de criação do registro;

Identificador: Identificador sequencial da inscrição;

Dados Recebidos: Relação dos dados recebidos pelo VTEX na URL de inscrição/matrícula, em formato JSON.

Status do Pedido: Matrícula Finalizada: Pagamento realizado no VTEX, matrícula gerada no SGE com lançamento baixado.

Após a conferência de dados e realizada a matrícula pelo usuário, para permitir a gestão e controle interno do usuário, serão automaticamente preenchidos os campos:

Matrícula Efetuada: Após efetivação da matrícula, a flag será automaticamente preenchida;

Data da Efetivação: Preenchida automaticamente com a data corrente na qual a matrícula foi realizada;

Usuário Responsável: Este campo será preenchido apenas quando a flag: matrícula efetuada for marcada manualmente.

Para que a secretaria escolar visualize os dados da matrícula, poderá acessar/consultar os dados do candidato através da aba 'Dados do Aluno'.

Para que o uma Inscrição/Matrículas seja finalizada, será realizada algumas validações referentes à compra/pagamento na plataforma VTEX como:

Disponibilidade de vagas;

Geração de Lançamentos Financeiros;

Baixas e vinculação do Responsável Financeiro;

Turmas com vagas Esgotadas;

Matrículas Pendentes por erro.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 45

Nova versão 46

Chave