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

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

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

Da mesma forma como o cadastramento de um parceiro através da tela do sistema Ronda Senior, este serviço 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

Parceiro

Ronda Senior - Cadastro de Parceiros

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:Parceiro>
      <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>
        <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>
        <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>
        <numPsp>String</numPsp>
        <filCbr>String</filCbr>
        <casBra>String</casBra>
        <numPspC>String</numPspC>
        <emiPsp>String</emiPsp>
        <demPsp>DateTime</demPsp>
        <dvaPsp>DateTime</dvaPsp>
        <nomSoc>String</nomSoc>
        <datEst>DateTime</datEst>
        <perCpf>String</perCpf>
        <numPor>String</numPor>
        <codPos>String</codPos>
        <usaRfa>String</usaRfa>
        <datPor>DateTime</datPor>
        <emiEst>String</emiEst>
        <paiPsp>Integer</paiPsp>
        <estPsp>String</estPsp>
      </parameters>
    </ser:Parceiro>
  </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 parceiro. 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 do Colaborador. O valor desse campo deve ser 3, equivalente a Parceiro.
numCad Obrigatório Integer Cadastro do Colaborador.
nomFun Obrigatório String Nome do Colaborador.
apeFun Opcional String Apelido do Colaborador.
datAdm Obrigatório DateTime Data de Admissão. O valor de entrada deve respeitar o formato DD/MM/YYYY. Se valor enviado for nulo, deve-se enviar 00/00/0000
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 precisam 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óriol String Sexo do Colaborador. Os valores aceitáveis deste campo são os constantes da lista enumerada LTipSex do CBDS da Senior.
datNas Obrigatório 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 99999999999.
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 Obrigatório 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
empRes Obrigatório Integer Empresa do Responsável.
tipRes Obrigatório Integer Tipo do Responsável.
cadRes Obrigatório Integer Número do Responsável.
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.
endRua Opcional String Endereço Residencial
endNum Opcional String Número
endCpl Opcional String Complemento Endereço
dDITel Opcional Integer Número do Telefone
dDDTel Opcional Integer Número do Ramal
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 Colaborador Trabalha
andTrb Opcional String Andar do Prédio Onde o Colaborador Trabalha
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.
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 Obrigatório 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 Obrigatório 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 Obrigatório 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
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 por Falta. Os valores aceitáveis deste campo são os constantes da lista enumerada LSimNao do CBDS da Senior.
recVis Obrigatório String Colaborador 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 Colaborador 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 Colaborador 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 Colaborador 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 Colaborador 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ório 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 Obrigatório 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 Obrigatório 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)
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.
codPos Opcional String Código do posto de trabalho.
conRee Obrigatório String Controla tempo mínimo de reentrada
plantas Opcional Set Lista de valores (1 para N). Definições de acesso por planta.
plantas.codPlt Opcional String Código do Site. 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. Se valor enviado for nulo, deve-se enviar 00/00/0000
plantas.datTse Opcional String 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.
codFil Obrigatório Integer Código da Filial. Usado apenas na inserção de novo parceiro. 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 parceiro. 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 parceiro. 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 parceiro. 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 parceiro. 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 parceiro. 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 parceiro.
codCcu Opcional String Código do Centro de Custo Contábil. Usado apenas na inserção de novo parceiro. Quando informado, o valor da chave [NumEmp, CodCcu] deve estar previamente cadastrado na tabela R018CCU. Máscara: U[18]
codOem Opcional Integer Código da outra empresa.
numCon Opcional String Número do contrato.
datFim Opcional DateTime Data final do contrato
datAfa Opcional DateTime Data do Afastamento. Usado apenas na mudança da Situação do parceiro. 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 parceiro.
diaJus Opcional Integer Dias Justificados. Usado apenas na mudança da Situação do parceiro 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 parceiro, 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 parceiro, menos no caso de Demitido.
prvTer Opcional DateTime Data Prevista para Término do Afastamento
obsAfa Opcional String Observação do Afastamento. Usado apenas na mudança da Situação do parceiro.
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.
dvlCtp Opcional DateTime Data de Validade da Carteira de Trabalho (Estrangeiro). O valor de entrada deve respeitar o formato DD/MM/YYYY.
numPsp Opcional String Número do Passaporte.
casBra Opcional String Casado com Brasileiro(a).
filCbr Opcional String Filhos Brasileiros.
numPor Opcional String Número portaria naturalização estrangeiro.
datEst Opcional DateTime Data de expedição do registro de estrangeiro.
datPor Opcional DateTime Data portaria naturalização estrangeiro.
perCpf Opcional String Permite CPF repetido.
emiEst Opcional String Órgão de emissão do registro de estrangeiro.
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:ParceiroResponse>
      <result>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ParceiroResponse>
  </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ê?