PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas | HCM - versão 6.10.4

Web service com.senior.g5.rh.hr.fichaBasicaTerceiros

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

Porta

FichaBasicaTerceiros

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

**Requisição: **

<soapenv:Envelope xmlns:ser=“http://services.senior.com.br” xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/”>
<soapenv:Body>
<ser:FichaBasicaTerceiros>
<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>
<modPag>String</modPag>
<codFicFmd>String</codFicFmd>
<cateSo>Integer</cateSo>
<datAltHct>DateTime</datAltHct>
<natDesHna>Integer</natDesHna>
<codTap>Integer</codTap>
<gridUsos>
<tipOpe>String</tipOpe>
<tipUso>Integer</tipUso>
</gridUsos>
<tipOpe>String</tipOpe>
<codVinHvi>Integer</codVinHvi>
<datAltHca>DateTime</datAltHca>
<datAltHes>DateTime</datAltHes>
<datAltHfi>DateTime</datAltHfi>
<datAltHlo>DateTime</datAltHlo>
<datAltCcu>String</datAltCcu>
<serCtp>String</serCtp>
<codBan>Integer</codBan>
<conRho>Integer</conRho>
<codOemHct>String</codOemHct>
<posTra>String</posTra>
<numCad>Integer</numCad>
<apuPonApu>Integer</apuPonApu>
<codMotHca>Integer</codMotHca>
<codTmaHes>Integer</codTmaHes>
<conTov>String</conTov>
<conTovHlo>String</conTovHlo>
<conFinCcu>Integer</conFinCcu>
<digCar>String</digCar>
<codAge>Integer</codAge>
<cadFol>String</cadFol>
<numConHct>DateTime</numConHct>
<iniAtu>DateTime</iniAtu>
<nomFun>String</nomFun>
<artCLT>Integer</artCLT>
<funEsoHca>String</funEsoHca>
<turInt>Integer</turInt>
<conTosHlo>String</conTosHlo>
<dexCtp>DateTime</dexCtp>
<tpcPix>Integer</tpcPix>
<verInt>String</verInt>
<datFimHct>DateTime</datFimHct>
<motPos>Integer</motPos>
<apeFun>String</apeFun>
<codDSi>Integer</codDSi>
<carVagHca>String</carVagHca>
<codEqp>Integer</codEqp>
<locTraHlo>String</locTraHlo>
<estCtp>String</estCtp>
<chvPix>String</chvPix>
<assPpr>Integer</assPpr>
<posObs>String</posObs>
<tipSex>String</tipSex>
<codSinHsi>Integer</codSinHsi>
<codCat>Integer</codCat>
<numCpf>String</numCpf>
<tpCtBa>Integer</tpCtBa>
<codFor>Integer</codFor>
<estCiv>Integer</estCiv>
<socSinHsi>String</socSinHsi>
<desSim>Integer</desSim>
<numPis>Double</numPis>
<conBan>Double</conBan>
<insCur>Integer</insCur>
<graIns>Integer</graIns>
<possBHHsi>String</possBHHsi>
<horBas>Integer</horBas>
<dcdPis>DateTime</dcdPis>
<digBan>String</digBan>
<tipTer>String</tipTer>
<datNas>DateTime</datNas>
<usaBhrHsi>String</usaBhrHsi>
<datAltHor>DateTime</datAltHor>
<perPag>String</perPag>
<codNac>Integer</codNac>
<codBhrHsi>Integer</codBhrHsi>
<horSabHor>Integer</horSabHor>
<emiCar>String</emiCar>
<catTer>String</catTer>
<horSemHor>Time</horSemHor>
<defFis>String</defFis>
<apoIda>String</apoIda>
<horDsrHor>Time</horDsrHor>
<codDef>Integer</codDef>
<desSimHor>String</desSimHor>
<benRea>String</benRea>
<racCor>Integer</racCor>
<catSef>Integer</catSef>
<faiIns>Integer</faiIns>
<gpsTri>String</gpsTri>
<emtCar>String</emtCar>
<opcAtu>String</opcAtu>
<dctIns>Integer</dctIns>
<dedIns>Integer</dedIns>
<fatTpo>Integer</fatTpo>
<perIss>Integer</perIss>
<codLim>Integer</codLim>
<perTra>Integer</perTra>
<retTrp>String</retTrp>
<perIrt>Integer</perIrt>
</parameters>
</ser:FichaBasicaTerceiros>
</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.


  • Obrigatório

  • Chave

