Árvore de páginas

Versões comparadas

Chave

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


Integração - Emissão de Cheques - Protheus - Logix TRB

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Serviços

Módulo:

SIGAGPE - Gestão de Pessoal

Rotina:

Rotina

Nome Técnico

GPEI281
Mensagem Única - Emissão de Cheques.

Rotina(s) envolvida(s)

Nome Técnico

GPER280
Emissão de Cheques.
GPEA281
Manutenção de Cheques.

Chamados relacionados

TRPNAS

Tabelas utilizadas:

SEF; SM3

Versões/Release:

11.80


Descrição da Implementação

A implementação consiste em uma melhoria que será disponibilizada, principalmente, para os clientes que utilizam a "Folha do Protheus " (módulo SIGAGPE) e desejam integrar a "Emissão de Cheques " (rotina GPER280), que é realizada pelo RH, com o módulo TRB do Logix. Essa integração será realizada via "Mensagem Única", sendo que a mensagem utilizada é a "BankTransaction" (versão 1.000).

A rotina de integração será ativada junto à emissão de cheques, gerando um arquivo (XML) que será enviado para o Logix, que por sua vez encaminhará um outro arquivo, de retorno, do mesmo formato, informando ao Protheus, além do "status" da mensagem, os dados de "Número do Documento", "Número do Lote" e "Sequência do Lote". O Protheus armazenará esses dados (na tabela de De-Para, XXF) para que, necessitando de um futuro cancelamento ou alteração, os cheques possam ser identificados no Logix.

 

Adapter EAI

    • Ao configurar o "Adapter EAI" da rotina GPEA281, sempre que houver emissão de cheques pelo módulo SIGAGPE, os cheques serão integrados com o módulo TRB, ou seja, para não utilizar a integração basta não configurar o "Adapter" da rotina;

Rotina de Manutenção de Cheques (GPEA281)

    • Os cheques emitidos pela rotina de Emissão de Cheques (GPER280) poderão ser visualizados pela rotina de Manutenção de Cheques (GPEA281);
    • Essa é uma rotina independente da integração, portanto possui uma documentação a parte;
    • A rotina não permitirá a alteração dos dados dos cheques, na medida em que os cheques já foram emitidos, com exceção da Conta Contábil de Débito e do Item Contábil (AEN). Além disso, a rotina permitirá o cancelamento dos cheques;
    • O cancelamento dos cheques poderá ser "solicitado" pelo Protheus, porém o tratamento que verificará se o cheque pode ser cancelado ou não será realizado pelo Logix;
    • Essa rotina poderá ser acessada através da rotina de Emissão de Cheques (GPER280), no módulo "Gestão de Pessoal" (SIGAGPE) do Protheus;

Contabilização

    • Ao implementar a integração da emissão de cheques entre o Protheus e o Logix, a contabilização da folha continuará sendo feita como anteriormente nos produtos padrões, ou seja, caso haja alguma customização na contabilização de ambos os produtos, essa é de responsabilidade do cliente;

Parâmetros da Rotina

    • Além dos parâmetros já existentes na rotina de "Emissão de Cheques", serão apresentadas três novas perguntas de caráter obrigatório: "Conta Contábil de Débito", "Item Contábil (AEN Logix)" e "Código do Histórico Contábil";
    • Esses três parâmetros referem-se, respectivamente, a conta contábil de débito, cujo TRB utilizará no momento da conciliação bancária, ao código do Item Contábil, que no Logix é denominado "Área Estratégica de Negócio" (AEN) e ao código do histórico contábil, que é um cadastro existente no Logix;
    • Essas perguntas serão apresentadas apenas para quem possuir essa integração entre a Emissão de Cheques e o módulo TRB.


Importante:

A troca de informações bancárias entre as marcas (Protheus e Logix) será garantida pela mensagem única Bank, que deve estar funcionando corretamente para que a integração entre Emissão de Cheques (Protheus) e móldulo TRB (Logix), seja implementada corretamente.
 


Procedimento para Implantação

  1. Aplicar o patch do chamado;

  2. Executar o Compatibilizador para que as alterações que constam no item "Atualizações do Compatibilizador" sejam realizadas (conforme orientações abaixo);
  3. Configurar a rotina GPEA281 no Schedule, conforme orientações do item "Procedimento para Configuração";

Para executar o compatibilizador RHUPDMOD:

