Páginas filhas
  • Manual Operacional da Customização - Integração VTEX Informações Financeiras SENAI

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleControle 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
titleMatrí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
colourGreen
titleExemplo:

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
titleEnvio 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
titleMatrículas Pendentes - 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:


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 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.

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
titleMatrí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.




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.

Image Removed

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

Expandir
title
Matrícula em Turmas com Vagas esgotadas
Estado
colourGreen
titleExemplo:

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:

Image Removed

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
titleEnvio 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
titleMatrículas Pendentes - 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:

Image Removed

Image Removed

Image Removed

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 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.

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: 

Image Removed

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':

Image Removed

  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.

 Image Removed

 Quando a matrícula é registrada com sucesso no anexo acima, o campo 'Matrícula Efetivada' é preenchido de forma automática. Neste momento, será acionada API do VTEX para alteração do status do pedido para 'entregue', conforme imagem abaixo:

Image Removed

Expandir
titleGeração de Dados Financeiros e Pagamentos

Para matrículas realizadas com sucesso,  a customização executa ás seguintes ações:

  • Cadastro e vínculo do Responsável Financeiro no Contrato do Aluno;
  • Geração do lançamento financeiro da primeira parcela,
  • Baixa do lançamento, de acordo com as informações de pagamento efetuados na plataforma VTEX.

A geração de dados financeiros e pagamentos realiza a efetivação dos cadastros dos dados financeiros ao contrato do aluno e processa as baixas de lançamentos realizados provenientes da venda de cursos, conforme a configuração financeira do processo seletivo no TOTVS Educacional (SGE) para venda na plataforma VTEX.

Aviso

Todos os processos descritos acima estão condicionados à parametrização nativa do Processo Seletivo, disponível em: TOTVS Educacional| Processo Seletivo | Área de Interesse Ofertada. Como por exemplo:

  • Parâmetro 'Gerar Contrato';
  • Parâmetro Gerar Lançamento Financeiro e Parcelas';
  • Parâmetro Responsável Financeiro etc...
Expandir
titleGeração e Vínculo do Responsável Financeiro ao Contrato

Para os Processos Seletivos cujas ofertas configurem que o responsável financeiro não seja o próprio aluno, o cadastro do responsável financeiro será realizado a partir dos dados do cliente informado no momento de compra na plataforma VTEX e vinculado ao contrato gerado. Este cadastro considera a verificação, validação e unicidade do CPF//CNPJ, validando a existência de um cadastro cliente/fornecedor no SGE e, caso não exista, será realizada criação do mesmo.
O cadastro do responsável financeiro será realizado considerando as seguintes informações:

Cód. Cliente Fornecedor;

Nome Fantasia/Social;

Nome;

Classificação (Preenchido pelo SGE como Cliente);

Categoria (Preenchido pelo SGE como PF caso seja retornado na consulta do VTEX o CPF e como PJ caso tenha sido retornado um CNPJ);

CPF/CNPJ;

E-mail;

Endereço Completo;

Telefones.


A página do processo seletivo não permite que seja informado um responsável do tipo pessoa jurídica. No entanto, será possível receber um CNPJ de responsável financeiro o mesmo será incluído no cadastro do cliente com base nos dados consultados.


Aviso
titleObservação:

Para que o responsável financeiro seja o próprio aluno o parâmetro deverá estar marcado na aba financeiro da área de interesse ofertada do processo seletivo; conforme imagem abaixo. Neste cenário NÃO há ação customizada, o cadastro é feito de forma nativa.

Expandir
titleBaixa de Lançamento

A baixa de lançamentos financeiros e pagamentos é executada após a geração do contrato e lançamento financeiro da primeira parcela, visto que as matrículas que virão da VTEX para o SGE, já terão o pagamento confirmado na Plataforma.

A realização das baixas dos lançamentos financeiros serão realizadas no TOTVS Educacional (SGE), de acordo com as informações referentes à forma de pagamento (Boleto Bancário, PIX, Cartão de Crédito ou Débito), data de pagamento e valor pago. Para identificar o registro da forma de pagamento que será utilizado na baixa são consultados os parâmetros 'Dados Financeiros'.


Aviso
titleObservação:

