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 FinanceirosNa 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! 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.
Aos Parâmetros da Integração VTEX, na aba: Dados Financeiros, deverão ser vinculadas as Neste item deverão ser informados os parâmetros correspondentes às formas de pagamento já cadastradas no SGE , sendo elas: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:
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 |
---|
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.
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.
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;
Unidade: Filial vinculada ao produto.
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:
title | Pedidos Boleto e PIX - Cálculo Comissão VINDI |
---|
Para pedidos que forem vendidos com as condições de pagamentos através de Boleto e PIX, os cálculos para comissão do Seller são diferentes das demais formas de pagamento.
O campo 'Valor Total Repasse' existente no Monitor de Vendas, descrito no item 'Anexo - Itens do Pedido' deste manual, será preenchido seguindo as regras abaixo:
Para essa regra está fixado no código os seguintes valores:
Sempre que um pedido for do tipo de pagamento boleto ou PIX e que esteja com o status ‘pronto para manuseio’ (tela identificação do Monitor de vendas), seguiremos as seguintes regras, para chegar no valor do repasse (comissão de vendas pela VINDI):
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 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
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:
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:
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 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 | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
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.
|