Web service com.senior.g5.rh.sm.fichaBasicaParceiros
Tipo de execução
Para cada tipo de execução, existem parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.
Autenticação
Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.
WSDL
- Síncrono: http://example.com/g5-senior-services/sm_Synccom_senior_g5_rh_sm_fichaBasicaParceiros?wsdl
- Assíncrono: http://example.com/g5-senior-services/sm_Asynccom_senior_g5_rh_sm_fichaBasicaParceiros?wsdl
- Agendado: http://example.com/g5-senior-services/sm_Scheduledcom_senior_g5_rh_sm_fichaBasicaParceiros?wsdl
Porta
FichaBasicaParceiros
Web service de integração que permite realizar alterações na Ficha Básica.
Disponível em todos os módulo.
**Necessita autenticação: **Sim
**Situação de versão: ** Atual
**Versão: **1
**Requisição: **
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:FichaBasicaParceiros> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <datAdm>DateTime</datAdm> <codCar>String</codCar> <codEsc>Integer</codEsc> <codFil>Integer</codFil> <numLoc>String</numLoc> <codCcu>String</codCcu> <numCtp>Integer</numCtp> <codFicFmd>String</codFicFmd> <datAltHct>DateTime</datAltHct> <codTap>Integer</codTap> <tipOpe>String</tipOpe> <codVinHvi>Integer</codVinHvi> <datAltHca>DateTime</datAltHca> <datAltHes>DateTime</datAltHes> <datAltHfi>DateTime</datAltHfi> <datAltHlo>DateTime</datAltHlo> <datAltCcu>String</datAltCcu> <serCtp>String</serCtp> <conRho>Integer</conRho> <codOemHct>String</codOemHct> <posTra>String</posTra> <numCad>Integer</numCad> <apuPonApu>Integer</apuPonApu> <codMotHca>Integer</codMotHca> <codTmaHes>Integer</codTmaHes> <conTovHlo>String</conTovHlo> <conFinCcu>Integer</conFinCcu> <digCar>String</digCar> <cadFol>String</cadFol> <numConHct>DateTime</numConHct> <iniAtu>DateTime</iniAtu> <nomFun>String</nomFun> <codDSiApu>Integer</codDSiApu> <carVagHca>String</carVagHca> <turInt>Integer</turInt> <conTosHlo>String</conTosHlo> <dexCtp>DateTime</dexCtp> <verInt>String</verInt> <datFimHct>DateTime</datFimHct> <motPos>Integer</motPos> <apeFun>String</apeFun> <codSinHsi>Integer</codSinHsi> <codEqp>Integer</codEqp> <locTraHlo>String</locTraHlo> <estCtp>String</estCtp> <tipTer>String</tipTer> <posObs>String</posObs> <tipCon>Integer</tipCon> <socSinHsi>String</socSinHsi> <codCat>Integer</codCat> <numCpf>String</numCpf> <defFis>String</defFis> <tipSex>String</tipSex> <possBHHsi>String</possBHHsi> <desSim>Integer</desSim> <numPis>Double</numPis> <codDef>Integer</codDef> <estCiv>Integer</estCiv> <usaBhrHsi>String</usaBhrHsi> <horBas>Integer</horBas> <dcdPis>DateTime</dcdPis> <benRea>String</benRea> <graIns>Integer</graIns> <codBhrHsi>Integer</codBhrHsi> <datAltHor>DateTime</datAltHor> <datNas>DateTime</datNas> <horSabHor>Integer</horSabHor> <codNac>Integer</codNac> <horSemHor>Time</horSemHor> <perPag>String</perPag> <horDsrHor>Time</horDsrHor> <emiCar>String</emiCar> <catEso>Integer</catEso> </parameters> </ser:FichaBasicaParceiros> </soapenv:Body> </soapenv:Envelope>
**Parâmetros da requisição: **
Nome | Preenchimento | Tipo | Descrição |
|---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizada na integração.
|
datAdm | Opcional | DateTime | Informar data de admissão:
Máscara: DD/MM/AAAA |
codCar | Opcional | String | Informar o código de cargo:
|
codEsc | Opcional | Integer | Informar o código da escala
ou se integrar com os módulos CP, PLR ou BS Máscara: Z[5]9[4] |
codFil | Opcional | Integer | Informar o código da filial do colaborador
|
numLoc | Opcional | String | Informar o código de local para o colaborador
|
codCcu | Opcional | String | Informar o centro de custo do colaborador
|
numCtp | Opcional | Integer | Informar o número da carteira de trabalho do colaborador
|
codFicFmd | Opcional | String | Definir a geração da ficha médica para o colaborador.
Se no módulo Segurança e Medicina (SM), em Medicina > Definições > Ficha Médica > Gerar Ficha Colaborador, estiver informado:
Observação: do contrário, informe o código da ficha médica que desejar para o colaborador. |
datAltHct | Opcional | DateTime | Informar data de alteração do histórico de contrato. Máscara: DD/MM/AAAA |
codTap | Opcional | Integer | Informar o motivo de alteração do posto de trabalho. O campo deverá ser preenchido somente quando a empresa utilizar posto de trabalho. Máscara: 9[3] |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
Valores: I - Inclusão A - Alteração E - Exclusão |
codVinHvi | Opcional | Integer | Informar código de vínculo
|
datAltHca | Opcional | DateTime | Informar a data de alteração do cargo: Obrigatório se:
Caso contrário, não informar Máscara: DD/MM/AAAA |
datAltHes | Opcional | DateTime | Informar a data de alteração da escala
ou integrar com os módulos CP, PLR ou BS Máscara: DD/MM/AAAA |
datAltHfi | Opcional | DateTime | Informar data de alteração de filial
Caso contrário, não informar Máscara: DD/MM/AAAA |
datAltHlo | Opcional | DateTime | Informar data de alteração do local
Caso contrário, não informar Máscara DD/MM/AAAA |
datAltCcu | Opcional | String | Informar data de alteração do centro de custo
Caso contrário, não informar. Máscara: DD/MM/AAAA |
serCtp | Opcional | String | Informar a série da carteira de trabalho
|
conRho | Opcional | Integer | Informar quais os colaboradores que serão contados na verificação do limite de colaboradores permitidos
Valores: 1 - Ronda Ponto e Refeitório Será considerado para a contagem de colaboradores tanto para o controle de ponto quanto para o controle de refeitório. 2 - Ronda Ponto Será considerado apenas para a contagem de colaboradores ativos para o controle de ponto. Será ignorado pelo Controle de feitório nos procedimentos de controle de refeitório. 3 - Ronda Refeitório Será considerado apenas para a contagem de colaboradores ativos para o controle de refeitório. Será ignorado pelo Controle de Ponto nos procedimentos de controle de ponto. 4 - Não Conta Não será considerado para a contagem de colaboradores ativos para o controle de ponto e nem para o controle de refeitório. Será ignorado pelo Controle de Ponto e Refeitório em todos os procedimentos. Valor Padrão: 1 Obs: Quando o sistema não estiver integrado com Controle de Refeitório, não é permitido informar os seguintes valores: 1 - Ronda Ponto e Refeitório 3 - Ronda Refeitório |
codOemHct | Opcional | String | Informar o código da outra empresa a qual o parceiro pertence.
|
posTra | Opcional | String | Posto de trabalho em que o colaborador atua. O campo deverá ser preenchido somente quando a empresa utilizar posto de trabalho. |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador.
|
apuPonApu | Opcional | Integer | Informar o tipo de apuração
Valores: 1 - Normal 2 - Dispensado do Ponto 3 - Somente Refeitório 4 - Dispensado do Ponto - Desconsidera Todas Marcações 5 - Sem Controle de Ponto e Refeitório 6 - Dispensado do Ponto - Desconsidera Marcações de Ponto |
codMotHca | Opcional | Integer | Informar o código de motivo de alteração de cargo
|
codTmaHes | Opcional | Integer | Informar o código da turma da escala
ou integrar com os módulos CP, PLR ou BS
Não informar se o módulo de integração for o CS, QL ou JR |
conTovHlo | Opcional | String | Informar turn-over de entrada
ou Alterar o local do colaborador
Caso contrário, não informar Valores: S - Sim N - Não |
conFinCcu | Opcional | Integer | Informar a conta financeira
Caso contrário, não informar. |
digCar | Opcional | String | Informar o dígito verificador da carteira de trabalho
|
cadFol | Opcional | String | Informe o cadastro do colaborador no sistema da folha de pagamento. Este código será utilizado na geração do arquivo texto com as horas para a folha.
Valor padrão: Número do Cadastro |
numConHct | Opcional | DateTime | Informar o número do contrato ao qual o parceiro pertence. Este campo é opcional Máscara: A[15] |
iniAtu | Opcional | DateTime | Informar início da atuação do colaborador no posto de trabalho. Obrigatório se na alteração, mudar o posto ou o tipo de atuação. Caso contrário, não informar. Máscara: DD/MM/AAAA |
nomFun | Opcional | String | Nome do colaborador
|
codDSiApu | Opcional | Integer | Código da definição de situação |
codSinHsi | Opcional | Integer | Informar código de sindicato
|
carVagHca | Opcional | String | Informar o código de cargo do novo cargo da vaga
Somente informar se:
|
turInt | Opcional | Integer | Informar o código da turma do intervalo
Informar somente se:
|
conTosHlo | Opcional | String | Informar turn-over de saída
ou Alterar o local do colaborador
Caso contrário, não informar Valores: S - Sim N - Não |
dexCtp | Opcional | DateTime | Informar a data de expedição da carteira de trabalho
Máscara DD/MM/AAAA |
verInt | Opcional | String | Informar uma opção de controle de interjornada
Valores: B - Bloquear, o sistema bloqueará a Programação, cuja sequência de horários não respeitar o limite da Interjornada. A - Alertar, o sistema fará um alerta, informando que o horário não está respeitando o limite da Interjornada. I - Ignorar o controle de horas da Interjornada. Valor Padrão: I |
datFimHct | Opcional | DateTime | Informar data final do histórico de contrato. Máscara: DD/MM/AAAA |
motPos | Opcional | Integer | Informar o motivo de alteração do posto de trabalho. O campo deverá ser preenchido somente quando a empresa utilizar posto de trabalho. Máscara: 9[3]. |
apeFun | Opcional | String | Apelido do colaborador
|
codEqp | Opcional | Integer | Informar o código da Equipe
|
locTraHlo | Opcional | String | Informar o local de trabalho na Rais
ou Alterar o local de um colaborador
|
estCtp | Opcional | String | Informar a unidade de federação da carteira de trabalho
Valores: AC - Acre AL - Alagoas AM - Amazonas AP - Amapá BA - Bahia CE - Ceará DF - Distrito Federal ES - Espírito Santo FN - Fernando de Noronha GO - Goiás MA - Maranhão MG - Minas Gerais MS - Mato Grosso do Sul MT - Mato Grosso PA - Pará PB - Paraíba PE - Pernambuco PI - Piauí PR - Paraná RJ - Rio de Janeiro RN - Rio Grande do Norte RO - Rondônia RR - Roraima RS - Rio Grande do Sul SC - Santa Catarina SE - Sergipe SP - São Paulo TO - Tocantins XX - Estrangeiro |
tipTer | Opcional | String | Informar uma opção de controle de interjornada
Valores: B - Bloquear, o sistema bloqueará a Programação, cuja sequência de horários não respeitar o limite da Interjornada. A - Alertar, o sistema fará um alerta, informando que o horário não está respeitando o limite da Interjornada. I - Ignorar o controle de horas da Interjornada. Valor Padrão: I |
posObs | Opcional | String | Observação do histórico de posto de trabalho. O campo poderá ser preenchido somente quando a empresa utilizar posto de trabalho. |
tipCon | Opcional | Integer | Informar o tipo de contrato entre empresa e colaborador Obrigatório se:
Valores: 1 - Empregado Normal 2 - Diretor Não-Empregado 3 - Trabalhador Rural 4 - Aposentado 5 - Estagiário 6 - Menor Aprendiz 7 - Prazo Determinado - Lei 9.601/98 8 - Diretor Aposentado 9 - Agente Público 10 - Professor 11 - Cooperado 12 - Trabalhador Doméstico |
socSinHsi | Opcional | String | Informar se é sindicalizado Obrigatório se:
Caso contrário, não informar
Valores: S - Sim, o colaborador é sindicalizado N - Não é sindicalizado |
codCat | Opcional | Integer | Informar o código da categoria
|
numCpf | Opcional | String | Informar o CPF do colaborador:
Máscara 999.999.99-99 Observações:
|
defFis | Opcional | String | Informa se o colaborador é uma pessoa com deficiência
Valores S - Sim N - Não |
tipSex | Opcional | String | Informar o sexo do colaborador
Valores: M - Masculino F - Feminino |
possBHHsi | Opcional | String | Informar se o colaborador possui banco de horas Disponível apenas se o cliente possuir o módulo CP na Proprietária . |
desSim | Opcional | String | Descrição detalhada da jornada para o eSocial. Este campo será utilizado apenas quando o campo Descrição de Jornada eSocial Simplificadada tela de assinalamentos, acessada através do menu Diversos > Assinalamentos ( ), estiver definido com a opção “S- Sim”. |
numPis | Opcional | Double | Informar o número do PIS do colaborador
Máscara: 999.99999.99.9 Observações:
|
codDef | Opcional | Integer | Informa o código da deficiência do colaborador
|
estCiv | Opcional | Integer | Informar o estado civil do colaborador
Valores: 1 - Solteiro 2 - Casado 3 - Divorciado 4 - Viúvo 5 - Concubinato 6 - Separado 9 - Outros |
usaBhrHsi | Opcional | String | Informar como será a utilização do banco de horas, sendo “1 - Por abrangência do Banco” ou “2 - Pelo histórico do Sindicato”. Somente informar quando o campo Possui banco de horasestiver definido como “S - Sim”. Disponível apenas se o cliente possuir o módulo CP na Proprietária . |
horBas | Opcional | Integer | informar o código do horário base do colaborador
Caso contrário, não informar |
dcdPis | Opcional | DateTime | Informar a data de cadastramento no Pis/Pasep.
Máscara DD/MM/AAAA |
benRea | Opcional | String | Informar se o colaborador encontra-se reabilitado ou não para o trabalho
Valores S - Sim N - Não |
graIns | Opcional | Integer | Indicar a escolaridade de acordo com a codificação utilizada pela Rais
Valores: 1 - Analfabeto 2 - 4ª Série Incompleta 3 - 4ª Série Completa 4 - 5ª a 8ª Série Incompleta 5 - 1º Grau Completo (1ª a 8ª Série) 6 - 2º Grau Incompleto 7 - 2º Grau Completo 8 - Superior Incompleto 9 - Superior Completo 10 - Pós-Graduação 11 - Mestrado 12 - Doutorado 13 - Ph.D. |
codBhrHsi | Opcional | Integer | Informar o código do banco de horas Somente informado quando o campo Utiliza bancoestiver definido como “2 - Pelo histórico do Sindicato”. Disponível apenas se o cliente possuir o módulo CP na Proprietária . |
datAltHor | Opcional | DateTime | Informar a data de alteração do horário
Caso contrário, não informar Máscara: DD/MM/AAAA |
datNas | Opcional | DateTime | Informar a data de nascimento do colaborador
Máscara: DD/MM/AAAA |
horSabHor | Opcional | Integer | Informar a código do horário de sábado
Nunca informar se:
|
codNac | Opcional | Integer | Informar o código da nacionalidade, de acordo com a codificação utilizada para a Rais.
|
horSemHor | Opcional | Time | Informar as horas semanais
Caso contrário, não informar Máscara: HH:MM |
perPag | Opcional | String | Indicar o período com que se efetua o pagamento ao parceiro. Assim ele constará somente dos processamentos de folha respectivos. M - Mensal S - Semanal Q - Quinzenal |
horDsrHor | Opcional | Time | Informar as horas DSR
Caso contrário, não informar Máscara: HH:MM |
emiCar | Opcional | String | Informar se deve emitir etiqueta ou cartão ponto para este colaborador
Caso contrário, não informar Valores S - Imprimir cartão ponto para este colaborador. N - Não imprimir cartão ponto para este colaborador |
cateSo | Opcional | Integer | Informar a categoria do colaborador no eSocial Valores: 101 - Empregado - Geral 102 - Empregado - Trabalhador Rural por Pequeno Prazo da Lei 11.718/2008 103 - Empregado - Aprendiz 104 - Empregado - Doméstico 105 - Empregado - contrato a termo firmado nos termos da Lei 9601/98 106 - Empregado - contrato por prazo determinado nos termos da Lei 6019/74 107 - Trabalhador não vinculado ao RGPS com direito ao FGTS 201 - Trabalhador Avulso - Portuário 202 - Trabalhador Avulso - Não Portuário (Informação do Sindicato) 203 - Trabalhador Avulso - Não Portuário (Informação do Contratante) 301 - Servidor Público - Titular de Cargo Efetivo 302 - Servidor Público - Ocupante de Cargo exclusivo em comissão 303 - Servidor Público - Exercente de Mandato Eletivo 304 - Servidor Público - Agente Público 305 - Servidor Público vinculado a RPPS indicado para conselho ou órgão representativo, na condição de representante do governo, órgão ou entidade ad administração pública. 401 - Dirigente Sindical - Em relação a Remuneração Recebida no Sindicato. 701 - Contrib. Individual - Autônomo contratado por Empresas em geral 702 - Contrib. Individual - Autônomo contratado por Contrib. Individual, por pessoa física em geral, ou por missão diplomática e repartição consular de carreira estrangeiras 703 - Contrib. Individual - Autônomo contratado por Entidade Beneficente de Assistência Social isenta da cota patronal 704 - Excluído. 711 - Contrib. Individual - Transportador autônomo contratado por Empresas em geral 712 - Contrib. Individual - Transportador autônomo contratado por Contrib. Individual, por pessoa física em geral, ou por missão diplomática e repartição consular de carreira estrangeiras 713 - Contrib. Individual - Transportador autônomo contratado por Entidade Beneficente de Assistência Social isenta da cota patronal 721 - Contrib. Individual - Diretor não empregado com FGTS 722 - Contrib. Individual - Diretor não empregado sem FGTS 731 - Contrib. Individual - Cooperado que presta serviços a empresa por intermédio de cooperativa de trabalho 732 - Contrib. Individual - Cooperado que presta serviços a Entidade Beneficente de Assistência Social isenta da cota patronal ou para pessoa física 733 - Contrib. Individual - Cooperado eleito para direção da Cooperativa 734 - Contrib. Individual - Transportador Cooperado que presta serviços a empresa por intermédio de cooperativa de trabalho 735 - Contrib. Individual - Transportador Cooperado que presta serviços a Entidade Beneficente de Assistência Social isenta da cota patronal ou para pessoa física 736 - Contrib. Individual - Transportador Cooperado eleito para direção da Cooperativa. 741 - Contrib. Individual - Cooperado filiado a cooperativa de produção. 751 - Contrib. Individual - Micro Empreendedor Individual, quando contratado por PJ 901 - Estagiário 997 - Demitido com data anterior à sucessão 999 - Não Aplica |
Resposta:
O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, a mensagem do erro ocorrido.
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:FichaBasicaParceirosResponse> <result> <numEmp>Integer</numEmp> <numCad>Integer</numCad> <erroExecucao>String</erroExecucao> </result> </ser:FichaBasicaParceirosResponse> </soapenv:Body> </soapenv:Envelope>
Atributos da resposta:
Nome | Preenchimento | Tipo | Descrição |
|---|---|---|---|
numEmp | Obrigatório | Integer | Número da empresa. |
numCad | Obrigatório | Integer | Número do cadastro. |
erroExecucao | Opcional | String | Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:
|
English
Español

English
Español