Demais informações necessárias para para a baixa (conta caixa e moeda, por exemplo) deverão estar parametrizadas com valores defaults no TOTVS Educacional (SGE), sem necessidade da customização preencher tais campos.
O regional que optar pelo pagamento através do TOTVS Educacional (SGE), funcionalidade nativa, a customização não irá efetuar a baixa do lançamento financeiro automaticamente ao finalizar o processo de matrícula. Esse processo será automatizado apenas quando utilizar a integração do VTEX e a área de interesse do processo seletivo estiver parametrizada para gerar lançamento.

Aviso

Se o contrato possuir uma bolsa, os lançamentos financeiros são gerados considerando o desconto em todas as parcelas do plano de pagamento e não somente na 1° parcela;

Caso o TOTVS Educacional (SGE) possua integração com Protheus ou utilize o financeiro do TOTVS Educacional, a comunicação com o sistema financeiro utilizará as regras já existentes de integração, porém para integração com outros sistemas como AX, Dynamics e outros poderão ser necessárias alterações/implementações para atender essas especificidades. Tais alterações não serão tratadas neste escopo.


Caso seja apresentado erro no momento da baixa de lançamento financeiro, a informação também será gravada nos dados do contrato (anexos) que poderá ser consultado para execução do processo reprocessamento da baixa (descrito no próximo item).


Expandir
titleReprocessamento da Baixa

Para as situações em que, ao finalizar a inscrição/matrícula no TOTVS Educacional (SGE), proveniente de vendas de ofertas na plataforma VTEX, sejam apresentados erros no processamento de baixa no contrato financeiro é possível realizar o  Reprocessamento da Baixa.

No processo de Reprocessamento de Baixa, será reexecutada a baixa do lançamento financeiro, que por sua vez, armazenará um novo retorno.

Este processo está disponível em: TOTVS Educacional | Financeiro/Contábil | Contratos | Anexos l Dados do Pagamento l Processos l Reprocessamento Baixa.



Caso a baixa do lançamento não tenha ocorrido com sucesso, será gravado na aba histórico o status de erro.


Aba: Histórico:

A aba de histórico será preenchida na inclusão do registro e para cada tentativa de processamento, caso a baixa não tenha ocorrido com sucesso na inclusão. Os campos serão:

Data: Vincula a data do processamento da baixa de lançamento financeiro.

Status: Apresenta status de Sucesso ou Erro, de acordo com o processamento

Erro: Apresenta a mensagem de erro durante o processamento da baixa, caso ocorra.

Expandir
titleAnexos do Contrato - Dados de Pagamento

O armazenamento das informações relacionadas aos dados financeiros dos pagamentos referentes às matrículas efetuadas no TOTVS Educacional (SGE), provenientes de vendas de ofertas na plataforma VTEX, são associadas a um anexo ao Contrato Financeiro.


O anexo está disponível em: TOTVS Educacional | Financeiro/Contábil | Contratos | Anexos l Dados do Pagamento.


Nele serão apresentados os dados do pagamento realizados na plataforma VTEX, preenchidos automaticamente a partir da conclusão da inscrição/matrícula do aluno.

Aba: Identificação:

Dados do Pagamento: Dados referentes ao pagamento efetuado na plataforma VTEX.  Neste campo é vinculado o item do pedido referente aquela determinada matrícula. Ao abrir o registro, o usuário visualizará os dados do item do pedido.

Matrícula Manual: Para matrículas que não tenham sido realizadas de forma automática, o usuário deverá inserir de forma manual esse registro. Será exibido na lista, itens de pedidos relacionados aquela determinada matrícula.

Lançamento Baixado: Campos preenchido automaticamente a partir da verificação da baixa de lançamento financeiro. Esse campo só é preenchido quando a matrícula é feita de forma automática. 

Para matrículas manuais, não há preenchimento do campo.




Aba: Histórico:

A aba de histórico será preenchida na inclusão do registro e para cada tentativa de processamento, caso a baixa não tenha ocorrido com sucesso na inclusão. Os campos serão:

Data: Vincula a data do processamento da baixa de lançamento financeiro.

Status: Apresenta status de Sucesso ou Erro, de acordo com o processamento

Erro: Apresenta a mensagem de erro durante o processamento da baixa, caso ocorra.



...