Linha de Produto: | Microsiga | ||||||||||||
Segmento: | Varejo | ||||||||||||
Módulo: | SigaLoja, FrontLoja | ||||||||||||
Rotina: |
| ||||||||||||
Parâmetro(s): |
| ||||||||||||
Requisito (ISSUE): | VAR_LOJ_002-41 | ||||||||||||
País(es): | Brasil | ||||||||||||
Banco(s) de Dados: | Todos | ||||||||||||
Tabelas Utilizadas: |
| ||||||||||||
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).
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
Fluxo do processo de comunicação ao Instituto Arredondar via Interface REST
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Pergunte | Data Venda de ? |
Objeto | Edit |
Grupo | LOJA804 |
Ordem | 01 |
Tipo | Data |
Tamanho | 8 |
Help | Informe 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ão | SA2 - Fornecedores |
Help | Escolha o fornecedor destinado ao Instituto Arredondar. |
Pergunte | A Pagar em ? |
Objeto | Edit |
Grupo | LOJA804 |
Ordem | 04 |
Tipo | Data |
Tamanho | 8 |
Help | Informe a data de vencimento do titulo a gerar. |
2. Criação de Tabelas arquivo SX2 - Tabelas:
Chave | Nome | Modo | PYME |
MGK | Doações para Instit. Arredondar | Exclusivo | Sim |
3. Criação de Campos no arquivo SX3 – Campos:
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) |
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) |
Campo | MGK_FILIAL |
Tipo | Carácter |
Tamanho | 8 |
Formato | @! |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campo | 033 |
Help | Informe a Filial do Sistema. |
Campo | MGK_NUM |
Tipo | Carácter |
Tamanho | 8 |
Formato | @! |
Título | Doação |
Descrição | Número da Doação |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe o número da doação. |
Campo | MGK_DATA |
Tipo | Data |
Tamanho | 8 |
Título | Data |
Descrição | Data da Doação |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe a data da doação. |
Campo | MGK_HORA |
Tipo | Carácter |
Tamanho | 5 |
Formato | 99:99 |
Título | Hora |
Descrição | Hora da Doação |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe a hora da doação. |
Campo | MGK_NUMORC |
Tipo | Carácter |
Tamanho | 6 |
Formato | @! |
Título | Orçamento |
Descrição | Orçamento do SIGALOJA |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe o núm. do orçamento do SIGALOJA. |
Campo | MGK_SERIE |
Tipo | Carácter |
Tamanho | 3 |
Formato | @! |
Título | Série |
Descrição | Série da Nota Fiscal |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campo | 094 |
Help | Informe a série da nota fiscal impressa. |
Campo | MGK_DOC |
Tipo | Carácter |
Tamanho | 9 |
Formato | @! |
Título | Nota Fiscal |
Descrição | Nota Fiscal |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campo | 018 |
Help | Informe o número da nota fiscal impresso. |
Campo | MGK_CODCLI |
Tipo | Carácter |
Tamanho | 6 |
Formato | @! |
Título | Cliente |
Descrição | Código do Cliente |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campo | 001 |
Help | Informe o Código do Cliente. |
Campo | MGK_LOJA |
Tipo | Carácter |
Tamanho | 2 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campo | 002 |
Help | Informe o Código da Loja do Cliente. |
Campo | MGK_CGCCLI |
Tipo | Carácter |
Tamanho | 16 |
Formato | @! |
Título | CPF/CNPJ |
Descrição | CPF/CNPJ do Cliente |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe o CPF ou CNPJ do Cliente. |
Campo | MGK_VALOR |
Tipo | Numérico |
Tamanho | 6 |
Decimal | 2 |
Formato | @E 999.99 |
Título | Valor doado |
Descrição | Valor da doação |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe o Valor da Doação. |
Campo | MGK_FORMPG |
Tipo | Carácter |
Tamanho | 2 |
Formato | @! |
Título | Forma Pgto. |
Descrição | Forma de Pagamento |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe a Forma de Pagamento. |
Campo | MGK_TRANSM |
Tipo | Carácter |
Tamanho | 1 |
Formato | @! |
Título | Transmitido |
Descrição | Status da Transmissão |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help | Informe 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ável | MV_LJRESIA |
Tipo | Lógico |
Descrição | Ativar Webservice REST enviando valores doados ao Instituto Arredondar. |
Valor Padrão | .F. |
Nome da Variável | MV_LJCNPIA |
Tipo | Carácter |
Descrição | Incluir CNPJ, sem traço e pontos, da loja cadastrada. Todos os 14 dígitos deverão ser preenchidos. |
Valor Padrão | (Vazio) |
Nome da Variável | MV_LJURLIA |
Tipo | Carácter |
Descrição | URL do Instituto Arredondar, incluindo http://. |
Valor Padrão | (Vazio) |
Nome da Variável | MV_LJTOKIA |
Tipo | Carácter |
Descrição | Token para envio ao Instituto Arredondar. |
Valor Padrão | (Vazio) |
CONFIGURAÇÃO DE PARÂMETROS
Itens/Pastas | Descrição |
Nome: | MV_LJFORIA |
Tipo: | Carácter |
Cont. Por.: | Fornecedor cadastrado para o Instituto Arredondar. |
Descrição: | Código do fornecedor para doação ao Instituto Arredondar, que aparece no campo E2_FORNECE no arquivo Contas a Pagar (SE2). |
Itens/Pastas | Descrição |
Nome: | MV_LJINSAR |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Flag para ativar doação voluntária ao Instituto Arredondar. |
Itens/Pastas | Descrição |
Nome: | MV_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) |
Itens/Pastas | Descrição |
Nome: | MV_LJNATIA |
Tipo: | 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_LJPREIA |
Tipo: | Carácter |
Cont. Por.: | DOA |
Descrição: | Prefixo para doação ao Instituto Arredondar, que aparece no campo E2_PREFIXO no arquivo do Contas à Pagar (SE2). |
Itens/Pastas | Descrição |
Nome: | MV_LJTEFIA |
Tipo: | Numérico |
Cont. Por.: | 1 |
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 ) |
Itens/Pastas | Descrição |
Nome: | MV_LJRESIA |
Tipo: | Lógico |
Cont. Por.: | .T. |
Descrição: | Ativar Webservice REST enviando valores doados ao Instituto Arredondar. (. T. – ativar, .F. desativar). |
Itens/Pastas | Descrição |
Nome: | MV_LJCNPIA |
Tipo: | Carácter |
Cont. Por.: | |
Descrição: | Incluir CNPJ, sem traço e pontos, da loja cadastrada. Todos os 14 dígitos deverão ser preenchidos. |
Itens/Pastas | Descrição |
Nome: | MV_LJURLIA |
Tipo: | Carácter |
Cont. Por.: | (Consulte o URL) |
Descrição: | URL do Instituto Arredondar, incluindo http://. |
Itens/Pastas | Descrição |
Nome: | MV_LJTOKIA |
Tipo: | Carácter |
Cont. Por.: | (É 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 |
Para utilizar a rotina de doação ao Instituto Arredondar, é necessário configurar os parâmetros:
É 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)
Importante
Para efetuar teste utilize qualquer número válido e cadastrado na impressora.
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.
Front Loja
TOTVS PDV
Fechamento do Instituto Arredondar
Exportação via interface REST