DT_VAR_LOJ_002-41_Instituto Arredondar (Doação De Centavos)

Características do Requisito

Descrição

Implementada melhoria com a disponibilização da rotina Fechamento Instituto Arredondar (LOJA804) que permite ao cliente efetuar a doação voluntária da quantia entre R$ 0,01 e R$ 0,99 para o instituto Arredondar, a partir da devolução do troco, ou a partir do pagamento nos cartões de débito ou crédito arredondando o total do cupom fiscal, de qualquer venda efetuada na rotina Venda Assistida (LOJA701), da rotina Atendimento (FRTA271) do Front Loja (SIGAFRT)  e da rotina TOTVS PDV (STIPOSMAIN) do Fron Front Loja (SIGAFRT).  Ao efetuar um lançamento provisório de contas a pagar com o valor doado para aquela entidade, o cliente deve realizar o

Quando o cliente efetua a doação voluntária ao Instituto Arredondar, é emitido um cupom informando a doação, disponível em ECF, NFC-e e SAT, e é gravado uma informação no Cabeçalho do Orçamento (tabela SL1) com o valor da doação. Este valor é transportado para a Retaguarda, via job STWUpData ou ApFrontLoja nos PDVs, e na Retaguarda, é gerado um lançamento provisório de contas a pagar na tabela SE2, e um lançamento no histórico de doações na tabela MGK via job Integracao ERP. Ao efetuar diversos lançamentos provisórios de contas a pagar com o valor doado para aquela entidade, em um determinado mês, o cliente deve realizar o fechamento mensal para o instituto Arredondar, possibilitando que todos os lançamentos provisórios sejam somados e um novo lançamento seja criado (definitivo) no contas a pagar.

Fluxo do Processo de Doação

Image Removed

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Implementada melhoria com a disponibilização da rotina de exportação de dados via Webservice Rest para o Instituto Arredondar. O envio dos dados deverá ser feito obrigatoriamente após confirmar a doação na Venda Assistida/Front Loja/TOTVS PDV e imprimir cupom não-fiscal de doação.

Após gerar um lançamento provisório de contas a pagar (SE2) de doação, o SIGALOJA/SIGAFRT transmitirá em tempo real ao Instituto Arredondar o valor que o cliente de uma loja fez a doação. Serão enviados dados como Data, Hora, CPF do cliente (opcional), nome do cliente (opcional), e-mail do cliente (opcional) e o valor doado.

Qualquer doação aparecerá em tempo real no site acompanhe.arredondar.org.br, mediante login e senha, acessado pelo cliente. Assim, o Instituto Arredondar monitorará todas as doações recebidas e fará um controle periódico desde a emissão do cupom até o pagamento da doação. 

Para implantar a exportação de dados via Webservice REST, o cliente deverá criar uma conta no site Instituto Arredondar, enviando um e-mail para [email protected] ou ligando pelo telefone (11) 2533-6857, informando que é um cliente TOTVS e deseja utilizar o sistema de doações em sua loja, ou informando que será um ambiente para testes. Receberá a senha e as instruções de como deverá acessar o site de acompanhamento de doações.

Fluxo do Processo de Doação

Image Added

Fluxo do processo de comunicação ao Instituto Arredondar via Interface REST

Image Added

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.

 Criação de Tabelas arquivo SX2 - Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

3.  Criação de Campos no arquivo SX3 – Campos: 

• Tabela SL1 - Orçamento

• Tabela SLQ - Orçamento

• Tabela SLQ - Orçamento

• Tabela MGK - Doações para Instit. Arredondar:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

3.  Criação de Parâmetros no arquivo SX6 – Parâmetros:

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
    

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

Para utilizar a rotina de doação ao Instituto Arredondar, é necessário configurar os parâmetros:

• MV_LJINSAR = .T.
• MV_LJPREIA = DOA.
• MV_LJNATIA = DOACAO
• MV_LJFORIA = Fornecedor cadastrado para o Instituto Arredondar.
• MV_LJLOJIA = Loja do fornecedor cadastrado para o Instituto Arredondar.
• MV_LJTEFIA = 1 (ATIVO) ou 2 (INATIVO). Leia no tópico Importante.

Image Added

É necessário cadastrar em SIGALOJA>> Atualizações >> Cadastros >> Gerência Finanças >> Natureza (FINA010) o código DOACAO e a descrição DOACAO, sem acentos.

É necessário cadastrar em SIGALOJA >> Atualizações >> Cadastros >> Gerência Estoque >> Fornecedores (MATA020) o fornecedor próprio para o Instituto Arredondar. Após confirmar a gravação, este código do fornecedor deverá ser cadastrado no parâmetro MV_LJFORIA.

