Ronda Senior - Manual do Usuário > Integrações com outros sistemas > Web services > Web services disponíveis > Com.senior.g5.sp.tab.col.terceiro.mantem

Web service com.senior.g5.sp.tab.col.terceiro.mantem

Este serviço permite a inclusão, alteração e exclusão do cadastro de um terceiro, preenchendo os dados pessoais, dados complementares e as definições individuais de acesso.

Da mesma forma como o cadastramento de um terceiro através da tela do sistema Ronda Senior, este web service apresentará todas as consistências de valores conforme as informações a seguir.

Tipo de execução

Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.

WSDL

Porta

Terceiro

Ronda Senior - Cadastro de Terceiros

Necessita autenticação: Sim.

Situação de versão: Atual.

Versão: 1.

Versão atual: 1.

Requisição:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Terceiro>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <tipOpe>String</tipOpe>
        <numEmp>Integer</numEmp>
        <tipCol>Integer</tipCol>
        <numCad>Integer</numCad>
        <nomFun>String</nomFun>
        <apeFun>String</apeFun>
        <datAdm>DateTime</datAdm>
        <sitAfa>Integer</sitAfa>
        <tipCon>Integer</tipCon>
        <tipSex>String</tipSex>
        <datNas>DateTime</datNas>
        <numCpf>Double</numCpf>
        <codNac>Integer</codNac>
        <numPis>Double</numPis>
        <dcdPis>DateTime</dcdPis>
        <tipTer>Integer</tipTer>
        <empRes>Integer</empRes>
        <tipRes>Integer</tipRes>
        <cadRes>Integer</cadRes>
        <codPai>Integer</codPai>
        <codEst>String</codEst>
        <codCid>Integer</codCid>
        <codBai>Integer</codBai>
        <endCep>Integer</endCep>
        <endRua>String</endRua>
        <endNum>String</endNum>
        <endCpl>String</endCpl>
        <dDITel>Integer</dDITel>
        <dDDTel>Integer</dDDTel>
        <numTel>String</numTel>
        <numRam>String</numRam>
        <emaPar>String</emaPar>
        <emaCom>String</emaCom>
        <preTrb>String</preTrb>
        <andTrb>String</andTrb>
        <paiNas>Integer</paiNas>
        <estNas>String</estNas>
        <cciNas>Integer</cciNas>
        <numCid>String</numCid>
        <emiCid>String</emiCid>
        <estCid>String</estCid>
        <dexCid>DateTime</dexCid>
        <numCnh>String</numCnh>
        <catCnh>String</catCnh>
        <datCnh>DateTime</datCnh>
        <venCnh>DateTime</venCnh>
        <verPrm>String</verPrm>
        <codPrm>Integer</codPrm>
        <prmFer>Integer</prmFer>
        <prmSab>Integer</prmSab>
        <prmDom>Integer</prmDom>
        <prmVis>Integer</prmVis>
        <conFai>Integer</conFai>
        <conAdp>String</conAdp>
        <conCre>Integer</conCre>
        <conIAl>String</conIAl>
        <temAlm>Integer</temAlm>
        <bloFal>String</bloFal>
        <recVis>String</recVis>
        <autAgv>String</autAgv>
        <autAsa>String</autAsa>
        <autExt>String</autExt>
        <usaFro>String</usaFro>
        <graCon>Integer</graCon>
        <conPac>String</conPac>
        <temPac>Integer</temPac>
        <tolAcp>Integer</tolAcp>
        <usaBio>Integer</usaBio>
        <datAso>DateTime</datAso>
        <datTse>DateTime</datTse>
        <autDbl>String</autDbl>
        <verAfa>String</verAfa>
        <conInt>String</conInt>
        <tolInt>Integer</tolInt>
        <conRea>String</conRea>
        <utiChv>String</utiChv>
        <repOnl>String</repOnl>
        <conRee>String</conRee>
        <plantas>
          <codPlt>String</codPlt>
          <datAso>String</datAso>
          <datTse>String</datTse>
        </plantas>
        <codFil>Integer</codFil>
        <numLoc>String</numLoc>
        <codCar>String</codCar>
        <codEsc>Integer</codEsc>
        <codTma>Integer</codTma>
        <viaCra>Integer</viaCra>
        <numCra>Double</numCra>
        <codCcu>String</codCcu>
        <codOem>Integer</codOem>
        <numCon>String</numCon>
        <datFim>DateTime</datFim>
        <datAfa>DateTime</datAfa>
        <horAfa>String</horAfa>
        <diaJus>Integer</diaJus>
        <datTer>DateTime</datTer>
        <horTer>String</horTer>
        <prvTer>DateTime</prvTer>
        <obsAfa>String</obsAfa>
        <datChe>DateTime</datChe>
        <visEst>Integer</visEst>
        <regEst>String</regEst>
        <dvlEst>DateTime</dvlEst>
        <dvlCtp>DateTime</dvlCtp>
        <perCpf>String</perCpf>
        <usaRfa>String</usaRfa>
        <numPspC>String</numPspC>
        <emiPsp>String</emiPsp>
        <demPsp>DateTime</demPsp>
        <dvaPsp>DateTime</dvaPsp>
        <nomSoc>String</nomSoc>
        <codPos>String</codPos>
        <casBra>String</casBra>
        <filCbr>String</filCbr>
        <datPor>DateTime</datPor>
        <numPor>String</numPor>
        <emiEst>String</emiEst>
        <datEst>DateTime</datEst>
        <numPsp>String</numPsp>
        <paiPsp>Integer</paiPsp>
        <estPsp>String</estPsp>
      </parameters>
    </ser:Terceiro>
  </soapenv:Body>
