Histórico da Página
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: |
| ||||||||||
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á
utilizada principalmente pelo cliente que utiliza a folha do Protheus e deseja integrar a emissão de cheques (RH)disponibilizada, principalmente, para os clientes que utilizam a Folha do Protheus (SIGAGPE) e desejam integrar a Emissão de Cheques (GPER280), que é realizada pelo RH, com o módulo TRB do Logix.
A implementação consiste na integração entre a rotina de "Emissão de Cheques" do Protheus e o módulo TRB do Logix, via mensagem única;
Essa integração será realizada via "Mensagem Única", sendo que a mensagem utilizada é a "
BankTansactionBankTransaction"
em sua(versão
"1.000
";).
A rotina de integração
geraserá ativada junto à emissão de cheques, gerando um arquivo (XML
segundo o padrão do arquivo "BankTansaction_1_000.xsd". Nesse arquivo XML constam os dados dos cheques emitidos pelo módulo SIGAGPE, através da rotina GPER280;O Protheus enviará o arquivo XML e receberá outro como retorno, contendo as informações) 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 "
SequenciaSequência do Lote".
Essas informações serão gravadas como chave primária externaO Protheus armazenará esses dados (na tabela de
"De-Para
" (XXF) do Protheus, para que caso haja a necessidade de uma futura alteração ou cancelamento do cheque, essa "chave primária externa" seja enviada, 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
Aplicar o patch do chamado;
- Executar o Compatibilizador para que as alterações que constam no item "Atualizações do Compatibilizador" sejam realizadas (conforme orientações abaixo);
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.
- 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.
- Clique em OK para continuar.
- 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().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- 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.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- 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
- Em "Gestão de Pessoal" (SIGAGPE) acesse, "Relatórios > Recibos/Cheques > Emissão de Cheques";
- Selecione a rotina de "Emissão de Cheques" ou a de "Manutenção de Cheques";
- 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;
- Escolha a operação a ser realizada e confirme;
- 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;
- Informe os parâmetros solicitados;
- Emita os cheques;
- 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;
- As informações serão enviadas ao Logix;
Procedimento para Configuração
1.
para identificação do item no Logix;A rotina GPER280 faz a chamada da rotina GPEA281 e essa que fará a chamada da função "IntegDef" para integração via mensagem "BankTransaction" com o módulo TRB do Logix.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
Aplique o patch do chamado e execute uma vez a rotina GPER280.
No módulo SIGAGPE acesse Relatórios -> Recibos/Cheques -> Emissão de Cheques
Atualizações do Compatibilizador
1. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | MV_CTACTBD |
Tipo | Caracter |
Descrição | Conta Contábil de Débito |
Valor Padrão | "(Conta Contábil de débito para pagamento da folha)" |
2. Criação de tabela no arquivo SX2 – Tabelas:
Chave | Nome | Modo | Pyme |
SM3 | Cheques RH | C | S |
3. Criação de Campos no arquivo SX3 – Campos:
Procedimento para Configuração
CONFIGURAÇÃO DE PARÂMETROS
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o parâmetro a seguir:
Itens/PastasDescrição | Nome: | MV_ CTACTBDINTGTRB |
Tipo: | CaracterLógico | |
Cont. Por.: | (Conta Contábil de Débito).F. | |
Descrição: | Informe a conta contábil de débito, cujos cheques serão contabilizados no módulo TRB. |
CONFIGURAÇÃO DO ADAPTER E.A.I
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.
Campo | Conteúdo |
Mensagem Única | Sim |
Rotina | GPEA281 |
Mensagem | BankTransactions |
Canal de Envio | EAI |
Procedimento para Utilização
Atualizações do Compatibilizador
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
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 | Codigo Histórico Contábil? |
Grupo | GPEA281 |
Ordem | 03 |
Tipo | Caracter |
Tamanho | 3 |
2. Criação de tabela no arquivo SX2 – Tabelas:
Chave | Nome | Modo | Pyme |
SM3 | Cheques RH | C | S |
3. Criação de Campos no arquivo SX3 – Campos:
- Tabela SM3 - Cheques RH
Campo | M3_FILIAL |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | |
Título | Filial |
Descrição | Filial |
Usado | Não |
Obrigatório | Não |
Val. Sistema | |
Help | Filial do Sistema. |
Campo | M3_BANCO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Banco |
Descrição | Código do Banco |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Informe o código do Banco. |
Campo | M3_AGENCIA |
Tipo | Caracter |
Tamanho | 5 |
Decimal | 0 |
Formato | @! |
Título | Agência |
Descrição | Código da Agência |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Informe o código da Agência. |
Campo | M3_CONTA |
Tipo | Caracter |
Tamanho | 11 |
Decimal | 0 |
Formato | @! |
Título | Conta |
Descrição | Conta Corrente |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Informe o número da conta bancária. |
Campo | M3_NUMCHEQ |
Tipo | Caracter |
Tamanho | 15 |
Decimal | 0 |
Formato | @! |
Título | Núm. Cheque |
Descrição | Número do Cheque |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Número do cheque emitido. |
Campo | M3_DTEMISS |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Formato | |
Título | Data Em. Chq |
Descrição | Data Emissão Cheque |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | M->M3_DTEMISS <= dDataBase |
Help | Data de Emissão do Cheque. |
Campo | M3_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Valor Cheque |
Descrição | Valor do Cheque |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | Positivo() .And. (M->M3_VALOR > 0) |
Help | Valor do cheque emitido. |
Campo | M3_TIPO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | |
Título | Tipo Título |
Descrição | Tipo do Título |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Tipo do Título. |
Campo | M3_BENEF |
Tipo | Caracter |
Tamanho | 40 |
Decimal | 0 |
Formato | @!S40 |
Título | Nome Benef. |
Descrição | Nome do Beneficiário |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | |
Help | Nome do beneficiário. |
Campo | M3_MAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Fun. |
Descrição | Código do Funcionário |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | |
Help | Código do Funcionário que representa o Fornecedor. |
Campo | M3_DEBITO |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | @! |
Título | Conta Deb. |
Descrição | Conta Contábil de Débito |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | CTB105CTA(M->M3_DEBITO) |
Help | Conta contábil de débito que será utilizada na conciliação bancária do módulo TRB. |
Campo | M3_CREDITO |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | @! |
Título | Conta Cred. |
Descrição | Conta Contábil de Crédito |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | CTB105CTA(M->M3_CREDITO) |
Help | Conta contábil de crédito que será utilizada na conciliação bancária do módulo TRB. |
Campo | M3_IMPRESS |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Status Impr. |
Descrição | Status da Impressão |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | Pertence("SC") .And. NaoVazio() |
Help | Status da impressão do cheque, sendo que: S = Impresso; e C = Cancelado. |
Campo | M3_ITEMC |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Item Cont. |
Descrição | Item Contábil (AEN) |
Usado | Sim |
Obrigatório | Não |
Val. Sistema | CTB105ITEM() |
Help | 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). |
Campo | M3_CODHIST |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Cod. Hist. |
Descrição | Codigo Histórico Logix |
Usado | Sim |
Obrigatório | Não |
Val. Sistema |
|
Help | Có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. |
5. Criação de Índices no arquivo SIX – Índices:
Índice | SM3 |
Ordem | 1 |
Chave | M3_FILIAL+M3_BANCO+M3_AGENCIA+M3_CONTA+M3_NUMCHEQ |
Proprietário | S |
Índice | SM3 |
Ordem | 2 |
Chave | M3_FILIAL+M3_NUMCHEQ |
Proprietário | S |
Índice | SM3 |
Ordem | 3 |
Chave | M3_FILIAL+DTOS(M3_DTEMISS)+STR(M3_VALOR) |
Proprietário | S |