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

o cliente

os clientes que

utiliza

utilizam a

folha

"Folha do Protheus" (módulo SIGAGPE) e

deseja

desejam integrar a

emissão

"Emissão de

cheques (RH)

Cheques" (rotina 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;

A

Essa integração será realizada via "Mensagem Única", sendo que a mensagem utilizada é a "

BankTansaction

BankTransaction"

em sua

(versão

"

1.000

";

).

A rotina de integração

gera

será 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 "

Sequencia

Sequência do Lote".

Essas informações serão gravadas como chave primária externa

O 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 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

, necessitando de um futuro cancelamento ou alteração, os cheques possam ser identificados no 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";

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 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:

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;
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";
Para realizar o Cancelamento/Manutenção dos cheques será disponibilizada a rotina de "Manutenção de Cheques" (GPEA281), que poderá ser acessada através da atual rotina de emissão de cheques do módulo "Gestão de Pessoal" (SIGAGPE) do Protheus;
Os cheques que forem emitidos pelo "Gestão de Pessoal" (SIGAGPE) serão gravados em uma tabela (SM3) no Protheus e posteriomente poderão ser acessados pela rotina de "Manutenção de Cheques";
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";
1. Clicando em "Manutenção" a tela referente a rotina GPEA281 será aberta;
2. 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 a tela 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.

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	Código Histórico Logix?
Grupo	GPEA281
Ordem	02
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
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 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, ou seja, para não utilizar a integração basta não configurar o adapter da rotina;

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";
1. Clicando em "Manutenção" a tela referente a rotina GPEA281 será aberta;
2. 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 a tela 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.

Árvore de páginas

Versões comparadas

Versão antiga 25

Nova versão 26

Chave

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

Características do Requisito

Descrição da Implementação

Procedimento para Implantação

Procedimento para Configuração

Procedimento para Utilização

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Utilização

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 25

Nova versão 26

Chave

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

Características do Requisito

Descrição da Implementação

Procedimento para Implantação

Procedimento para Configuração

Procedimento para Utilização

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Utilização