Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Características do Requisito

Linha de Produto:

Microsiga

Segmento:

Varejo

Módulo:

SigaLoja, FrontLoja

Rotina:

Rotina

Nome Técnico

LOJA804

Fechamento Instituto Arredondar.

Rotina(s) envolvida(s)

Nome Técnico

FRTA271

Atendimento Front Loja.

 LOJA701

Venda Assistida
STIPOSMAINTOTVS PDV

Parâmetro(s):

MV_LJFORIALJINSAR
MV_LJINSARLJFORIA
MV_LJLOJIA
MV_LJNATIA
MV_LJPREIA
MV_LJTEFIA
MV_LJRESIA
MV_LJURLIA
MV_LJCNPIA
MV_LJTOKIA


Requisito (ISSUE):

VAR_LOJ_002-41

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

SL1Cabeçalho do Orçamento.
SLQCabeçalho do Orçamento ( Temporário ).
SE2Contas a Pagar.
MGKHistórico de Doações ao Instituto Arredondar.

Sistema(s) Operacional(is):

Windows®/Linux®

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

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

Qualquer doação aparecerá em tempo real no site acompanhe.arredondar.org.br, mediante login e senha. 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.  

 

Fluxo do Processo de Doação

Image Removed

 

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.

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:

Pergunte

Data Venda de ?

Objeto

Edit 

Grupo

LOJA804

Ordem

01

Tipo

Data

Tamanho

8

HelpInforme a data inicial da venda para o fechamento.

Pergunte

Data Venda até ?

Objeto

Edit 

Grupo

LOJA804

Ordem

02

Tipo

Data

Tamanho

8

Help

Informe a data final da venda para o fechamento.

Pergunte

Fornecedor ?

Objeto

Edit 

Grupo

LOJA804

Ordem

03

Tipo

Carácter

Tamanho

6

Cons.PadrãoSA2 - Fornecedores
HelpEscolha o fornecedor destinado ao Instituto Arredondar.

Pergunte

A Pagar em ?

Objeto

Edit 

Grupo

LOJA804

Ordem

04

Tipo

Data

Tamanho

8

HelpInforme a data de vencimento do titulo a gerar.


2.  Criação de Tabelas arquivo SX2 - Tabelas:

ChaveNomeModoPYME
MGKDoações para Instit. ArredondarExclusivoSim


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

  • Tabela SL1 - Orçamento

Campo

L1_VLRARR

Tipo

Númérico

Tamanho

6

Decimal

2

Formato

@E 999.99

Título

Val. Doacao

Descrição

Valor de Doação

Usado

Sim

Obrigatório

Não

Browse

Não

Contexto

Real

Propriedade

Alterar

Help

Campo que informa os centavos da doação (Instituto Arredondar)

 

  • Tabela SLQ - Orçamento

 

Campo

LQ_VLRARR

Tipo

Númérico

Tamanho

6

Decimal

2

Formato

@E 999.99

Título

Val. Doacao

Descrição

Valor de Doação

Usado

Sim

Obrigatório

Não

Browse

Não

Contexto

Real

Propriedade

Alterar

Help

Campo que informa os centavos da doação (Instituto Arredondar)

 

  • Tabela MGK - Doações para Instit. Arredondar:
CampoMGK_FILIAL
TipoCarácter
Tamanho8
Formato@!
TítuloFilial
DescriçãoFilial do Sistema
UsadoNão
ObrigatórioNão
BrowseSim
ContextoReal
PropriedadeAlterar
Grupo de Campo033
HelpInforme a Filial do Sistema.
CampoMGK_NUM
TipoCarácter
Tamanho8

Formato

@!
TítuloDoação
DescriçãoNúmero da Doação
UsadoSim
ObrigatórioSim
BrowseSim

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:

Pergunte

Data Venda de ?

Objeto

Edit 

Grupo

LOJA804

Ordem

01

Tipo

Data

Tamanho

8

HelpInforme a data inicial da venda para o fechamento.

Pergunte

Data Venda até ?

Objeto

Edit 

Grupo

LOJA804

Ordem

02

Tipo

Data

Tamanho

8

Help

Informe a data final da venda para o fechamento.

Pergunte

Fornecedor ?

Objeto

Edit 

Grupo

LOJA804

Ordem

03

Tipo

Carácter

Tamanho

6

Cons.PadrãoSA2 - Fornecedores
HelpEscolha o fornecedor destinado ao Instituto Arredondar.

Pergunte

A Pagar em ?

Objeto

Edit 

Grupo