A função do parâmetro MV_LJTEFIA: Se ativo, decide se  loja assume ou não a taxa administradora financeira quando for Cartão de Débito ou Cartão de Crédito. Exemplo: Se a doação for 0,75 e a taxa administrativa for 10% subtrairá 10% da doação de 0.75, gravando 0,75 - 0,075 = 0,0675, gravando a doação como 0,68 em L1_VLRARR  e no Contas a Pagar. Mas na impressão do Cupom Fiscal, aparecerá normalmente o valor sem desconto para o cliente.

Image Added
Configuração de impressão de cupom não fiscal para o Instituto Arredondar (SOMENTE PARA ECF)

1. Verifique se o arquivo SIGALOJA.INI existe na pasta \Protheus\bin\smartclient, caso não exista, crie e insira as linhas abaixo:
   [Instituto Arredondar]
   Totalizador=
   FormaPgto=
2. Em seguida, é recomendável que cadastre na impresso, a variável Totalizador como Doação para instalar no cliente. 
   Importante
   A variável Totalizador é o número cadastrado no totalizador não fiscal;
3. Após efetuar o cadastro, utilize o número cadastrado na configuração. No exemplo abaixo, o Totalizador está configurado com 04 e o FormaPagto é a forma de pagamento cadastrado na impressora, que está com o padrão de À Vista.
   [Instituto Arredondar]
   Totalizador=04
   FormaPgto= A VISTA 

Importante
Para efetuar teste utilize qualquer número válido e cadastrado na impressora.

Venda Assistida

1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Atendimento/Venda Assistida (LOJA701).
2. Cadastre um produto.
3. Pressione a tecla F7 para aparecer a finalização do pedido.
4. Clique na opção Dinheiro.
5. No campo Valor, digite um valor maior que o total do pedido.
   

   Importante

   Você pode também clicar nas opções Cartão de Débito ou Cartão de Crédito. O valor será arredondado para cima, em inteiros. A Diferença entre o valor arredondado e o valor calculado transformará em doação, se o cliente aceitar. E se tiver TEF instalado, automaticamente aparecerá, no visor do TEF, o valor da doação somado com o valor do cupom.
   

6. Confirme e pressione a tecla F5.
   O Sistema apresenta uma pergunta, para que o operador de caixa pergunte ao cliente se deseja doar aquele(s) centavo(s) ao o Instituto Arredondar. Caso sim, a função GrvBatch() é ativada para que o lançamento de contas a pagar para aquele doação seja efetivada.

Front Loja

1. No Front Loja (SIGAFRT) acesse Atualizações/ Frente de Loja/ Atendimento (FRTA271A).
2. Cadastre um produto.
3. Pressione a tecla F9 para finalizar a venda.
4. Após finalizar, escolha e execute uma das ações mencionadas abaixo:
   1. Pressione a tecla F5 e escolha a condição de pagamente À Vista  e em seguida pressione a tecla F9
   2. Ou, pressione as teclas CTRL + A para exibir a tela de Pagamento de Dinheiro.
   3. Ou, pressione as teclas CTRL + C para exibir a tela de Cartão de Débito.
   4. Ou, pressione as teclas CTRL + D para exibir a tela de Cartão de Crédito.
5. No campo Valor Pago Pelo Cliente, digite o valor maior do que o valor a pagar se for pagamento em Dinheiro, ou digite o mesmo valor se for Cartão de Débito ou Cartão de Crédito. O Valor será arredondado para cima, em inteiros. A diferença entre o valor arredondado e o valor calculado transformará em doação, se o cliente aceitar. E se tiver TEF instalado, automaticamente aparecerá, no visor do TEF, o valor da doação somado com o valor do cupom.
   O Sistema apresenta uma mensagem para que o operador do caixa pergunte ao cliente, se ele deseja doar aquele(s) centavo(s) para o instituto Arredondar.
6. No ambiente PDV, efetue a abertura do APSDU na tabela SL1 e verifique se realmente o valor da doação para o instituto Arredondar ( L1_VLRARR) está gravado.
7. No Retaguarda efetue a abertura do arquivo Appserver.ini e verifique se há um job inserido no grupo OnStart nomeado como APFrontLoja, que permite localizar a função GrvBatch(), para criar um campo de Duplicata a Pagar Pagar Provisório na tabela SE2. Confira de acordo com as informações abaixo:
8. [OnStart]
   • Jobs=APFrontLoja
     [APFrontLoja]
   • Main=FRTA020
   • Enviroment=127.0.0.1
   • nParms=3
   • Parm1=<empresa>
   • Parm2<filial>
   • Parm3<número de ordem> Exemplo : 001
9. No Retaguarda acesse o APSDU e na tabela SE2 verifique se existe um lançamento de contas a pagar, se o código do fornecedor é o mesmo cadastrado no parâmetro MV_LJFORIA e MV_LJLOJIA (fornecedor/loja identificando o Instituto Arredondar) e se o campo Valor do Título é preenchido com o valor da doação.
   
   