datAdm

Opcional

DateTime

Informar data de admissão:


  • Obrigatório na inclusão


Máscara:


DD/MM/AAAA

codCar

Opcional

String

Informar o código de cargo:


  • Obrigatório

codEsc

Opcional

Integer

Informar o código da escala
- Obrigatório se:
- A empresa utilizar escala de horários
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


  • Obrigatório se:

  • For inclusão

numLoc

Opcional

String

Informar o código de local para o colaborador


  • Obrigatório se:

  • Incluir um novo colaborador

codCcu

Opcional

String

Informar o centro de custo do colaborador


  • Opcional

  • Não informar para os módulos PLR, BS, SM e JR


  • Máscara: U[18]

numCtp

Opcional

Integer

Informar o número da carteira de trabalho do colaborador


  • Opcional

  • Não informar se o módulo de integração for o PLR

modPag

Opcional

String

Informar o modo de pagamento


  • Obrigatório se:

  • O módulo de integração for AP ou PLR

Caso contrário, não informar



Valores:


C - Em cheque


R - Relação bancária


D - Em dinheiro


O - Ordem de Pagamento

codFicFmd

Opcional

String

Definir a geração da ficha médica para o colaborador.

  • Somente informar se for integrado com o módulo Segurança e Medicina (SM).

Se no módulo Segurança e Medicina (SM), em Medicina > Definições > Ficha Médica > Gerar Ficha Colaborador, estiver informado:

  • “N”: não informar o campo codFicFmd;
  • “S”: informar no campo codFicFmd a string:
    • “AUTO”: caso deseje gerar automaticamente a ficha.
  • “C”: informar no campo codFicFmd a string:
    • “CONFIRMA”: caso deseje gerar a ficha médica;
    • “CANCELA”: caso deseje gerar a ficha médica.
  • “U”: informar no campo codFicFmd a string:
    • “NOVO”: caso deseje que o módulo Segurança e Medicina (SM) gere um novo código da ficha médica.

Observação: do contrário, informe o código da ficha médica que desejar para o colaborador.

cateSo

Opcional

Integer

Informar a categoria do colaborador no eSocial


  • Obrigatório


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


999 - Não Aplica

datAltHct

Opcional

DateTime

Informar data de alteração do histórico de contrato.



Máscara:


DD/MM/AAAA

natDesHna

Opcional

Integer

Informar o código da nova natureza de despesa do colaborador.

  • Esse parâmetro não deve ser preenchido quando o campo Usa Natureza Despesa, da Definição da Contabilização (FR048DEF), estiver preenchido com valor “N - Não”.

Quando o campo Usa Natureza Despesa estiver preenchido com valor “S - Sim”, o preenchimento do parâmetro é obrigatório.

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]

gridusos

Opcional

Set

Permite distinguir os terceiros cadastrados pelo seu uso.

gridUsos.tipOpe

Opcional

String

Tipo da operação a ser efetuada no registro de Uso


  • Obrigatório


Valores:


I - Inclusão


A - Alteração


E - Exclusão

gridUsos.TipUso

Opcional

Integer

Tipo de Uso


  • Obrigatório


Exemplo de valores:


1 - Diretores


2 - Terceiros


3 - Participantes Curso


4 - Instrutores Curso


5 - Nossos Advogados


6 - Advogados Contrários


7 - Parte Contrária


8 - Transportador


9 - Coordenadores Cursos


10 - Produto Rural


11 - Área Médica


12 - Candidatos


13 - Quadro Funcional

tipOpe

Obrigatório

String

Tipo da operação a ser efetuada na integração


  • Obrigatório


