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



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: 

  • Valor da taxa VINDI por boleto =R$1,78
  • Taxa VINDI por PIX = 0,70%
  • Valor mínimo da Taxa VINDI Por  PIX = R$0,70

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

  • Identificar o Valor Líquido: O valor líquido é a subtração do Valor Pago pelo o valor da taxa VINDI (seja por boleto ou PIX).
   Valor líquido do pedido Por Boleto= Valor Pago - Valor Taxa VINDI por boleto;                                                                                                                                                    Valor líquido do pedido Por PIX = Valor Pago - Taxa VINDI por PIX (respeitando o valor mínimo da taxa por PIX).
  • Comissão DN: Identificado o valor líquido será aplicado o percentual da Comissão DN em cima desse valor. O percentual aplicado será consultado na VTEX, como já é realizado para vendas por cartão. 

    

Exemplo 1 (Boleto):

Pedido ID: 122941

Valor Pago = R$100,00.

Valor Taxa VINDI - Por boleto = R$1,78 (essa taxa será descontada por pedido e não por item).

Valor líquido do pedido: R$100,00 - R$1,78 = R$98,22

Comissão DN:R$98,22 (valor líquido) x 5% (informação já consultada na VTEX)= 4,91.

Exemplo 2 (PIX):

Pedido ID: 122950

Valor pago = R$1,00.

Taxa VINDI -Por PIX = 0,70% (essa taxa será descontada por pedido e não por item)

Valor líquido do pedido: R$1,00 x 0,70% = R$0,007* 

*Como o valor líquido ficou abaixo do valor mínimo para a taxa (informado no código), será considerado o valor mínimo de  R$0,70.

Comissão DN:R$0,70 (valor líquido) x 5% (informação já consultada na VTEX)= R$0,035.
  • Gravar o Valor da Comissão: 

 Tanto para acesso do DN quanto do DR o valor da comissão estará gravado no campo ‘Valor Total Repasse’  na aba identificação do Monitor de Vendas.

Observações:

  • Para pedidos com forma de pagamento igual a PIX e/ou Boleto o campo  ‘Valor repasse’ dos itens do pedido, ficará em branco. 
  • O percentual da comissão aplicado segue a mesma regra existente na versão atual do projeto, para para vendas com tipo de pagamento igual a cartão.
  • O escopo considera apenas pedidos do mesmo Seller. Não abrange pedidos com mais de um Seller. 
  • O cálculo da comissão não será aplicado para vendas do DN, apenas para vendas do Seller.
  • A regra para arredondamento de valores financeiros, será a mesma utilizada no escopo FS008696 - Integração VTEX - Orquestrador - Exclusivo SENAI DN.
Expandir
title
Pedidos Boleto e PIX - Cálculo Comissão VINDI
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.

 

 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.

...