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

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;

  • A mensagem

    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

    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 "

    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.

  • , 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

    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, "Relatórios > Recibos/Cheques > Emissão de Cheques";
    2. Selecione a rotina de "Emissão de Cheques" ou a de "Manutenção de Cheques";
      1. 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;
        1. Escolha a operação a ser realizada e confirme;
      2. 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;
        1. Informe os parâmetros solicitados;
        2. Emita os cheques;
    3. 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ábil?

    Grupo

    GPEA281

    Ordem

    03

    Tipo

    Caracter

    Tamanho

    3

    Procedimento para Implantação

    O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

    1. Aplique o patch do chamado e execute uma vez a rotina GPER280.

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

    ChaveNomeModoPyme
    SM3Cheques RHCS

     

    3. Criação de Campos no arquivo SX3 – Campos:

     

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

    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.

    CampoConteúdo
    Mensagem ÚnicaSim
    RotinaGPEA281
    MensagemBankTransactions
    Canal de EnvioEAI

    Procedimento para Utilização

    Importante: A integração da emissão de cheques deve ser executada somente após a execução do compatibilizador, da configuração do parâmetro "MV_CTACTBD", da configuração da rotina GPEA281 no Schedule

    Funcionário que representa o Fornecedor.
    CampoM3_DEBITO
    TipoCaracter
    Tamanho20
    Decimal0
    Formato@!
    TítuloConta Deb.
    DescriçãoConta Contábil de Débito
    UsadoSim
    ObrigatórioNão
    Val. Sistema

    CTB105CTA(M->M3_DEBITO)

    HelpConta contábil de débito que será utilizada na conciliação bancária do módulo TRB.
    CampoM3_CREDITO
    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órioNã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

    CTB105ITEM()

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


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