TOTVS PDV

1. No Front Loja (SIGAFRT) acesse Atualizações/ Frente de Loja/TOTVS PDV (STIPosMain).
2. Cadastre um produto.
3. Clique no botão "Finalizar Venda" ou Tecle <CTRL + F>.
4. Clique em "Limpar Pagamento" ou tecle <CTRL + L>.
5. Vá na lista " Selecione a forma de pagamento", procure "Dinheiro" e dê um duplo-clique.
6. No campo Valor do Pagamento, digite o valor maior do que o valor a pagar. Clique em "Finalizar Pagamento" ou tecle<CTRL + P>.
   O sistema apresenta uma mensagem para que o operador do caixa pergunte ao cliente, se ele deseja doar aquele(s) centavo (s) para o Instituto Arredondar.
   Importante
   Você pode também escolher, em "Selecionar a forma de Pagamento", as opções "Cartão de Débito" e "Cartão de Crédito". O valor será arredondado para cima, em inteiros. A diferença entre o valor arredondado e o valor calculado transformará em doação, se o cliente aceitar. E se tiver TEF instalado, automaticamente aparecerá, no visor do TEF, o valor da doação somado com o valor do cupom.
7. No ambiente PDV, efetue a abertura do APSDU na tabela SL1 e verifique se realmente o valor da doação para o Instituto Arredondar ( L1_VLRARR) está gravado.
8. No Retaguarda efetue a abertura do arquivo AppServer.ini e verifique se  há um Job inserido grupo OnStart nomeado como APFrontLoja, que permite localizar a função GrvBatch() para criar um campo de Duplicata a Pagar Provisório na tabela SE2. Confira de acordo com as informações abaixo:
   
   • • [OnStart]
     • Jobs=APFrontLoja
       
       
     • [APFrontLoja]
     • Main=FRTA020
     • Environment=127.0.0.1 
     • nParms=3
     • Parm1=<empresa>
     • Parm2=<filial> 
     • Parm3=<número de ordem> Exemplo: 001
    
9. No Retaguarda acesse o APSDU e na tabela SE2 verifique se existe um lançamento de contas a pagar, se o código do fornecedor é o mesmo cadastrado no parâmetro MV_LJFORIA e MV_LJLOJIA (Fornecedor/loja identificando o Instituto Arredondar) e se o campo Valor do Título é preenchido com o valor da doação.
   

Fechamento do Instituto Arredondar

1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Integração/Fechamento do Instituto Arredondar(LOJA804).
2. Digite a data inicial, a data final, o fornecedor cadastrado para identificar todas as doações que foram geradas para o Instituto Arredondar.
3. No campo Data de Vencimento informe a data do novo título a ser gerado.
4. Confira os dados e confirme
   O Sistema apresenta a lista de todos os títulos provisórios que devem ser unificados juntos com a tela de Título Efetivo Gerado, que apresenta apenas o futuro título com o valor já somado.
5. Clique em  Finalizar.
6. Escolha o tipo de impressão, e no caso do PDF a impressão é apresentada na tela.
7. Confira os dados da impressão e confirme
   Antes de efetuar a mudança do conteúdo do parâmetro MV_LJFORIA (código do fornecedor do Instituto Arredondar), é necessário emitir o Fechamento Mensal. Em seguida, é permitido alterar o parâmetro para prosseguir com os lançamentos de doações pelo Venda Assistida ou pelo Front Loja com o novo código do fornecedor.

Exportação via interface REST

1. Para utilizar a rotina de exportação de dados via Webservice REST ao Instituto Arredondar, é necessário configurar os parâmetros:
   
   • MV_LJRESIA := .T.
   • MV_LJCNPIA := (o CNPJ do cliente)
   • MV_LJURLIA := http://acompanhe.arredondar.org.br
   • MV_LJTOKIA := (Token enviado ao cliente cadastrado no Instituto Arredondar)
2. Siga todos os passos neste Boletim Técnico do Instituto Arredondar.
3. Faça uma Venda Assistida, ou Front Loja, ou TOTVS PDV, com troco maior que zero. Aceitar a doação (conforme passo 2).
4. Observar no APPSERVER como o Webservice REST retornou para o Protheus. Verifique pela linha Resposta. Retornará OK ou não. Aparecerá o número do retorno HTTP. Se for 200, OK. Se não for 200, deu falha na transmissão.
5. Vá ao site http://acompanhe.arredondar.org.br, e informe o e-mail e o password fornecido pelo Instituto Arredondar.
6. No menu, clique em Financeiro. Clique na pasta Listagem de Transações. Selecione as datas inicial e final e clique em “Exportar para Excel”.
7. Confira os dados lançados na planilha. Veja que o valor arrecadado consta na planilha, assim como o nome do cliente, CPF, e-mail.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf