ÍNDICE
01. VISÃO GERAL
Este documento de referência tem como objetivo explicar o funcionamento da integração do Protheus com o Suricato, desde a configuração dos parâmetros necessários e os WebServices envolvidos na integração, basicamente eles são os mesmos utilizado pelo TSA.
02. PARÂMETROS
Antes da configuração dos parâmetros, será necessário já possuir o Suricato instalado. Motivo: Existe um parâmetro que deve ser preenchido com o endereço do servidor onde se encontra o Suricato. A configuração dos seguintes parâmetros no Protheus (opção disponível no Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013)):
| Parâmetro | Descrição |
|---|
| MV_TSREP | Define se haverá integração entre o modulo SIGAPON e o aplicativo Suricato . Conteúdo: .T. |
| MV_TSASERV | Endereço IP ou nome do servidor da instalação do aplicativo Suricato. Exemplo: 10.0.0.90:8080/tsa-ejb |
| MV_TSANDIA | Define o Número de dias anteriores a data do sistema para que seja feito o sincronismo dos funcionários demitidos. Exemplo: 30 |
| MV_TSATLOG | Define qual será o tipo de envio do Log de erros da integração do módulo Ponto Eletronico X Aplic. Suricato (0=Não Gera, 1=E-mail, 2=Arquivo, 3=Ambos, 5=SaveXML). Exemplo: 3 |
| MV_TSADARQ | Define o nome do diretório onde serão gravados os arquivos de Log de erros gerados da integração do módulo Ponto Eletrônico X Aplicativo TSA. Exemplo: \logwsrhtsa\ |
| MV_TSAIURB | Habilita a integração do crachá do funcionário com o Suricato. Exemplo: .T. |
| MV_TSAMAIL | Endereço de Email para recebimento de mensagens do Log de integração. Caso esteja em branco o email não é enviado. Exemplo: [email protected] |
ATENÇÃO:
| Informações |
|---|
| title | Configuração necessária para envio de email |
|---|
|
MV_RELACNT - Conta utilizada para envio do email
MV_RELSERV - Endereço do servidor de email
MV_RELPSW - Senha da conta utilizada para envio do email
MV_RELAUSR - usuario de autenticação de email
MV_RELAPSW - senha do usuario de autenticação de email
MV_RELFROM - endereço de email que ira disparar o email
MV_RELAUTH - Faz autenticação no servidor de email |
| Informações |
|---|
| title | Log XML - MV_TSATLOG = 5 |
|---|
|
A opção 5 gera o xml de envio e retorno na pasta system,essa opção é útil para analisar erros porém consome muito espaço em disco, por isso é importante ativá-lo para realizar o teste necessário e logo depois desativá-lo. Nome dos arquivos :
"Numero Sequencial"_SND.XML → XML enviado ao Suricato
"Numero Sequencial"_RCV.XML → XML recebido do suricato como retorno do XML SND |
03. Integrações realizadas entre os produtos:
| Totvs custom tabs box |
|---|
| tabs | Empresa,Funcionário,Função,Turno,Feriádos,Sindicatos |
|---|
| ids | empresa,funcionario,funcao,turno,feriados,sindicato |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | empresa |
|---|
| Cadastro de Novas Empresas/Filiais Ao incluir uma empresa/filial no Cadastro de Empresa, deve-se executar novamente o processo de Carga Inicial de Empresa, Unidade e Lotação para atualização da informação da empresa/filial no Suricato. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | funcionario |
|---|
| Cadastro de Funcionário Efetue a admissão de um funcionário no Cadastro do Funcionários e verifique se o Cadastro do Usuário no Suricato foi atualizado. Realize a alteração no Cadastro do Funcionários e verifique se o Cadastro do Usuário no Suricato foi atualizado. Por meio do parâmetro MV_TSAIURB, é possível definir se será enviado o crachá do funcionário do Protheus para o Cadastro de Usuário do Suricato. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | funcao |
|---|
| Cargo/Função Inclua uma função no Cadastro de Funções e verifique se o cadastro de Cargo no Suricato foi atualizado. Exclua a função e verifique se o cadastro de Cargo no Suricato foi atualizado. Realize a troca da função no Cadastro do Funcionário e verifique se o cadastro do Usuário no Suricato foi atualizado. O Suricato irá manter histórico do Cargo anterior e do atual. |
| Totvs custom tabs box items |
|---|
| Turno de Trabalho Realize troca de turno de trabalho do Funcionário e verifique se o cadastro do Usuário no Suricato foi atualizado. O Suricato irá manter histórico do turno anterior e do atual. Ao incluir um turno de trabalho no Cadastro de Turnos de Trabalho, não haverá integração do turno com o Suricato pois é necessário o preenchimento da tabela de horário padrão.
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | feriados |
|---|
| Cadastro de Feriados Inclua um feriado no Cadastro de Feriados e verifique se o cadastro de Dia Não Trabalhado no Suricato foi atualizado. Exclua o feriado e verificar se o cadastro de Dia Não Trabalhado no Suricato foi atualizado. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | sindicato |
|---|
| Cadastro de Sindicato Inclua um sindicato no Cadastro de Sindicatos e verificar se o cadastro de Pessoa Jurídica no Suricato foi atualizado. Exclua o sindicato e verifique se o cadastro de Pessoa Jurídica no Suricato foi atualizado. |
|
04. PRINCIPAIS FONTES
| Fonte | Descrição |
|---|
| PONM430 | Rotina de Carga Inicial (Integração Tsa) |
| PTSREPOBJ | Fonte com os métodos de integração do Suricato. |
| WSClient_WSRHTSAUserIntegration | Onde é possível capturar o Xml do método de integração. |
| WSClient_WSRHTSA... | Demais fontes dos métodos onde podemos pegar o xml enviado ao Suricato para os demais métodos. |
05. MÉTODOS
| Totvs custom tabs box |
|---|
| tabs | Integração Tsa |
|---|
| ids | integracaotsa |
|---|
|
A rotina de Integração TSA, geralmente é utilizada para a realização da carga inicial da integração. Ao executar a rotina, ela irá processar todos os métodos que enviam informações para o TSA/Suricato, que são: | Integração | Web Services |
|---|
| Empresa, Unidade e Lotação |
| | Cargos e Funções |
| | Sindicatos |
| | Turnos de Trabalho e Escala |
| | Controle de Ausências |
| | Centros de Custo |
| | Situação de Afastamento |
| | Funcionários |
| | Cadastro de Afastamento |
| | Exceções |
| | Ferias Afastamentos |
|
|
| HTML |
|---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|
