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 melhoria será utilizada disponibilizada principalmente pelo para o cliente que utiliza a folha do Protheus e deseja integrar a emissão de cheques (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;
A mensagem utilizada é a "BankTansaction" em sua versão "1.000";
A rotina de integração gera um arquivo XML segundo de acordo com 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 de "Número do Documento", "Número do Lote" e "Sequencia do Lote". Essas informações serão gravadas como chave primária externa 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 para identificação do item no Logix;
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;
Configurar a rotina GPEA281 no Schedule, conforme orientações do item "Procedimento para Configuração";
Configurar o parâmetro "MV_CTACTBD", conforme orientações do item "Procedimento para Configuração";
Atenção:
A integração da emissão de cheques deve ser utilizada somente após a execução dos procedimentos citados acima.
Atualizações do Compatibilizador
1. Criação ou Alteração de Parâmetros Perguntas no arquivo SX6 SX1 – Parâmetros:Cadastro de Perguntes:
- Grupo GPEA281 - Integração Logix - Emissão de Cheques
Pergunte | Conta Contábil Débito? |
Nome |
|
Grupo | GPEA281 |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
Pergunte | Código Histórico Logix? |
Nome |
|
Grupo | GPEA281 |
Ordem | 02 |
Tipo | Caracter |
Tamanho | 3 |
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:
- 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 | |
Título | Nome Benef. |
Descrição | Nome do Beneficiário |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Nome do beneficiário. |
Campo | M3_FORNEC |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | |
Título | Cod. Forn. |
Descrição | Código do Fornecedor |
Usado | Sim |
Obrigatório | Sim |
Val. Sistema | |
Help | Código do fornecedor. |
Campo | M3_CDEBITO |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | |
Título | Conta Deb. |
Descrição | Conta Contábil de Débito |
Usado | Não |
Obrigatório | Sim |
Val. Sistema | Vazio() .Or. CTB105CTA() |
Help | Conta contábil de débito referente à operação. |
Campo | M3_CCREDIT |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | |
Título | Conta Cred. |
Descrição | Conta Contábil de Crédito |
Usado | Não |
Obrigatório | Sim |
Val. Sistema | Vazio() .Or. CTB105CTA() |
Help | Conta contábil de crédito referente à operação. |
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 DE PARÂMETROS
No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o parâmetro a seguir:
Itens/Pastas | Descrição |
Nome: | MV_CTACTBD |
Tipo: | Caracter |
Cont. Por.: | (Conta Contábil de Débito) |
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
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:
- 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;
- 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;
- A rotina de emissão de cheques continuará sendo a mesma do "SIGAGPE - Protheus", 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";
- Foi desenvolvida a rotina GPEA281 para manutenção de cheques. Essa rotina poderá ser executada através da GPER280, que é a atual rotina de emissão de cheques;
- Os cheques emitidos pela rotina GPER280 (Emissão de Cheques) serão gravados na tabela SM3 e poderão ser acessados pela rotina GPEA281 após a emissão;
- A rotina de manutenção de cheques (GPEA281) permitirá apenas a visualização e cancelamento dos mesmos, já que como os cheques já foram impressos, os dados não podem ser alterados, com exceção da conta contábil de débito;
- O preenchimento das duas perguntas específicas para essa integração ("Conta Contábil de Débito" e "Código Histórico Contábil") são obrigatórias para realizar a emissão dos cheques.
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.
Fluxo alternativo: Ao escolher a opção "Manutenção", será apresentada uma a tela de consulta referente a rotina de manutenção de cheques (GPEA281), onde será possível a visualização, cancelamento e alteração da "conta contábil de débito" dos cheques já emitidos.
...