...
Nome do Cliente: Confederação Nacional da Indústria - SENAIObjetivo
Este documento foi elaborado para orientar aos usuários-chave SENAI DN sobre os requisitos e funcionalidades da Integração TOTVS Educacional (SGE) e a Plataforma VTEX, que possibilita a integração de vendas das ofertas de cursos, compreendendo o processo de matrícula e a geração da baixa de lançamento financeiro, de acordo com as informações da venda e pagamento.Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários-chave para o projeto Integração VTEX do SENAI DN.Metodologia
Este material tem como base a visão prática e completa do Processo Customizado, da área Educacional através da Customização existente - FS008537 (AACPD0) - Integração VTEX - Informações Financeiras.
A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional (SGE). Sempre que houver alguma atividade a ser realizada no sistema, as suas funcionalidades e rotinas serão explicadas com detalhe.
| 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);
- | ||
| 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 alun Importante: Não está previsto neste escopo a adequação das integrações entre SGE e Backoffice (Protheus, Dynamics, etc.). O regional precisará se adequar para que as informações financeiras sejam enviadas aos backoffices correspondentes. |
| Expandir | ||
|---|---|---|
| ||
Liberação dos Anexos Customizados na Árvore de Perfil:
|
| Expandir | ||
|---|---|---|
| ||
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 | Parâmetros 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:
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 | ||
|---|---|---|
| ||
O processo de consulta de pagamentos VTEX, identifica os dados associados aos pagamentos das vendas realizadas e/ou canceladas. O processo poderá ser executado manualmente ou agendado. Para acesso manual, o menu está | ||
| Expandir | ||
| ||
O processo de consulta de pagamentos VTEX, identifica os dados associados aos pagamentos das vendas realizadas e/ou canceladas. O processo poderá ser executado manualmente ou agendado. Para acesso manual, o menu está disponível em: TOTVS Educacional | Sistema Indústria | Integração VTEX | Consulta Pagamentos VTEX. 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 | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
| Expandir | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
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.
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;
Nome: Nome do responsável financeiro; Tipo de Documento: CPF/CNPJ; E-mail: Endereço de e-mail do responsável financeiro; CPF/CNPJ do Responsável: Inscrição CPF/CNPJ do responsável financeiro; Endereço completo: Endereço do responsável financeiro, incluindo CEP, Logradouro, Número, Complemento, Bairro, Estado, País, Cidade; Telefones: Telefones do responsável financeiro, incluindo telefone principal, telefone celular e telefone comercial. A aba 'Dados do Cliente', poderá ser editada pra atualização do cadastro. 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.
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.
|
| 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.
Ao finalizar a inscrição/matricula no Portal de inscrição do Processo Seletivo é realizada a seguintes ações:
Expandir | | ||||||||||
|
| Aviso | ||
|---|---|---|
| ||
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: 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. |
| title | Baixa 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.
Após a execução, os registros relacionados à baixa de lançamento financeiro como: Data de Criação, Usuário Responsável, Dados Enviados, Dados Recebidos, Mensagem de Erro e Status do Registros na Integração ficarão armazenados na tabela de LOG.
| Aviso | ||
|---|---|---|
| ||
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. |
| 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).
| title | Reprocessamento 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, ao Contrato Financeiro é possível realizar o Reprocessamento de 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
| title | Anexos 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, como código e descrição;
Lançamento Baixado: Campos preenchido automaticamente a partir da verificação da baixa de lançamento financeiro.
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.
. 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).
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. 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: 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 visualize os dados da matrícula, poderá acessar/consultar os dados do candidato através da aba 'Dados do Aluno'. |
| 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.
| ||||||||||||||||||||||||||||||||||
| 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. Ao executar a venda, são realizadas as verificações relacionadas às ofertas disponíveis na plataforma VTEX, considerando:
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 Pendentes na tela do Itens do Pedido. 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 dos Anexos: Matriculas (na tela de itens do Pedido) 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 poderá marcar manualmente a flag: Matricula Efetivada. Quando a Flag for marcada o campo: Usuário Responsável será preenchido automaticamente com o login do usuário responsável pele efetivação. |