Projeto:FS008537 (AACPD0) - Integração VTEX - Informações Financeiras.
FS008837 -Integração VTEX - Link de matrícula / Envio de e-mail
Nome do Cliente: Confederação Nacional da Indústria - SENAI
...
Expandir | ||
---|---|---|
| ||
Permitir a integração das vendas realizadas através da plataforma VTEX com o SGE, considerando as parametrizações existentes no Processo Seletivo. O escopo dispõe das seguintes funcionalidades:
Refletir no SGE todos os pedidos gerados na plataforma VTEX com todos os seus dados de pagamento.
- Vincular as matrículas realizada aos seus pedidos no Monitor de Vendas; - Gravar os dados de Matrículas Pendentes - SGE (caso tenha ocorrido algum erro durante o processo). Possibilitando assim, que a secretaria entre em contanto com o aluno e finalize a matrícula de forma manual. - Vincular o pedido gravado no monitor de vendas ao contrato de matrícula de aluno; - Controle de Matrícula em Turma com Vagas Esgotadas; - Envio de E-mail - Turmas com Vagas Esgotadas (envio para o responsável do Curso);
- Gerar o Responsável Financeiro e vinculá-lo ao contrato gerado (quando não for o próprio aluno (parâmetro disponível na aba financeiro da área de interesse ofertada do PS); - Baixar Lançamentos Financeiros (Baixa automática da 1° parcela); - Reprocessamento de Baixa automática (reprocessar a baixa do lançamento financeiro para os casos de erro no processamento da baixa ao finalizar inscrição/matrícula do alunaluno. Importante: Não está previsto neste escopo a adequação das integrações entre SGE e BackofficeBackOffice (Protheus, Dynamics, etc.). O regional precisará se adequar para que as informações financeiras sejam enviadas aos backofficesBackOffices correspondentes. |
Expandir | ||
---|---|---|
| ||
Liberação dos Anexos Customizados na Árvore de Perfil:
aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção: Liberando Acesso aos Menus. |
Expandir | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
A Integração VTEX foi desenvolvida com parâmetros customizados para o registro de informações de dados específicos e necessários para a operação. A interface para configuração desses parâmetros
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çãoestá 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:
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.
| |||||||||||
Expandir | |||||||||||
|
Informações |
---|
Após os dados do pedido serem consultados e salvos no monitor de vendas (detalhado no item abaixo), é enviado uma confirmação do pedido ao VTEX para que o mesmo seja removido do Feed de Pedidos. O pedido só volta para o feed caso tenha alguma atualização nos dados, como mudança de status, por exemplo. Ao retornar para o feed, o pedido é identificado pela customização e atualizado no monitor de vendas. |
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: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.
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. |
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.
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:
title | Anexo: Histórico de Alteração de Dados - Cliente |
---|
Novo!
Aos Parâmetros da Integração VTEX, foi inserido um novo parâmetro: URL do Processo Seletivo, no qual deverá ser vinculada a URL base do Portal, incluindo a barra no final.
Este registro é essencial para atendimento os Regionais que possuem vários servidores diferentes para o portal.
O acesso está disponível em: TOTVS Educacional l Sistema Indústria | Integração VTEX l Parâmetros l Aba: Parâmetros Gerais.
Nota | ||
---|---|---|
| ||
A a URL do Processo seletivo deverá ter essa estrutura sem a / ao final. |
Aos Parâmetros da Integração VTEX, na aba: Dados Financeiros, deverão ser vinculadas as formas de pagamento já cadastradas no SGE que serão utilizadas no processo de baixa automática de lançamentos financeiros no TOTVS Educacional.
O acesso está disponível em: TOTVS Educacional l Sistema Indústria | Integração VTEX l Parâmetros l Aba: 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:
Novo!
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) . |
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.
O acesso está disponível em: TOTVS Educacional l Sistema Indústria | Integração VTEX l Parâmetros l Aba: E-mail
Campos a serem preenchidos:
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. |
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.
O acesso está disponível em: TOTVS Educacional l Sistema Indústria | Integração VTEX l Parâmetros l Aba: E-mail Link de Matrícula.
Novo!
Foram adicionados dois novos campos para configuração de envio de e-mail:
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 | |||||||
---|---|---|---|---|---|---|---|
| |||||||
O processo de consulta de pagamentos VTEX, disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX | Consulta Pagamentos, identifica os dados associados aos pagamentos das vendas realizadas e/ou canceladas. O processo poderá ser executado manualmente ou agendado, conforme a necessidade. Através desse processo é possível visualizar todos os pedidos existentes na fila, considerando os seguintes status:
O processo de Consulta de Pagamentos VTEX, busca as informações de vendas de pedidos realizados na loja e armazena os dados no Monitor de vendas. São consultados dados de pagamentos da política comercial B2C e B2B.
|
Expandir | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
Através do Monitor de Vendas, disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX l Monitor de Vendas, é possível visualizar os dados associados aos pagamentos provenientes de inscrições/vendas efetuadas na plataforma VTEX.
Aba Identificação: Nesta aba estão relacionados os dados relacionados ao pedido, tais como:
Aba Dados Cliente: Nesta aba estão listados os dados relacionados ao Responsável Financeiro vinculado ao pedido, tais como:
A aba 'Dados do Cliente', poderá ser editada pra atualização do cadastro.
|
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||
Para que o uma Inscrição/Matrículas seja finalizada, será realizada algumas validações referentes à compra/pagamento na plataforma VTEX, tais como:
| |||||||||||||||||||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||
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.
Turma: APP.CPI.001.I (Aperfeiçoamento Profissional em Costureiro Industrial do Vestuário).
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. 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 |
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.
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 |
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. Expandir |
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). 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.
Turma: APP.CPI.001.I (Aperfeiçoamento Profissional em Costureiro Industrial do Vestuário).
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. 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 |
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
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:
Para que a secretaria escolar realize manualmente a efetivaçãovisualize os dados da matrícula, o usuário do SGEpoderá acessar/consultar os dados do candidato através da Abaaba '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.
Aluno'. Para que o uma Inscrição/Matrículas seja finalizada, será realizada algumas validações referentes à compra/pagamento na plataforma VTEX como:
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: |
Expandir | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
Para matrículas realizadas com sucesso, a customização executa ás seguintes ações:
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.
|