Valores:


I - Inclusão


A - Alteração


E - Exclusão

codVinHvi

Opcional

Integer

Informar código de vínculo


  • Obrigatório quando o módulo de integração não for SM, RS e TR

  • Não informar na alteração

datAltHca

Opcional

DateTime

Informar a data de alteração do cargo:


Obrigatório se:


  • Na alteração, mudar o código de cargo

Caso contrário, não informar



Máscara:


DD/MM/AAAA

datAltHes

Opcional

DateTime

Informar a data de alteração da escala


  • Obrigatório se:

  • Alterar a escala

  • A empresa utilizar escala de horários

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


  • Obrigatório se:

  • Na alteração, mudar o código da filial

Caso contrário, não informar



Máscara:


DD/MM/AAAA

datAltHlo

Opcional

DateTime

Informar data de alteração do local


  • Obrigatório se:

  • Alterar o local do colaborador

Caso contrário, não informar



Máscara


DD/MM/AAAA

datAltCcu

Opcional

String

Informar data de alteração do centro de custo


  • Obrigatório se:

  • Na alteração, mudar o 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


  • Opcional

  • Não informar se o módulo de integração for o PLR

codBan

Opcional

Integer

Informar o código do banco da conta bancária do colaborador.


  • Obrigatório se:

  • Informar modo de pagamento for R - Relação bancária”.


  • Não informar se:

  • Utilizar histórico de contas bancárias

  • O módulo de integração for diferente do AP, BS ou PLR

conRho

Opcional

Integer

Informar quais os colaboradores que serão contados na verificação do limite de colaboradores permitidos


  • Opcional

  • Somente informar se possuir o módulo Controle de Ponto e Refeitório


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.



  • Máscara: 9[8]

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.



  • Obrigatório

  • Chave


  • Se informar o valor 0, será gerado um novo cadastro para o colaborador. Somente disponível esta opção para o TipOpe=I.

apuPonApu

Opcional

Integer

Informar o tipo de apuração


  • Obrigatório se possuir o módulo CP e o módulo de integração for diferente do CS ou QL

  • Não informar na alteraçã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


  • Obrigatório

codTmaHes

Opcional

Integer

Informar o código da turma da escala


  • Obrigatório se:

  • Alterar a escala

  • A empresa utilizar escala de horários

ou integrar com os módulos CP, PLR ou BS


  • O tipo da escala for diferente de ‘D - Definida’

Não informar se o módulo de integração for o CS, QL ou JR

conTov

Opcional

String

Informar se irá deverá ser considerado o Turn-over



  • Opcional


Somente informar se:



  • No sistema estiver assinalado com ‘S’ para usar Turn-over em: Diversos > Assinalamentos

conTovHlo

Opcional

String

Informar turn-over de entrada


  • Obrigatório se:

  • Incluir um novo colaborador

ou Alterar o local do colaborador


  • Se assinalado para usar turn-over

Caso contrário, não informar



Valores:


S - Sim


N - Não

conFinCcu

Opcional

Integer

Informar a conta financeira


  • Obrigatório se:

  • Alterar ou incluir o centro custo

  • O módulo de integração for o Administração de Pessoal

  • A empresa usar contabilização por conta financeira

Caso contrário, não informar.

digCar

Opcional

String

Informar o dígito verificador da carteira de trabalho


  • Opcional

  • Não informar se o módulo de integração for o PLR

codAge

Opcional

Integer

Informar o código da agência da conta bancária do colaborador


  • Obrigatório se:

  • Informar modo de pagamento for R - Relação bancária”.


  • Não informar se:

  • Utilizar histórico de contas bancárias

  • O módulo de integração for diferente do AP, BS ou PLR

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.


  • Opcional

  • Somente informar se estiver integrando com o módulo Controle de Ponto.


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


  • Obrigatório

artCLT

Opcional

Integer

Informar o artigo 62 da CLT


  • Obrigatório se for informado os valores (2,3,5) para o campo Tipo de Apuração


Valores:


1 - Não se aplica


