📘 Padrão de Envio para a Senior

🔄 Integração via Webservices

A Senior utiliza webservices padrão, com troca de dados em formato XML.

Para esta integração, são utilizados os seguintes webservices de forma obrigatória:

Consultar colaboradores pelo CPF: https://documentacao.senior.com.br/gestao-de-pessoas-hcm/6.10.4/webservices/com_senior_g5_rh_fp_consultarcolaboradorporcpf.htm

Ficha básica: https://documentacao.senior.com.br/gestao-de-pessoas-hcm/6.10.3/webservices/com_senior_g5_rh_fp_fichabasica.htm

Ficha complementar:https://documentacao.senior.com.br/gestao-de-pessoas-hcm/6.10.3/webservices/com_senior_g5_rh_fp_fichacomplementar.htm

Ficha dependentes: https://documentacao.senior.com.br/gestao-de-pessoas-hcm/6.10.3/webservices/com_senior_g5_rh_fp_dependentes.htm

⚠️ Caso o cliente opte por desenvolver um webservice customizado, será necessário contratar um fluxo de integração específico para esse modelo.

🛠️ Requisitos para Conexão

O cliente deve disponibilizar os seguintes itens:

Configurar e expor os serviços: É necessário expor os webservices acima na internet. Se o cliente não puder expor o serviço publicamente, deverá liberar o acesso a alguns IPs específicos. Caso contrário, será necessário contratar o modelo de integração customizado. URLs dos webservices: Endereços dos serviços a serem utilizados. Credenciais do webservice: Usuário e senha. Observação: Existe um modelo de texto para ser enviado ao suporte Sênior para liberação dos IPs da N8N. Ambiente de Homologação: Deixar o ambiente de homologação ativo em tempo de projeto.

⚠️ Principais erros na integração Senior

Mensagem de erro	Relação de campo	Ação	Contexto
"erroExecucao": "Ocorreu um erro ao executar o serviço "AP - Ficha Básica": Não foi possível atribuir o valor "" para o campo "Motivo" da tela "FRHISCAR - Histórico Cargo".\r\nMotivo: É necessário informar Motivo"	codMotHca	Adicionar campo fixo valor "1"	Geralmente está ligado ao campo de cargo onde é necessário sempre informá-lo caso seja enviado codCar
"erroExecucao": "Ocorreu um erro ao executar o serviço "AP - Ficha Básica": O campo "BTNOK" não está disponível na tela "FRHISETB".",	numLoc		"https://suporte.senior.com.br/hc/pt-br/articles/6977320445460-HCM-Webservice-O-campo-BTNOK-n%C3%A3o-est%C3%A1-dispon%C3%ADvel-na-tela-FRHISLOC- Este artigo explica que pode estar relacionado ao numLoc, porém ainda assim um erro meio genérico que deve ser validado em detalhes Geralmente está relacionado ao campo que aparece no final do erro, neste exemplo apareceu FRHISETB, olhando para as últimas letras estava relacionado ao campo codEtb que removendo conseguimos enviar."
Ocorreu um erro ao executar o serviço "AP - Ficha Básica": O campo "BUTTON1" não está disponível na tela "FRMMESSAGE".	codFicFmd	Remover campo/Não enviar	É um erro muito genérico, e pode ser que ao invés de apareceer "BUTTON1" apareça "BUTTON2". Em um cliente, isso estava relacionado ao campo codFicFmd que foi necessário não enviarmos a tag visto que o pré-colaborador tem um pré-cadastro para a geração de ficha médica.
Ocorreu um erro ao executar o serviço "AP - Ficha Básica": O campo "Sindicalizado" não está disponível na tela "FRHISHSI - Histórico Sindicato".	socSinHsi	Remover campo/Não enviar
"Ocorreu um erro ao executar o serviço "AP - Ficha Básica": O campo "SEINDADM" não está disponível na tela "FRADMFUN"	indAdm	Remover campo/Não enviar	Esse erro acontece por que é um campo que não deveria ser enviado no caso de estagiario, então é preciso remover, outros campos tem essa relação: segDes e admeSo
Ocorreu um erro ao executar o serviço "AP - Ficha Básica": Não foi possível atribuir o valor "00:00" para o campo "Hora Inclusão" da tela "FR034FUN - Empregados - Básica".\r\n\r\nMotivo: Não é permitido executar nas regras o comando "Mensagem" com "Retorna" quando a instância da aplicação é de serviço.	horInc	Solicitar para TI (Cliente) atualizar a base de Homologação	Caso esteja informando os campos corretamente e aparentemente não haja nenhum erro ligado a este campo, o problema pode estar relacionado a base de homologação estar desatualizada
Ocorreu um erro ao executar o serviço "AP - Ficha Básica": O campo "Local" não está disponível na tela "FR034FUN - Empregados - Básica".00	nivSalHsa	Incluir campo	Em um cliente precisou inserir esse campo para superar o erro
Ocorreu um erro ao executar o serviço "AP - Ficha Complementar": O campo "BtnAlterar" não está disponível na tela "FR034CPL - Ficha Complementar - Ficha	BtnAlterar		Conferir se o candidato é importado na integração. Ignorar o erro no fluxo
Error Ficha Básica: Ocorreu um erro ao executar o serviço "AP - Ficha Básica": Não foi possível atribuir o valor "" para o campo "Data Adm." da tela "FRADMFUN - Informações Admissionais". Motivo: É necessário informar Data de Admissão nesta Empresa	DatAdm		Alterar a data de admissão (campo datAdm)
Ocorreu um erro ao executar o serviço "AP - Ficha Básica Terceiros": O campo "BtnFechar" não está disponível na tela "FR034TER - Terceiros - Cadastro"	btnAlterar		Conferir se o candidato é importado na integração. Ignorar o erro no fluxo