LOJA804

Ordem

04

Tipo

Data

Tamanho

8

HelpInforme a data de vencimento do titulo a gerar.
2.  Criação ou Alteração (mantenha somente a instrução correspondente) de Tabelas arquivo SX2 - Tabelas:
ChaveNomeModoPYME
MGKDoações para Instit. ArredondarExclusivoSim

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

Tabela BGD - Prod x Cob x Proc x Co-Part:
 
  • Tabela SL1 - Orçamento
  • Não

    Campo

    L1_VLRARR

    Tipo

    Númérico

    Tamanho

    6

    Decimal

    2

    Formato

    @E 999.99

    Título

    Val. Doacao

    Descrição

    Valor de Doação

    Usado

    Não

    Obrigatório

    Não

    Browse

    ContextoReal
    PropriedadeAlterar
    Help

    Campo que informa os centavos da doação ( Instituto Arredondar)

     

    • Tabela SLQ - Orçamento
     
    Informe o número da doação.
    LQVLRARR@E 999.99Valor de NãoNão
    CampoMGK_DATA
    TipoNúméricoData
    Tamanho

    6

    Decimal

    2

    8

    Formato

    TítuloVal. DoacaoData
    DescriçãoData da Doação
    UsadoSim
    ObrigatórioNãoSim
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Help

    Campo que informa os centavos da doação ( Instituto Arredondar)

     

    Tabela MGK - Doações para Instit. Arredondar:
    Informe a data da doação.
    CampoMGK_FILIALHORA
    TipoCarácter
    Tamanho85
    Formato@!99:99
    TítuloFilialHora
    DescriçãoFilial do SistemaHora da Doação
    UsadoNãoSim
    ObrigatórioNãoSim
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo033
    HelpInforme a Filial do Sistemahora da doação.
    CampoMGK_NUMNUMORC
    TipoCarácter
    Tamanho86
    Formato@!
    TítuloDoaçãoOrçamento
    DescriçãoNúmero da DoaçãoOrçamento do SIGALOJA
    UsadoSim
    ObrigatórioSimNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    HelpInforme o número da doaçãonúm. do orçamento do SIGALOJA.
    CampoMGK_DATASERIE
    TipoDataCarácter
    Tamanho3
    Formato@!8
    TítuloDataSérie
    DescriçãoData Série da DoaçãoNota Fiscal
    UsadoSim
    ObrigatórioSimNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo094
    HelpInforme a data série da doaçãonota fiscal impressa.
    CampoMGK_HORADOC
    TipoCarácter
    Tamanho59
    Formato99:99@!
    TítuloHoraNota Fiscal
    DescriçãoHora da DoaçãoNota Fiscal
    UsadoSim
    ObrigatórioSimNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo018
    HelpInforme a hora da doaçãoo número da nota fiscal impresso.
    CampoMGK_NUMORCCODCLI
    TipoCarácter
    Tamanho6
    Formato@!
    TítuloOrçamentoCliente
    DescriçãoOrçamento Código do SIGALOJACliente
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo001
    HelpInforme o núm. do orçamento do SIGALOJACódigo do Cliente.
    094
    CampoMGK_SERIELOJA
    TipoCarácter
    Tamanho32

    Formato

    @!
    TítuloSérieLoja
    DescriçãoSérie da Nota FiscalLoja do Cliente
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo002
    HelpInforme a série da nota fiscal impressao Código da Loja do Cliente.
    CampoMGK_DOCCGCCLI
    TipoCarácter

    Tamanho

    916
    Formato@!
    TítuloNota FiscalCPF/CNPJ
    DescriçãoNota FiscalCPF/CNPJ do Cliente
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo018
    HelpInforme o número da nota fiscal impressoCPF ou CNPJ do Cliente.
    CampoMGK_CODCLIVALOR
    TipoCarácterNumérico
    Tamanho

    6

    Decimal2
    Formato@!@E 999.99
    TítuloCliente

    Valor doado

    DescriçãoDescrição do ClienteValor da doação
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    Grupo de Campo001
    HelpInforme o Código do ClienteValor da Doação.
    002 o Código da Loja do Cliente
    CampoMGK_LOJAFORMPG
    TipoCarácter
    Tamanho2
    Formato@!
    TítuloLojaForma Pgto.
    DescriçãoLoja do ClienteForma de Pagamento
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterarGrupo de Campo
    HelpInforme a Forma de Pagamento.
    CampoMGK_CGCCLITRANSM
    TipoCarácter
    Tamanho161
    Formato@!
    TítuloCPF/CNPJTransmitido
    DescriçãoCPF/CNPJ do ClienteStatus da Transmissão
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    HelpInforme o CPF ou CNPJ do Cliente.
    CampoMGK_VALOR
    TipoNumérico
    Tamanho

    6

    Decimal2
    Formato@E 999.99
    Título

    Valor doado

    DescriçãoValor da doação
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    HelpInforme o Valor da Doação.
    CampoMGK_FORMPG
    TipoCarácter
    Tamanho2
    Formato@!
    TítuloForma Pgto.
    DescriçãoForma de Pagamento
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    HelpInforme a Forma de Pagamento.
    CampoMGK_TRANSM
    TipoCarácter
    Tamanho1
    Formato@!
    TítuloTransmitido
    DescriçãoStatus da Transmissão
    UsadoSim
    ObrigatórioNão
    BrowseSim
    ContextoReal
    PropriedadeAlterar
    HelpInforme se este dado foi transmitido ao Instituto Arredondar. (S=Sim)

     

    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:
    Alterar
    HelpInforme se este dado foi transmitido ao Instituto Arredondar. (S=Sim)

     

    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:

    Nome da Variável

    MV_LJFORIA 

    Tipo

    Carácter

    Descrição

    Código do fornecedor para doação ao Instituto Arredondar, que aparece no campo E2_FORNECE no arquivo Contas a Pagar (SE2).

    Valor Padrão

    Fornecedor cadastrado para o Instituto Arredondar

    Nome da Variável

    MV_LJINSAR  

    Tipo

    Lógico

    Descrição

    Flag para ativar doação voluntária para o Instituto Arredondar.

    Valor Padrão

    .T.

    Nome da Variável

    MV_LJLOJIA  

    Tipo

    Carácter

    Descrição

    Código da Loja do fornecedor para doação ao Instituto Arredondar, que aparece no campo E2_LOJA no arquivo Contas a Pagar (SE2).

    Valor Padrão

    Loja do Fornecedor cadastrado para o instituto Arredondar.

    Nome da Variável

    MV_LJNATIA  

    Tipo

    Carácter

    Descrição

    Natureza para doação ao Instituto Arredondar, que aparece no campo E2_NATUREZ no arquivo Contas a Pagar (SE2)

    Valor Padrão

    DOACAO

    Nome da Variável

    MV_LJPREIA  

    Tipo

    Carácter

    Descrição

    Prefixo para doação ao Instituto Arredondar, que aparece no campo E2_PREFIXO no arquivo Contas a Pagar (SE2)

    Valor Padrão

    DOA

    Nome da Variável

    MV_LJTEFIA  

    Tipo

    Numérico

    Descrição

    Se a loja assume ou não a incidência da taxa da administradora financeira na doação. ( 1 = SIm, 2 = Não )

    Valor Padrão

    2
    Nome da VariávelMV_LJRESIA
    TipoLógico
    DescriçãoAtivar Webservice REST enviando valores doados ao Instituto Arredondar.
    Valor Padrão.F.
    Nome da VariávelMV_LJCNPIA
    TipoCarácter
    DescriçãoIncluir CNPJ, sem traço e pontos, da loja cadastrada. Todos os 14 dígitos deverão ser preenchidos.
    Valor Padrão(Vazio)
    LJFORIA Código fornecedor para doação ao que aparece no campo E2_FORNECE no arquivo Contas a Pagar (SE2)
    Nome da VariávelMV_LJURLIA
    TipoCarácter
    DescriçãoURL do Instituto Arredondar, incluindo http://.
    Valor PadrãoFornecedor cadastrado para o Instituto Arredondar(Vazio)
    LJINSAR  
    Nome da VariávelMV_LJTOKIA
    TipoLógicoCarácter
    Descrição

    Flag para ativar doação voluntária para o Instituto Arredondar.

    Valor Padrão

    .T.
    Token para envio ao Instituto Arredondar.
    Valor Padrão(Vazio)

    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:
       
    Código da Loja LOJA

    Itens/Pastas

    Descrição

    Nome:

    MV_LJFORIA

    Tipo:

    Carácter

    Cont. Por.:

    Fornecedor cadastrado para o Instituto Arredondar.

    Descrição:

    Código

    Nome da Variável

    MV_LJLOJIA  

    Tipo

    Carácter

    Descrição

    do fornecedor para doação ao Instituto Arredondar, que aparece no campo E2_

    FORNECE no arquivo Contas a Pagar (SE2).

    Valor Padrão

    Loja do Fornecedor cadastrado para o instituto Arredondar.

     

    Natureza , que aparece no campo E2_NATUREZ no arquivo Contas a Pagar (SE2)

    Itens/Pastas

    Descrição

    Nome:

    Nome da Variável

    MV_

    LJNATIA  

    LJINSAR

    Tipo

    Carácter

    :

    Lógico

    Cont. Por.:

    .T.

    Descrição:

    Flag para ativar doação voluntária ao Instituto Arredondar

    Valor Padrão

    Doação

    .

    Prefixo Instituro PREFIXO

    Itens/Pastas

    Descrição

    Nome:

    Nome da Variável

    MV_

    LJPREIA  

    LJLOJIA

    Tipo:

    Carácter

    Cont. Por.:

    Loja do fornecedor cadastrado para o Instituto Arredondar.

    Descrição:

    Código da loja do fornecedor para doação ao

    Instituto Arredondar, que aparece no campo E2_

    LOJA no arquivo Contas a Pagar (SE2)

    Valor Padrão

    Doa

     

    Itens/Pastas

    Descrição

    Nome:

    Nome da Variável

    MV_

    LJTEFIA  

    LJNATIA

    Tipo:

    Numérico

    Descrição

    Se a loja assume ou não a incidência da taxa da administradora financeira na doação. ( 1 = SIm, 2 = Não )

    Valor Padrão

    2

    Procedimento para Configuração

     

    CONFIGURAÇÃO DE PARÂMETROS

     

    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)

    Carácter

    Cont. Por.:

    DOACAO

    Descrição:

    Natureza para doação ao Instituto Arredondar que aparece no campo E2_NATUREZ no arquivo Contas a Pagar (SE2).

     

    Itens/Pastas

    Descrição

    Nome:

    MV_LJFORIALJPREIA

    Tipo:

    Carácter

    Cont. Por.:

    Fornecedor cadastrado para o Instituto Arredondar.DOA

    Descrição:

    Código do fornecedor Prefixo para doação ao Instituto Arredondar, que aparece no campo E2_FORNECE PREFIXO no arquivo do Contas a à Pagar (SE2).

     

    Itens/Pastas

    Descrição

    Nome:

    MV_LJINSARLJTEFIA

    Tipo:

    LógicoNumérico

    Cont. Por.:.T.

    1

    Descrição:Flag

    para ativar doação voluntária ao Instituto Arredondar.Se a loja assume ou não a incidência da taxa da administradora financeira na doação. ( 1 = Sim, 2 = Não )

    LJLOJIALoja do fornecedor cadastrado para o Instituto ArredondarCódigo da loja do fornecedor para doação , que aparece no campo E2_LOJA no arquivo Contas a Pagar (SE2)
    Itens/PastasDescrição
    Nome:MV_LJRESIA
    Tipo:CarácterLógico
    Cont. Por.:.T.
    Descrição:Ativar Webservice REST enviando valores doados ao Instituto Arredondar

     

    . (. T. – ativar, .F. desativar).
    LJNATIADoação
    Itens/PastasDescrição
    Nome:MV_LJCNPIA
    Tipo:Carácter
    Cont. Por.: 
    Descrição:

    Natureza para doação ao Instituto Arredondar que aparece no campo E2_NATUREZ no arquivo Contas a Pagar (SE2).

     

    Incluir CNPJ, sem traço e pontos, da loja cadastrada. Todos os 14 dígitos deverão ser preenchidos.
    LJPREIADOA
    Itens/PastasDescrição
    Nome:MV_LJURLIA
    Tipo:Carácter
    Cont. Por.:(Consulte o URL)
    Descrição:Prefixo para doação ao URL do Instituto Arredondar, que aparece no campo E2_PREFIXO no arquivo do Contas à Pagar (SE2)incluindo http://.
    LJTEFIASe a loja assume ou não a incidência da taxa da administradora financeira na doação. ( 1 = Sim, 2 = Não )
    Itens/PastasDescrição
    Nome:MV_LJTOKIA
    Tipo:NuméricoCarácter
    Cont. Por.:

    1

    Descrição:

    (É fornecido pelo Instituto Arredondar)
    Descrição:Token para envio ao Instituto Arredondar.

     

     

    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:

    Menu

    Atualizações

    Submenu

    Integração

    Nome da Rotina

    Fechamento Instituto Arredondar

    Programa

    LOJA804

    Módulo

    SIGALOJA

    Tipo

    SE2, SX1

    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.

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



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