2 - Atividade Externa especificada no Inciso I


3 - Funções especificadas no Inciso II


4 - Teletrabalho, previsto noInciso III

funEsoHca

Opcional

String

Informar se o cargo deve considerado como Função eSocial.



Opções:


S - Sim


N - Não



Observação

: este campo deve ser informado quando o campo

Função eSocial

, da tela de Definições do eSocial (

FR030DES

), estiver definido como “2 - Histórico de Cargo” ou “4 - Histórico de Função ou Cargo”.

turInt

Opcional

Integer

Informar o código da turma do intervalo


  • Opcional

Informar somente se:


  • Integrar com o Controle de Ponto e Refeitório

conTosHlo

Opcional

String

Informar turn-over de saída


  • Obrigatório se:

  • Incluir um novo colaborador

ou Alterar o local do colaborador


  • Se assinalado para usar turn-over

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


  • Opcional

  • Não informar se o módulo de integração for o PLR


Máscara


DD/MM/AAAA

tpcPix

Opcional

String

Informar o tipo da chave PIX.



Máscara: 9[2]



Valores:


01 - Telefone


02 - E-mail


03 - CPF/CNPJ


04 - Chave Aleatória


05 - Conta Bancária

tpCtBa

Opcional

Integer

Informar o tipo de conta bancária


  • Opcional:

  • Não informar se:

  • Utilizar histórico de contas bancárias

  • Não for a versão Internacional do Administração de Pessoal


Valores:


1 - Conta Corrente


2 - Conta Poupança


3 - Conta Salário


9 - Outros

verInt

Opcional

String

Informar uma opção de controle de interjornada


  • Opcional

  • Somente informar se integrando com o Controle de Ponto e Refeitório


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


  • Opcional

codDSi

Opcional

Integer

Código da definição de situação

carVagHca

Opcional

String

Informar o código de cargo do novo cargo da vaga


  • Opcional

Somente informar se:


  • No sistema estiver assinalado com ‘S’ para permitir informar cargo diferenciado para a vaga

codEqp

Opcional

Integer

Informar o código da Equipe


  • Obrigatório se tipo de escala for G

locTraHlo

Opcional

String

Informar o local de trabalho na Rais


  • Opcional

  • Somente informar se:

  • Incluir um colaborador

ou Alterar o local de um colaborador


  • O módulo da integração for o Administração de Pessoal

estCtp

Opcional

String

Informar a unidade de federação da carteira de trabalho


  • Opcional

  • Não informar se o módulo de integração for o PLR


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

chvPix

Opcional

String

Informar a chave PIX conforme seu tipo.



Quando a chave for do tipo “5 - Conta Bancária” não será possível informar este campo. O sistema irá considerar os dados informados nos parâmetros do banco.



Quando o tipo de chave PIX for “3 - CPF/CNPJ”, se o parâmetro não for informado, o sistema irá automaticamente preencher com o CPF (numCpf).

conBan

Opcional

Double

Informar o número da conta bancária do colaborador


  • Opcional

  • Não informar se:

  • Utilizar histórico de contas bancárias

  • O módulo de integração for diferente do AP, BS ou PLR

assPpr

Opcional

Integer

Assinalamento para o PPR


  • Opcional

  • Somente informar se o módulo de integração for o PLR


Valores:


1 - Recebe e conta para o PPR


2 - Recebe mas não conta para o PPR


3 - Não recebe mas conta para o PPR


4 - Não recebe e não conta para o PPR



Valor Padrão:


0

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.

tipSex

Opcional

String

Informar o sexo do colaborador


  • Obrigatório


Valores:


M - Masculino


F - Feminino

codSinHsi

Opcional

Integer

Informar código de sindicato


  • Obrigatório quando o módulo de integração for CS, AP, CP

  • Não informar na alteração

codCat

Opcional

Integer

Informar o código da categoria


  • Obrigatório se tipo da escala for do tipo G

numCpf

Opcional

String

Informar o CPF do colaborador:


  • Opcional

  • Não informar se o módulo de integração for o PLR


Máscara