Em ByYou Smart Client, informe "RHUPDMOD" no campo Programa Inicial.

  1. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 18/09/2015.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa SIGAGPE().
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Selecione as opções 298 e 299 referentes a criação da tabela SM3 e a do parâmetro MV_INTGTRB juntamente com o grupo de perguntas GPEA281, respectivamente.
    2. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    3. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    4. Clique em Gravar para salvar o histórico (log) apresentado.
    5. Clique em OK para encerrar o processamento.

Atenção:

A integração da emissão de cheques deve ser utilizada somente após a execução dos procedimentos citados acima.


Procedimento para Utilização

  1. Em "Gestão de Pessoal" (SIGAGPE) acesse, "Relatórios > Recibos/Cheques > Emissão de Cheques";
  2. Selecione a rotina de "Emissão de Cheques" ou a de "Manutenção de Cheques";
    1. Selecionando a opção de "Manutenção de Cheques" será aberta uma tela com os cheques que já foram emitidos, permitindo o cancelamento ou alteração dos mesmos;
      1. Escolha a operação a ser realizada e confirme;
    2. Selecionando a opção de "Emissão de Cheques", a rotina para emissão seguirá seu curso normalmente (assim como era antes), com exceção das duas novas perguntas que serão apresentadas;
      1. Informe os parâmetros solicitados;
      2. Emita os cheques;
  3. As informações serão enviadas ao Logix;


Procedimento para Configuração

CONFIGURAÇÃO DO ADAPTER E.A.I

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

Nome:

MV_INTGTRB

Tipo:

Lógico

Cont. Por.:

.F.

Descrição:

Integra Emissão de Cheques com o TRB?

.T. = Integra, .F. = Não integra


2. No Configurador (SIGACFG), acesse Ambientes/Schedule/Adapter E.A.I (CFGX017) e inclua a rotina conforme os campos abaixo.

OBS: Os campos que não estão informados abaixo podem ser configurados conforme preferência do cliente.

Adapter EAI
CampoConteúdo
Mensagem ÚnicaSim
RotinaGPEA281
MensagemBankTransactions
Canal de EnvioEAI

 

Procedimento para Utilização

 

Importante:

Ao configurar o "Adapter
EAI
" da rotina GPEA281, sempre que houver emissão de cheques pelo módulo SIGAGPE, os cheques serão integrados com o módulo TRB, ou seja, para não utilizar a integração basta não configurar o "Adapter" da rotina;Rotina de Emissão de Cheques (GPER280)
    1. A rotina de emissão de cheques continuará sendo a mesma do "Gestão de Pessoal" (SIGAGPE), portanto os cheques que poderão ser emitidos continuam sendo de: "Adiantamento", "Folha", "1ª parcela do 13º", "2ª parcela do 13º", "Férias", "Rescisão" e "Horas Extras";
  • Rotina de Manutenção de Cheques (GPEA281)



Atualizações do Compatibilizador 

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

- Grupo GPEA281 - Integração Logix - Emissão de Cheques

Pergunte

Conta Contábil Débito?

Grupo

GPEA281

Ordem

01

Tipo

Caracter

Tamanho

20

Pergunte

Item Contábil?

Grupo

GPEA281

Ordem

02

Tipo

Caracter

Tamanho

9

Pergunte

Código Codigo Histórico LogixContábil?

Grupo

GPEA281

Ordem

0203

Tipo

Caracter

Tamanho

3

 

2. Criação de tabela no arquivo SX2 – Tabelas:

ChaveNomeModoPyme
SM3Cheques RHCS

 

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

- Tabela SM3 - Cheques RH

CampoM3_FILIAL
TipoCaracter
Tamanho2
Decimal0
Formato 
TítuloFilial
DescriçãoFilial
UsadoNão
ObrigatórioNão
Val. Sistema 
HelpFilial do Sistema.
CampoM3_BANCO
TipoCaracter
Tamanho3
Decimal0
Formato @!
TítuloBanco
DescriçãoCódigo do Banco
UsadoSim
ObrigatórioSim
Val. SistemaNaoExistCh() 
HelpInforme o código do Banco.
CampoM3_AGENCIA
TipoCaracter
Tamanho5
Decimal0
Formato @!
TítuloAgência
DescriçãoCódigo da Agência
UsadoSim
ObrigatórioSim
Val. SistemaNaoExistCh() 
HelpInforme o código da Agência.
CampoM3_CONTA
TipoCaracter
Tamanho11
Decimal0
Formato @!
TítuloConta
DescriçãoConta Corrente
UsadoSim
ObrigatórioSim
Val. SistemaNaoExistCh() 
HelpInforme o número da conta bancária.
CampoM3_NUMCHEQ
TipoCaracter
Tamanho15
Decimal0
Formato @!
TítuloNúm. Cheque
DescriçãoNúmero do Cheque
UsadoSim
ObrigatórioSim
Val. SistemaNaoExistCh() 
HelpNúmero do cheque emitido.
CampoM3_DTEMISS
TipoData
Tamanho8
Decimal0
Formato 
TítuloData Em. Chq
DescriçãoData Emissão Cheque
UsadoSim
ObrigatórioSim
Val. SistemaM->M3_DTEMISS <= dDataBase
HelpData de Emissão do Cheque.
CampoM3_VALOR
TipoNumérico
Tamanho16
Decimal2
Formato

