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á disponibilizada, principalmente, para
o clienteos clientes que
utilizautilizam a
folhaFolha do Protheus (SIGAGPE) e
desejadesejam integrar a
emissãoEmissão de
cheques (RH)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
de acordo com o padrão do arquivo "BankTansaction_1_000.xsd";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.
A rotina GPER280 faz a chamada da rotina GPEA281 (Manutenção de Cheques) 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
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. 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.
Campo | Conteúdo |
Mensagem Única | Sim |
Rotina | GPEA281 |
Mensagem | BankTransactions |
Canal de Envio | EAI |
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 | Codigo Histórico ContábilCódigo Histórico Logix? |
Grupo | GPEA281 |
Ordem | 0203 |
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 | NaoExistCh() |
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 | NaoExistCh() |
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 | NaoExistCh() |
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 | NaoExistCh() |
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 | NaoExistCh() |
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 | SimNão |
Val. Sistema | |
Help | Nome do beneficiário. |
Campo | M3_FORNECMAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. FornFun. |
Descrição | Código do FornecedorFuncionário |
Usado | Sim |
Obrigatório | SimNão |
Val. Sistema | |
Help | Código do fornecedorFuncionário que representa o Fornecedor. |
Campo | M3_CDEBITODEBITO |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | @! |
Título | Conta Deb. |
Descrição | Conta Contábil de Débito |
Usado | NãoSim |
Obrigatório | SimNão |
Val. Sistema | Vazio() .Or. CTB105CTA(M->M3_DEBITO) |
Help | Conta contábil de débito referente à operaçãoque será utilizada na conciliação bancária do módulo TRB. |
Campo | M3_CCREDITCREDITO |
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 | SimNão |
Val. Sistema | VazioPertence() .Or. CTB105CTA"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 | Conta 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). |
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. 4. 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 |
Procedimento para Configuração
CONFIGURAÇÃO DO ADAPTER E.A.I
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
Importante:
Observações:
- A rotina GPEA281 (Manutenção de cheques) é uma rotina a parte da integração, portanto poderá ser utilizada inclusive pelo cliente que não possuir tal implementação;
- Há um documento a parte para a rotina GPEA281, de "Manutenção de Cheques"
- O campos referentes aos dados contábeis serão apresentados, na rotina GPEA281, apenas para quem implementar essa integração com o TRB.
Utilização:
- Para acessar a rotina de emissão de cheques acesse "SIGAGPE > Relatórios > Recibos/Cheques > Emissão de Cheques";
- Será apresentada uma tela com as opções de "Manutenção" e "Emissão de Cheques";
- Clicando em "Manutenção" a tela referente a rotina GPEA281 será aberta;
- Clicando em "Emissão de Cheques" a rotina GPER280 seguirá seu curso normalmente, porém os parâmetros referentes à "Conta Contábil de Débito" e "Código do Histórico Contábil" deverão ser preenchidos;
- Escolha os parâmetros para emissão e clique em "OK";
- Os cheques serão emitidos e integrados com o módulo TRB.