999.999.99-99



Observações:


  • Se informar deve ser um CPF válido

  • Informar inclusive o dígito verificador

digBan

Opcional

String

Informar o dígito da conta bancária informada.


  • Opcional:

  • Não informar se:

  • Utilizar histórico de contas bancárias

  • O módulo de integração for diferente do AP, BS ou PLR

codFor

Opcional

Integer

Indicar o código do fornecedor diferenciado por colaborador. Quando for gerada a integração financeira, se esse código não estiver indicado, será utilizado o código do fornecedor cadastrado no CIF


  • Opcional

  • Somente informar se integrar com o Administração de Pessoal com integração financeira com o ERP

estCiv

Opcional

Integer

Informar o estado civil do colaborador


  • Obrigatório

  • Não informar se o módulo de integração for o CP e não possuir TR integrado.


Valores:


1 - Solteiro


2 - Casado


3 - Divorciado


4 - Viúvo


5 - Concubinato


6 - Separado


9 - Outros

socSinHsi

Opcional

String

Informar se é sindicalizado


Obrigatório se:


  • Integrar com o módulo Administração de Pessoal

Caso contrário, não informar


  • Não informar na alteração


Valores:


S - Sim, o colaborador é sindicalizado


N - Não é sindicalizado

desSim

Opcional

String

Descrição detalhada da jornada para o eSocial.



Este campo será utilizado apenas quando o campo

Descrição de Jornada eSocial Simplificada

da tela de assinalamentos, acessada através do menu Diversos > Assinalamentos (

FR000ASS

), estiver definido com a opção “S- Sim”.

numPis

Opcional

Double

Informar o número do PIS do colaborador


  • Opcional

  • Não informar se o módulo de integração for o PLR


Máscara:


999.99999.99.9



Observações:


  • Se informar assegurar-se que o número está correto

  • Informar inclusive o dígito verificador

perPag

Opcional

String

Definir o período de pagamento.
O campo é Obrigatório.

Valores:
M - Mensal
S - Semanal
Q - Quinzenal

O campo é Opcional quando possui integração com o Ronda.

insCur

Opcional

Integer

Informar o código do tipo de instrutor do curso.


  • Opcional

  • Somente informar se integrar com o módulo TR


Valor Padrão:


0

graIns

Opcional

Integer

Indicar a escolaridade de acordo com a codificação utilizada pela Rais


  • Obrigatório

  • Não informar se o módulo de integração for o CP e não possuir TR integrado.


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.

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

.

horBas

Opcional

Integer

informar o código do horário base do colaborador


  • Obrigatório se:

  • A empresa não usar escala horária

  • O módulo de integração for diferente do CP, BS ou PLR

Caso contrário, não informar

dcdPis

Opcional

DateTime

Informar a data de cadastramento no Pis/Pasep.


  • Opcional

  • Não informar se o módulo de integração for o PLR


Máscara


DD/MM/AAAA

emiCar

Opcional

String

Informar se deve emitir etiqueta ou cartão ponto para este colaborador


  • Obrigatório se:

  • Integrar com o Administração de Pessoal ou Controle de Ponto e Refeitório

  • Na alteração é opcional

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

tipTer

Opcional

String

Informar uma opção de controle de interjornada


  • Opcional

  • Somente informar se integrando com o Controle de Ponto e Refeitório


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

datNas

Opcional

DateTime

Informar a data de nascimento do colaborador


  • Opcional


Máscara:


DD/MM/AAAA

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 horas

estiver definido como “S - Sim”.



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


  • Obrigatório se:

  • A empresa não usar escala horária

  • O módulo de integração for diferente do CP, BS ou PLR

  • Alterar o horário base

Caso contrário, não informar



Máscara:


DD/MM/AAAA

defFis

Opcional

String

Informa se o colaborador é

uma pessoa com deficiência


  • Somente informar se integrar com os módulos BS, QL, RS, AP, TR ou SM


Valores


S - Sim


N - Não

codNac

Opcional

Integer

