Implementada melhoria na funcionalidade de retorno dos Web Services, com a disponibilização da geração do conteúdo em arquivo. Sendo assim, criou-se os seguintes Parâmetros:
· MV_TSADARQ: Define o local onde os arquivos de log de retorno da integração com o WebServices do aplicativo TSA é gravado
· MV_TSATLOG: Define qual o tipo de envio do Log de inconsistências da integração do Ponto Eletrônico X TSA. Com as seguintes opções:
· 0 = Não gera o conteúdo;
· 1 = Envia o conteúdo por e-mail apenas (como já existia);
· 2 = Envia o conteúdo em arquivo apenas;
· 3 = Ambos, envia por email e gera no diretório especificado.
O Parâmetro MV_TSATLOG permite quetodas as rotinas de integração com o aplicativo TSA (Totvs Controle de Acesso) gerem um log de retorno com as críticas realizadas pelas regras do aplicativo.
Exemplo:
Em Centro de Custos (CTBA030) toda manipulação é enviada para o aplicativo TSA, tendo como retorno a string abaixo:
Rotina Protheus: CTBA030 – Centro de Custo
Nome do Serviço: CostCenter
Nome do Arquivo: sc023830_costcenter.txt
Conteudo:
CDESCRIPTION: CENTRO DE CUSTO - TESTE TSA
CEXTERNALKEY: 9901000015
CSTATUSCODE: (vide Tabela de Ocorrências )
CSTATUSDESCRIPTION: (vide Tabela de Ocorrências)
WSCERR044 / Não foi possível POST : URL http://localhost:8080/tsa-ejb-11.6.0/CostCenterIntegrationServiceBean ( 10061 : Connection refused. )
ADVPL WSDL Client 1.110425 / TOTVS Manufatura MSSQL7 P11_bra on 20111017 15:12:13
Recomenda-se que a aplicação das rotinas envolvidas nessa implementação seja realizada apenas no início do próximo período de apontamento e não no período em andamento.
· Segue abaixo os nomes das rotinas e seus serviços relacionados:
Rotina | Nome do Serviço |
Schedule Empresa | LegalPerson |
Schedule Unidade | Unit |
Schedule Unidade de Lotação | AllocationUnit |
Schedule Localidade | Location |
Schedule Tabelas 30/31 – Módulo Configurador | AbsenceReason, UnitAbsenceReason |
CSAM080 – Cadastro de Aumento programado | User |
CTBA030 – Cadastro de Centro de Custos | CostCenter |
GPEA010 – Cadastro de Funcionários | User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason |
GPEA030 – Cadastro de Funções | PositionLevel |
GPEA080 – Cadastro de Turno de Trabalho | ShiftWork |
GPEA180 – Cadastro de Transferência de Funcionários | Scale |
GPEA240 – Cadastro de Afastamentos | UserAbsenceReason |
GPEA265 – Cadastro de Autônomos | User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason |
GPEA340 – Cadastro de Sindicatos | SindicatoLegal |
GPEM030 – Cadastro de Férias | User, UserAbsenceReason |
GPEM040 – Cadastro de Rescisão | User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason |
GPEM060 – Férias Coletivas/Programadas | User, UserAbsenceReason |
PONA020 – Cadastro de Feriado | DayNotWorked |
PONA080 – Manutenção da Tabela de Horário Padrão | ShiftWork,Scale |
PONA090 – Cadastro de Exceções por Periodo | Exception |
PONA140 – Cadastro de Exceções por Funcionário | Exception |
PONA160 – Troca de Turno | User, UserShiftWork |
PONM430 – Integração TSA | Todos |
TRMA100 – Cadastro de Funcionários | User, UserShiftWork, UserLocation, UserRoleBadge, UserCostCente, UserAllocationUnit, UserAbsenceReason, RemoveUserAbsenceReason |
TRMA210 – Cadastro de Funções | Position |
Tabela de Serviços Disponibilizados – Web Services:
· Serviços disponibilizados para configuração de rotinas no Schedule:
Descrição | Serviço para atualização agendada da integração Protheus x TSA, cadastrado no módulo configurador, item menu Ambiente/Schedule (opção processos especiais). |
Nome do Serviço | WFRHTrep |
Parâmetros disponíveis | EMPRESA/UNIDADE/LOTACAO |
SINDICATO |
TURNO/ESCALA |
FUNCIONÁRIO |
AUSÊNCIAS |
EXCEÇÕES |
CARGOS/FUNÇÕES |
CCUSTO |
AFASTAMENTOS |
Parâmetro Empresa | Informar o código da empresa |
Parâmetro Filial | Informar o código da filial |
Exemplo para execução | WFRHTRep("EMPRESA/UNIDADE/LOTACAO",”99”,”01”) |
Tabela de Ocorrências na Integração com Aplicativo TSA:
Código do Retorno | Descrição do código de retorno |
Informações |
00101 | Inclusão/Alteração da Empresa Jurídica realizada com sucesso. |
00102 | Chave externa da Empresa Jurídica é obrigatória. |
00103 | Deve ser informado pelo menos o CNPJ ou CEI. |
00104 | Exclusão da unidade realizada com sucesso. |
00105 | Deve ser informado apenas um dos campos: CNPJ ou CEI. |
00106 | Nome da pessoa jurídica é obrigatória. |
00107 | Pessoa jurídica está sendo usada, não é possível realizar a exclusão. |
00100 | Erro Técnico (retornar erros ocorridos durante a execução). |
Código do Retorno | Descrição do código de retorno |
Informações |
00201 | Inclusão/Alteração da unidade realizada com sucesso. |
00202 | Chave externa da Unidade é obrigatória. |
00203 | Chave externa de Pessoa Jurídica é obrigatória. |
00204 | Código da unidade é obrigatório. |
00205 | Tipo da unidade é obrigatório. |
00206 | Exclusão da unidade realizada com sucesso. |
00207 | Inclusão de relacionamento realizada com sucesso. |
00208 | Exclusão de relacionamento realizada com sucesso. |
00209 | Inclusão de relacionamento realizada parcialmente. |
00210 | Unidade está sendo usada, não é possível realizar a exclusão. |
00211 | Inclusão de relacionamento não realizada, nenhuma chave externa é existente. |
00212 | Exclusão de relacionamento não realizada, nenhuma chave externa é existente. |
00213 | Usuário ou senha são inválidos. |
00214 | Unidade está sendo usada, não é possível realizar a exclusão. |
00215 | Descrição da Unidade é Obrigatória |
00216 | Nenhum registro encontrado com a chave externa |
00200 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00301 | Inclusão/Alteração do Centro de Custo realizada com sucesso. |
00302 | Chave externa do Centro de Custo é obrigatória. |
00303 | Exclusão da unidade realizada com sucesso. |
00304 | Usuário ou senha são inválidos. |
00305 | Descrição do Centro de Custo é obrigatória. |
00306 | Centro de Custo está sendo usado, não é possível realizar a exclusão. |
00300 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00401 | Inclusão/Alteração da Unidade de Lotação realizada com sucesso. |
00402 | Chave externa da Unidade de Lotação é obrigatória. |
00403 | Exclusão da Unidade de Lotação realizada com sucesso. |
00404 | Usuário ou senha são inválidos. |
00405 | Descrição da Unidade de Lotação é obrigatória. |
00406 | Unidade de Lotação está sendo usada, não é possível realizar a exclusão. |
00400 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00501 | Inclusão/Alteração do Turno realizada com sucesso. |
00502 | Chave externa do Turno é obrigatória. |
00503 | Data de início é obrigatória. |
00504 | Data de início deve ser uma data válida. |
00505 | Exclusão do Turno realizada com sucesso. |
00506 | Pelo menos uma escala deve estar informada e deve conter pelo menos um intervalo de horário do tipo Jornada. |
00507 | Descrição é obrigatória. |
00509 | Turno está sendo usado, não é possível realizar a exclusão. |
00500 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00601 | Inclusão/Alteração da Grade de Trabalho realizada com sucesso. |
00602 | Chave externa da Grade de trabalho é obrigatória. |
00603 | A chave externa do turno é obrigatório. |
00604 | A escala deve conter pelo menos um par de horário do tipo Jornada. |
00605 | Os pares de horários informados estão incorretos. |
00606 | A sequência de inicio é obrigatória. |
00607 | A sequência de término é obrigatória. |
00608 | O tipo é obrigatório. |
00609 | A entrada de jornada é obrigatória. |
00610 | A saída de jornada é obrigatória. |
00611 | A sequência de início não pode ser superior a sequência de término. |
00612 | Exclusão do Turno realizada com sucesso. |
00613 | Usuário ou senha são inválidos. |
00614 | Escala está sendo usada, não é possível realizar a exclusão. |
00600 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00701 | Inclusão/Alteração da Pessoa física realizada com sucesso. |
00702 | Chave externa da Pessoa Física é obrigatória. |
00703 | Pelo menos o CPF ou RG deve ser informado. |
00704 | Exclusão da pessoa física realizada com sucesso. |
00705 | Usuário ou senha são inválidos. |
00706 | Pessoa física está sendo usada, não é possível realizar a exclusão. |
00700 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00801 | Inclusão/Alteração da Localidade realizada com sucesso. |
00802 | Chave externa da Localidade é obrigatória. |
00803 | Exclusão da localidade realizada com sucesso. |
00804 | Usuário ou senha são inválidos. |
00805 | Pelo menos País, Estado ou Cidade deve ser informada. |
00806 | Descrição de País deve ser informada. |
00807 | Descrição de Estado deve ser informada. |
00808 | Descrição de Cidade deve ser informada. |
00809 | Localidade está sendo usada, não é possível realizar a exclusão. |
00800 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
00901 | Inclusão/Alteração do cargoNivel realizada com sucesso. |
00902 | Chave externa do cargoNivel é obrigatória. |
00903 | Descrição é obrigatória. |
00904 | Exclusão do cargoNivel realizada com sucesso. |
00905 | Usuário ou senha são inválidos. |
00906 | CargoNivel está sendo usado, não é possível realizar a exclusão. |
00900 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
01001 | Inclusão/Alteração da situação de afastamento realizada com sucesso. |
01002 | Chave externa da situação de afastamento é obrigatória. |
01003 | Tipo da situação de afastamento é obrigatório. |
01004 | Exclusão da situação de afastamento realizada com sucesso. |
01005 | Data início e Data término são obrigatórias. |
01006 | Exclusão do relacionamento realizado com sucesso. |
01007 | Usuário ou senha estão inválidos. |
01008 | Descrição da situação de afastamento é obrigatória. |
01009 | Situação de Afastamento está sendo usada, não é possível realizar a exclusão. |
01010 | Inclusão do relacionamento realizado com sucesso. |
01000 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
01101 | Inclusão/Alteração da exceção realizada com sucesso. |
01102 | Chave externa da exceção é obrigatória. |
01103 | Tipo da exceção é obrigatório. |
01104 | Origem é obrigatório. |
01105 | Data início é obrigatória. |
01106 | Data Término é obrigatória. |
01112 | Exclusão da exceção realizada com sucesso. |
01113 | Pelo menos um período deve ser informado. |
01114 | Usuário ou senha inválidos. |
01115 | Os pares de horários informados estão incorretos. |
01106 | Direção é obrigatório. |
01100 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
01201 | Inclusão/Alteração do dia não trabalhado realizado com sucesso. |
01202 | Chave externa do dia não trabalhado é obrigatória. |
01203 | Recorrente é obrigatório. |
01204 | Data é obrigatória |
01205 | Exclusão do dia não trabalhado realizada com sucesso. |
01206 | O turno deve ser informado. |
01207 | A localidade deve ser informada |
01208 | Usuário ou senha Inválidos. |
01209 | Dia não Trabalho está sendo usado, não é possível realizar a exclusão. |
01200 | Erro Técnico (retornar erros ocorridos durante a execução) |
01210 | Inclusão do relacionamento Dia Não Trabalhado/Localidade/Turno realizado com sucesso. |
01211 | Exclusão do relacionamento Dia Não Trabalhado/Localidade/Turno realizado com sucesso. |
Código do Retorno | Descrição do código de retorno |
Informações |
01301 | Inclusão/Alteração do usuário realizado com sucesso. |
01302 | Chave externa do usuário não foi informada. |
01303 | Chave externa de pessoa física não foi informada. |
01304 | O tipo papel não foi informado. |
01305 | Data início de validade do turno deve ser informada. |
01306 | Data término de validade do turno deve ser informada. |
01307 | Data início de validade do Centro de custo deve ser informada. |
01308 | Data término de validade do Centro de Custo deve ser informada. |
01309 | Data início de validade do CargoNivel deve ser informada. |
01310 | Data término de validade do CargoNivel deve ser informada. |
01311 | Data início de validade da Unidade de Lotação deve ser informada. |
01312 | Data término de validade da Unidade de Lotação deve ser informada. |
01313 | Data início de validade da Localidade deve ser informada. |
01314 | Data término de validade da Localidade deve ser informada. |
01315 | Chave externa de pessoa Física não existe. |
01316 | Chave externa de turno não existe. |
01317 | Chave externa de centro de custo não existe. |
01318 | Chave externa de cargonivel não existe. |
01319 | Chave externa de unidade de lotação não existe. |
01320 | Chave externa de localidade não existe. |
01321 | Chave externa de usuário não existe. |
01322 | Relacionamento incluído/alterado com sucesso. |
01323 | Usuário ou senha Inválidos. |
01324 | Usuário está sendo usado, não é possível realizar a exclusão. |
01325 | Exclusão do usuário realizada com sucesso. |
01326 | Exclusão do relacionamento de usuário com “nome do relacionamento”, realizada com sucesso. |
01327 | Exclusão do relacionamento de usuário com “nome do relacionamento”, não realizada. |
01301 | Inclusão/Alteração do usuário realizado com sucesso. |
01302 | Chave externa do usuário não foi informada. |
01303 | Chave externa de pessoa física não foi informada. |
01300 | Erro Técnico (retornar erros ocorridos durante a execução) |
Código do Retorno | Descrição do código de retorno |
Informações |
01401 | Importação da batida realizada no REP: “número do rep” e NSR: “número do nsr” foi importada com sucesso. |
01402 | Importação da batida realizada no REP: “número do rep” e NSR: “número do nsr” não foi importada. |
01400 | Erro Técnico (retornar erros ocorridos durante a execução) |
As implementações descritas nesse documento somente se aplicam aos dados gerados após a atualização do RPO. Os dados gerados anteriormente, não são contemplados pelas modificações realizadas. Além disso, as alterações são extensas e devem refletir na regra de negócios da empresa, portanto, os impactos dessa atualização devem ser analisados cuidadosamente. Assim, antes de realizar a atualização e proceder com a adequação das tabelas é imprescindível que realize a cópia das Tabelas utilizadas pelo SIGAPON.
