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

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;

Unidade: Filial vinculada ao produto.


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

Image Added



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.

 Image RemovedImage Added

 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.


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


...