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

           Image Added

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:


         Image Modified


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

Image Added

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
titleMonitor 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
titleAnexo: 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
titleAnexo - 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
titleAnexo - 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
titleProcesso 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.

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/ Itens do Pedido.

Novo!

Image AddedImage Removed


Expandir
titlePedidos 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:

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



...