Á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.

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;
  3. 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

 

Adapter EAI

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.

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 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
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 de "Manutenção de Cheques" (GPEA281) é uma rotina a parte da integração, portanto poderá ser utilizada inclusive pelo cliente que não possuir tal implementação;
    • Existe um documento a parte para a rotina de "Manutenção de cheques";
    • O campos referentes aos dados contábeis serão apresentados, na rotina de "Manutenção de Cheques" (GPEA281), apenas para quem implementar essa integração com o módulo TRB.

    Utilização:

      • "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, "Para acessar a rotina de emissão de cheques acesse "SIGAGPE > Relatórios > Recibos/Cheques > Emissão de Cheques";
    2. Será apresentada uma tela com as opções Selecione a rotina de "Manutenção" e "Emissão Emissão de Cheques" ou a de "Manutenção de Cheques";
      1. Clicando em Selecionando a opção de "Manutenção de Cheques" a tela referente a rotina GPEA281 será aberta;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 Clicando em "Emissão de Cheques", a rotina GPER280 para emissão 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;
    3. Escolha os parâmetros para emissão e clique em "OK";
    4. 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.
      1. (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;
    1. 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.

    CampoConteúdo
    Mensagem ÚnicaSim
    RotinaGPEA281
    MensagemBankTransactions
    Canal de EnvioEAI



    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:

    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órioSimNão
    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

    ...