@E 9,999,999,999,999.99

TítuloValor Cheque
DescriçãoValor do Cheque
UsadoSim
ObrigatórioSim
Val. SistemaPositivo() .And. (M->M3_VALOR > 0)
HelpValor do cheque emitido.
CampoM3_TIPO
TipoCaracter
Tamanho3
Decimal0
Formato 
TítuloTipo Título
DescriçãoTipo do Título
UsadoSim
ObrigatórioSim
Val. SistemaNaoExistCh() 
HelpTipo do Título.
CampoM3_BENEF
TipoCaracter
Tamanho40
Decimal0
Formato @!S40
TítuloNome Benef.
Descrição

Nome do Beneficiário

UsadoSim
ObrigatórioSimNão
Val. Sistema 
HelpNome do beneficiário.
CampoM3_FORNECMAT
TipoCaracter
Tamanho6
Decimal0
Formato @!
TítuloCod. FornFun.
DescriçãoCódigo do FornecedorFuncionário
UsadoSim
ObrigatórioSimNão
Val. Sistema 
HelpCódigo do fornecedorFuncionário que representa o Fornecedor.
CampoM3_CDEBITODEBITO
TipoCaracter
Tamanho20
Decimal0
Formato @!
TítuloConta Deb.
DescriçãoConta Contábil de Débito
UsadoNãoSim
ObrigatórioSimNão
Val. Sistema

Vazio() .Or. CTB105CTA(M->M3_DEBITO)

HelpConta contábil de débito referente à operaçãoque será utilizada na conciliação bancária do módulo TRB.
CampoM3_CCREDITCREDITO
TipoCaracter
Tamanho20
Decimal0
Formato @!
TítuloConta Cred.
DescriçãoConta Contábil de Crédito
UsadoSim
ObrigatórioNão
Val. Sistema

CTB105CTA(M->M3_CREDITO)

HelpConta contábil de crédito que será utilizada na conciliação bancária do módulo TRB.
CampoM3_IMPRESS
TipoCaracter
Tamanho1
Decimal0
Formato@!
TítuloStatus Impr.
DescriçãoStatus da Impressão
UsadoSim
ObrigatórioNãoObrigatórioSim
Val. Sistema

Pertence("SC") .And. NaoVazio()

HelpStatus da impressão do cheque, sendo que: S = Impresso; e C = Cancelado.
CampoM3_ITEMC
TipoCaracter
Tamanho9
Decimal0
Formato@!
TítuloItem Cont.
DescriçãoItem Contábil (AEN)
UsadoSim
ObrigatórioNão
Val. Sistema

CTB105ITEMVazio() .Or. CTB105CTA()

HelpConta contábil de crédito referente à operação.

 

Item contábil (AEN Logix) que será utilizado na conciliação bancária do módulo TRB. Obs: O Item Contábil do Protheus equivale, no Logix, a Área Estratégica de Negócio (AEN).
CampoM3_CODHIST
TipoCaracter
Tamanho3
Decimal0
Formato@!
TítuloCod. Hist.
DescriçãoCodigo Histórico Logix
UsadoSim
ObrigatórioNão
Val. Sistema

 

HelpCódigo do Histórico Contábil no Logix.

 

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

Nome da Variável

MV_INTGTRB

Tipo

Lógico

Descrição

Integra Emissão de Cheques com o TRB?

.T. = Integra, .F. = Não integra

Valor Padrão

.F.


54. Criação de Índices no arquivo SIX – Índices:

Índice
SM3
Ordem

1

ChaveM3_FILIAL+M3_BANCO+M3_AGENCIA+M3_CONTA+M3_NUMCHEQ
ProprietárioS
Índice
SM3
Ordem

2

ChaveM3_FILIAL+M3_NUMCHEQ
ProprietárioS
Índice
SM3
Ordem

3

ChaveM3_FILIAL+DTOS(M3_DTEMISS)+STR(M3_VALOR)
ProprietárioS

...