Informar o código da nacionalidade, de acordo com a codificação utilizada para a Rais.


  • Obrigatório

  • Não informar se o módulo de integração for o CP ou PLR ou BS ou JR.

codBhrHsi

Opcional

Integer

Informar o código do banco de horas



Somente informado quando o campo

Utiliza banco

estiver definido como “2 - Pelo histórico do Sindicato”.



Disponível apenas se o cliente possuir o módulo CP na

Proprietária

.

horSabHor

Opcional

Integer

Informar a código do horário de sábado


  • Obrigatório se:

  • A empresa não usar escala horária

  • O módulo de integração for diferente do CP, BS ou PLR

  • Alterar o horário base ou incluir um colaborador

Nunca informar se:


  • A empresa usar escala horária

  • O módulo de integração for CP, BS ou PLR

codDef

Opcional

Integer

Informa o código da deficiência do colaborador


  • Opcional

  • Somente informar se

  • Integrar com os módulos BS, QL, RS, AP, TR ou SM

  • O colaborador possui deficiência física

catTer

Opcional

String

Informar a categoria do contribuinte de carnê do INSS



A - Autônomo


E - Empregador


D - Doméstica


F - Facultativo


B - Facultativo Baixa Renda


I - Contribuinte Individual, Lei 9.876


C - Contribuinte Facultativo, Lei 9.876


O - Outros

horSemHor

Opcional

Time

Informar as horas semanais


  • Obrigatório se:

  • A empresa não usar escala horária

  • O módulo de integração for diferente do CP, BS ou PLR

  • Na alteração, se o horário base estiver zerado

Caso contrário, não informar



Máscara:


HH:MM

benRea

Opcional

String

Informar se o colaborador encontra-se reabilitado ou não para o trabalho


  • Opcional

  • Somente informar se integrar com os módulos BS, QL, RS, AP, TR ou SM


Valores


S - Sim


N - Não

apoIda

Opcional

String

Este campo tem por objetivo possibilitar a emissão do carnê com os códigos GPS instituídos pelo Decreto 6042/2007 do INSS.

S - Sim
N - Não

Observação:
- Quando catTer for diferente de “D - Doméstica”, este parâmetro é obrigatório e deve ser preenchido com “S - Sim” ou “N - Não”.
- Quando catTer for igual a “D - Doméstica”, este parâmetro é desabilitado, oculto e preenchido automaticamente com “N - Não” pelo sistema.

horDsrHor

Opcional

Time

Informar as horas DSR


  • Obrigatório se:

  • A empresa não usar escala horária

  • O módulo de integração for diferente do CP, BS ou PLR

  • Na alteração, se o horário base estiver zerado

Caso contrário, não informar



Máscara:


HH:MM

racCor

Integer

Código da raça/etnia da tela de cadastro de raça/etnia.


  • Somente informar se integrar com o AP ou TR.

catSef

Opcional

Integer

Informar a categoria do colaborador no SEFIP


  • Obrigatório se:

  • Os tipos de contrato forem 1, 2, 4, 6, 7, 10 e 11 (Opcional para outros tipos)

  • Integrar com o módulo Administração de Pessoal

Caso contrário, não informar



Valores:


01 - Empregado;


02 - Trabalhador avulso;


03 - Trabalhador não vinculado ao RGPS, mas com direito ao FGTS;


04 - Empregado sob contrato de trabalho por prazo determinado (Lei n* 9.601/98);


05 - Contribuinte Individual - Diretor não empregado com FGTS (Lei nº 8.036/90, art. 16);


06 - Empregado Doméstico;


07 - Menor Aprendiz ( Lei 10.097/2000);


11 - Contribuinte Individual - Diretor não empregado e demais empresários sem FGTS;


12 - Demais Agentes Públicos;


13 - Contribuinte Individual - Trabalhador autônomo ou a este equiparado, inclusive o operador de máquina com contribuição sobre remuneração;


14 - Contribuinte Individual - Trabalhador autônomo ou a este equiparado, inclusive o operador de máquina com contribuição sobre salário-base;