</soapenv:Envelope>

Parâmetros da requisição:

Nome Preenchimento Tipo Descrição
tipOpe Obrigatório String Tipo de operação a ser feito com o terceiro. Os valores aceitáveis para este campo são:
I - inclusão;
A - alteração;
E - exclusão.
numEmp Obrigatório Integer Código da Empresa. O valor deve estar previamente cadastrado na tabela R030EMP.
tipCol Obrigatório Integer Tipo Colaborador. O valor desse campo deve ser 2 equivalente a Terceiro.
numCad Obrigatório Integer Cadastro do Terceiro.
nomFun Obrigatório String Nome do Terceiro.
apeFun Opcional String Apelido do Terceiro.
datAdm Obrigatório DateTime Data de Admissão. O valor de entrada deve respeitar o formato DD/MM/YYYY.
sitAfa Obrigatório Integer Situação de Afastamento. O valor deve estar previamente cadastrado na tabela R010SIT.
Obs.: Os campos DatAfa e HorAfa não precisão ser alimentados pelo serviço. Se for necessário, a própria tela de cadastramento alimenta estes campos quando ela for executada pelo serviço.
tipCon Obrigatório Integer Tipo de Contrato. Os valores aceitáveis deste campo são os constantes da lista enumerada LTipCon do CBDS da Senior.
tipSex Obrigatório String Sexo do Colaborador. Os valores aceitáveis deste campo são os constantes da lista enumerada LTipSex do CBDS da Senior.
datNas Opcional DateTime Data de Nascimento. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000
numCpf Opcional Double Número do CPF. O valor de entrada deve respeitar a máscara 999.999.999-99.
codNac Obrigatório Integer Código da Nacionalidade. O valor deve estar previamente cadastrado na tabela R023NAC.
numPis Opcional Double Número do PIS/PASEP. O valor de entrada deve respeitar a máscara 999.99999.99.9.
dcdPis Opcional DateTime Data de Cadastramento no PIS/PASEP. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
tipTer Opcional Integer Tipo de Terceiro. O valor deve estar previamente cadastrado na tabela R032TTE.
empRes Obrigatório Integer Código da Empresa do Responsável. O valor deve estar previamente cadastrado na tabela R030EMP.
tipRes Obrigatório Integer Tipo de Colaborador Responsável. Os valores aceitáveis deste campo são os constantes da lista enumerada LTipCol do CBDS da Senior.
cadRes Obrigatório Integer Cadastro do Responsável. O valor da chave [EmpRes, TipRes, CadRes] deve estar previamente cadastrado na tabela R034FUN.
endRua Opcional String Endereço Residencial
endNum Opcional String Número
endCpl Opcional String Complemento Endereço
numTel Opcional String Número do Telefone
numRam Opcional String Número do Ramal
emaPar Opcional String Endereço do Correio Eletrônico (E-mail) Particular
emaCom Opcional String Endereço do Correio Eletrônico (E-mail) Comercial
preTrb Opcional String Nome do Prédio Onde o Terceiro Trabalha
andTrb Opcional String Andar do Prédio Onde o TerceiroTrabalha
cciNas Opcional Integer Cidade de Nascimento. O valor deve estar previamente cadastrado na tabela R074CID. O valor de entrada deve respeitar a máscara 99.99999.
numCid Opcional String Número da Carteira de Identidade
emiCid Opcional String Orgão Emissor da Carteira de Identidade
estCid Opcional String Estado do Orgão Emissor da Carteira de Identidade. Os valores aceitáveis deste campo são os constantes da lista enumerada LEstFed do CBDS da Senior.
dexCid Opcional DateTime Data de Expedição da Carteira de Identidade. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
numCnh Opcional String Número da Carteira de Habilitação
catCnh Opcional String Categoria da Carteira de Habilitação
datCnh Opcional DateTime Data da Primeira Habilitação. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
venCnh Opcional DateTime Data de Vencimento da Carteira de Habilitação. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
codFil Obrigatório Integer Código da Filial. Usado apenas na inserção de novo empregado. Quando informado, o valor da chave [NumEmp, CodFil] deve estar previamente cadastrado na tabela R030FIL.
numLoc Obrigatório Integer Local do Organograma. Usado apenas na inserção de novo empregado. Quando for informado valor para este parâmetro, o valor do campo TabOrg é buscado automaticamente pelo sistema conforme o número da empresa e a data atual, e então o valor da chave [TabOrg, NumLoc] deve estar previamente cadastrado na tabela R016ORN
codCar Opcional String Código do Cargo. Usado apenas na inserção de novo empregado. Quando for informado valor para este parâmetro, o valor do campo EstCar é buscado automaticamente pelo sistema conforme o número da empresa e a data atual, e então o valor da chave [EstCar, CodCar] deve estar previamente cadastrado na tabela R024CAR.
codEsc Obrigatório Integer Código da Escala. Usado apenas na inserção de novo empregado. Quando informado, o valor deve estar previamente cadastrado na tabela R006ESC.
codTma Opcional Integer Código da Turma. Usado apenas na inserção de novo empregado. Quando informado, o valor da chave [CodEsc, CodTma] deve estar previamente cadastrado na tabela R006TMA.
viaCra Opcional Integer Via do Crachá. Usado apenas na inserção de novo empregado. Somente alimentará o campo ViaCra se não estiver utilizando pré-cadastro de crachá. Pois, quando utiliza pré-cadastro crachá, o campo ViaCra não é exibido.
numCra Opcional Double Número do Crachá. Usado apenas na inserção de novo empregado.
codCcu Opcional String Código do Centro de Custo Contábil. Usado apenas na inserção de novo empregado. Quando informado, o valor da chave [NumEmp, CodCcu] deve estar previamente cadastrado na tabela R018CCU. Máscara: U[18].
datAfa Opcional DateTime Data do Afastamento. Usado apenas na mudança da Situação do terceiro. Se valor enviado for nulo deve-se enviar 00/00/0000.
horAfa Opcional String Hora do Afastamento. Usado apenas na mudança da Situação do terceiro.
diaJus Opcional Integer Dias Justificados. Usado apenas na mudança da Situação do terceiro nos casos de Auxílio Doença e Acidente de Trabalho.
datTer Opcional DateTime Data Término do Afastamento. Usado apenas na mudança da Situação do terceiro, menos no caso de Demitido. Se valor enviado for nulo deve-se enviar 00/00/0000.
horTer Opcional String Hora Término do Afastamento. Usado apenas na mudança da Situação do terceiro, menos no caso de Demitido.
prvTer Opcional DateTime Data Prevista para Término do Afastamento. Usado apenas na mudança da Situação do terceiro, menos no caso de Demitido. Se valor enviado for nulo, deve-se enviar 00/00/0000.
obsAfa Opcional String Observação do Afastamento. Usado apenas na mudança da Situação do terceiro.
datChe Opcional DateTime Data de Chegada
visEst Opcional Integer Tipo de Visto da Carteira de Estrangeiro. Os valores aceitáveis deste campo são os constantes da lista enumerada LVisEst do CBDS da Senior.
regEst Opcional String Carteira de Estrangeiro.
dvlEst Opcional DateTime Data de Validade da Carteira de Estrangeiro. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
dvlCtp Opcional DateTime Data de Validade da Carteira de Trabalho (Estrangeiro). O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
verPrm Obrigatório String Verifica se Tem Permissão de Acesso. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
codPrm Opcional Integer Permissão de Acesso para os Dias Normais. O valor deve estar previamente cadastrado na tabela R058PRM.
prmFer Opcional Integer Permissão de Acesso para os Feriados. O valor deve estar previamente cadastrado na tabela R058PRM. Se o cliente for Colégio Menino Jesus (código 6812) este campo não é exibido na tela, consequentemente este parâmetro deverá ser ignorado. Se o tipo do TBS for 05, este campo não é exibido na tela. Consequentemente este parâmetro deverá ser ignorado.
prmSab Opcional Integer Permissão de Acesso para os Sábados. O valor deve estar previamente cadastrado na tabela R058PRM. Se o tipo do TBS for 05, este campo não é exibido na tela. Consequentemente este parâmetro deverá ser ignorado.
prmDom Opcional Integer Permissão de Acesso para os Domingos. O valor deve estar previamente cadastrado na tabela R058PRM. Se o cliente for Colégio Menino Jesus (código 6812) este campo não é exibido na tela, consequentemente este parâmetro deverá ser ignorado. Se o tipo do TBS for 05, este campo não é exibido na tela. Consequentemente este parâmetro deverá ser ignorado.
prmVis Opcional Integer Permissão de Acesso do Visitante Quando for Visitá-lo. O valor deve estar previamente cadastrado na tabela R058PRM.
conFai Obrigatório Integer Controla Faixa Horária de Acesso. Os valores aceitáveis deste campo são os constantes da lista enumerada LConFai do CBDS da Senior.
conAdp Obrigatório String Controla Anti-Dupla. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
conCre Obrigatório Integer Controla Créditos de Acesso para Refeitório. Os valores aceitáveis deste campo são os constantes da lista enumerada LConCre do CBDS da Senior.
conIAl Obrigatório String Controla Intervalo de Almoço. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
temAlm Obrigatório Integer Tempo Mínimo de Almoço (Minutos).
bloFal Obrigatório String Bloqueia Colaborador por Falta. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
recVis Obrigatório String Pode Receber Visita. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
autAgv Obrigatório String Pode Autorizar Agendamento de Visita. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
autAsa Obrigatório String Pode Autorizar Saída de Colaboradores. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
autExt Obrigatório String Pode Autorizar Hora Extra. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
usaFro Obrigatório String Pode Utilizar Veículo da Frota. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
graCon Obrigatório Integer Grau de Conferência na Biometria (1-5).
conPac Obrigatório String Controla Tempo de Permanência no Acesso. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior. Se o TBS for diferente de 14, 17 e 18 este campo não é exibido na tela (os campos para controle de permanência de acesso só são utilizados em MS-SQL). Desta forma, este parâmetro deve ser ignorado.
temPac Obrigatório Integer Tempo Mínimo de Permanência no Acesso. Se o TBS for diferente de 14, 17 e 18 este campo não é exibido na tela (os campos para controle de permanência de acesso só são utilizados em MS-SQL). Desta forma, este parâmetro deve ser ignorado.
tolAcp Obrigatóriol Integer Tolerância Acesso Entr./Saída para Controle de Permanência. O valor de entrada deve respeitar o formato HH:MM. Se o TBS for diferente de 14, 17 e 18 este campo não é exibido na tela (os campos para controle de permanência de acesso só são utilizados em MS-SQL). Desta forma, este parâmetro deve ser ignorado.
usaBio Obrigatório Integer Utiliza Controle Biométrico. Os valores aceitáveis deste campo são os constantes da lista enumerada LUsaBio do CBDS da Senior.
datAso Opcional DateTime Data Validade do ASO. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000
datTse Opcional DateTime Data Validade Treinamento Segurança. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo deve-se enviar 00/00/0000.
autDbl Obrigatório String Autorizador de Desbloqueio de Crachás e Colaboradores. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
verAfa Obrigatório String Verifica Afastamento. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
conInt Obrigatório String Controla Interjornada. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
tolInt Obrigatório Integer Tolerância para Controle de Interjornada (Minutos).
plantas Opcional Set Lista de valores (1 para N). Somente é exibido o cadastramento de definições de acesso por planta quando o TBS for 19.
plantas.codPlt Opcional String Código da planta. Quando for informado, o valor deve estar previamente cadastrado na tabela R058PLT. Quando utilizar definições de acesso por planta, este campo é obrigatório.
plantas.datAso Opcional String Data validade ASO. O valor de entrada deve respeitar o formato DD/MM/YYYY.
plantas.datTse Opcional String Data validade Treinamento Segurança. O valor de entrada deve respeitar o formato DD/MM/YYYY.
codOem Opcional Integer Código Outra Empresa. O valor deve estar previamente cadastrado na tabela R032OEM.
datFim Opcional DateTime Data final do contrato. O valor de entrada deve respeitar o formato DD/MM/YYYY.
numCon Opcional String Número do Contrato de Serviço. O valor da chave [CodOem, NumCon] deve estar previamente cadastrado na tabela R032EMC.
codPai Opcional Integer Código do País . O valor deve estar previamente cadastrado na tabela R074PAI. O valor de entrada deve respeitar a máscara "9999".
codEst Opcional String Estado. O valor deve estar previamente cadastrado na tabela R074EST.
codCid Opcional Integer Cidade. O valor deve estar previamente cadastrado na tabela R074CID. O valor de entrada deve respeitar a máscara 99.99999.
codBai Opcional Integer Bairro. O valor deve estar previamente cadastrado na tabela R074BAI.
endCep Opcional Integer CEP. O valor de entrada deve respeitar a máscara 99.999-999.
dDITel Opcional Integer Número do Telefone.
dDDTel Opcional Integer Número do Ramal.
conRea Obrigatório String Participa Revista Aleatória. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
utiChv Obrigatório String Utiliza controle de chaves. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
repOnl Obrigatório String Utiliza controle on-line de ponto eletrônico. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
conRee Obrigatório String Controla tempo mínimo de reentrada
paiNas Opcional Integer Código do País de Nascimento. O valor deve estar previamente cadastrado na tabela R074PAI. O valor de entrada deve respeitar a máscara "9999".
estNas Opcional String Estado de Nascimento. O valor deve estar previamente cadastrado na tabela R074EST.
perCpf Opcional String Permite CPF repetido.
casBra Opcional String Casado com Brasileiro(a).
filCbr Opcional String Filhos Brasileiros.
numPor Opcional String Número da portaria.
datPor Opcional DateTime Data da portaria.
emiEst Opcional String Data de validade da RNE.
datEst Opcional DateTime Data de validade da RNE.
codPos Opcional String Código do posto de trabalho.
numPsp Opcional String Número do Passaporte.
numPspC Opcional String Numero passaporte (guia complementar).
emiPsp Opcional String Emissor passaporte.
demPsp Opcional DateTime Data emissão do passaporte.
dvaPsp Opcional DateTime Data validade do passaporte.
paiPsp Opcional Integer País emissor do passaporte.
estPsp Opcional String Estado emissor do passaporte.
nomSoc Opcional String Nome social.

Resposta:

Observação

Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, 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:TerceiroResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:TerceiroResponse>
  </soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

Nome Preenchimento Tipo Descrição
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ê?