15 - Contribuinte Individual - Transportador autônomo com contribuição sobre remuneração;


16 - Contribuinte Individual - Transportador autônomo com contribuição sobre salário-base;


17 - Contribuinte Individual - Cooperado que presta serviços a empresas contratantes de Cooperativa de Trabalho;


18 - Contribuinte Individual - Transportador Cooperado que presta serviços a empresas contratantes de Cooperativa de Trabalho;


19 - Agente Político;


20 - Servidor Público Ocupante, exclusivamente, de cargo em comissão; Servidor Público Ocupante de cargo temporário ;


21 - Servidor Público titular de cargo efetivo, magistrado, membro do Ministério Público e do Tribunal e Conselho de Contas.

faiIns

Opcional

Integer

Informar a faixa de contribuição do carnê do INSS na qual o contribuinte está efetuando os recolhimentos.



Esta faixa refere-se à mesma definida na tabela das alíquotas.

gpsTri

Opcional

String

Informar, se houver, a data início da GPS Trimestral.

emtCar

Opcional

String

Informar conforme abaixo:


“Sim: emitir o carnê do contribuinte


“Não: não emitir o carnê do contribuinte.

opcAtu

Opcional

String

Atualização Automática de Classe



S - Sim


N - Não

dctIns

Opcional

Integer

Informar onde deve ser calculado desconto de INSS



0 - Nenhum


1 - Normal


2 - 13º Salário


3 - Todos

dedIns

Opcional

Integer

Indicar o percentual devido (normalmente 11 ou 20%), para cálculo do desconto de INSS, aplicado o percentual informado diretamente sobre a base.

fatTpo

Opcional

Integer

Informar o índice de conversão, utilizado pela previdência para converter o tempo de aposentadoria especial para comum. Esta conversão foi válida até 12/98.

perIss

Opcional

Integer

Neste item deve ser informado o percentual que será abatido na base para fins de ISS, quando do pagamento ao terceiro.

codLim

Opcional

Integer

Este campo serve para informar um código de cadastro de Limite de Isenção ISS. Ao efetuar um pagamento para este terceiro, o código será alimentado automaticamente na tela de pagamento e irá deduzir da base de cálculo do ISS o limite de isenção cadastrado para este código em Tabelas > Gerais > Limite Isenção ISS.

perTra

Opcional

Integer

Indicar o percentual que deverá ser utilizado para o cálculo do campo Base Cálculo INSS, para Terceiros Transportistas (tipo de uso = 08), no cadastro do Pagamento de Pessoa Física.

retTrp

Opcional

String

Indicar quanto à retenção de Sest/Senat para o Terceiro Transportador.



S - Calcular e não dedus da base de IRRF


I - Calcula e dedus da base de IRRF


N - Não Calcula

perIrt

Opcional

Integer

Indicar o percentual que deverá ser utilizado para o cálculo do campo Base Cálculo IR, para Terceiros Transportistas (tipo de uso = 08), no cadastro do Pagamento de Pessoa Física.
Importante

No web service com.senior.g5.rh.hr.fichaBasicaTerceiros, utilizado por meio do Controle de Ponto, o envio de campos que não existem ou não são tratados por esse módulo resulta em erro no processamento da requisição.

No XML enviado, os seguintes campos podem conter informações, porém não existem nesse módulo e, por esse motivo, ocasionam erro:

Campos
  • ApoIda
  • CatSef
  • CateSo
  • DatAltHca
  • DatAltHes
  • EmtCar
  • EstCiv
  • ModPag
  • MotPos
  • OpcAtu
  • PerPag
  • PosTra
  • RacCor
  • TipTer
  • UsaBhrHsi

Resposta:

Nota

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:FichaBasicaTerceirosResponse>
<result>
<numEmp>Integer</numEmp>
<numCad>Integer</numCad>
<erroExecucao>String</erroExecucao>
</result>
</ser:FichaBasicaTerceirosResponse>
</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:


  • Vazio ou nulo, indicando que a execução foi feita com sucesso;

  • A mensagem do erro ocorrido no servidor.

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).