Web service com.senior.g5.rh.fp.historicos
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificado o tipo no parâmetro <encryption>, conforme seus valores possíveis.
WSDL
- Síncrono: http://example.com/g5-senior-services/rubi_Synccom_senior_g5_rh_fp_historicos?wsdl
- Assíncrono: http://example.com/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_historicos?wsdl
- Agendado: http://example.com/g5-senior-services/rubi_Scheduledcom_senior_g5_rh_fp_historicos?wsdl
Portas
- Afastamento_4
- Cargo_2
- Local
- Escala
- Filial_4
- Posto_4
- PostoAdicional_2
- DocumentosAfastamento
- CentroCusto
- Contrato
- Sindicato
- Vinculo
- Anotacao
- Adicional_2
- AdicionalLocalCargo_2
- AdicionalLocal_2
- AdicionalCargo
- ValeTransporte_2
- Estabilidade_2
- Funcao_2
- NaturezaDespesa
- Horario
- Salario_2
- Receita
Afastamento_4
Por meio deste web service, é permitido informar os afastamentos dos colaboradores.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 4
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Afastamento> <user><span class="bordo">String</span></user> <password><span class="bordo">String</span></password> <encryption><span class="bordo">Integer</span></encryption> <parameters> <numEmp><span class="bordo">Integer</span></numEmp> <tipCol><span class="bordo">Integer</span></tipCol> <numCad><span class="bordo">Integer</span></numCad> <datAfa><span class="bordo">DateTime</span></datAfa> <horAfa><span class="bordo">Time</span></horAfa> <sitAfa><span class="bordo">Integer</span></sitAfa> <datPar><span class="bordo">DateTime</span></datPar> <datAlt><span class="bordo">DateTime</span></datAlt> <cauDem><span class="bordo">Integer</span></cauDem> <codSub><span class="bordo">String</span></codSub> <risNex><span class="bordo">String</span></risNex> <datPer><span class="bordo">DateTime</span></datPer> <datNex><span class="bordo">Time</span></datNex> <sitIni><span class="bordo">Integer</span></sitIni> <codAte><span class="bordo">Integer</span></codAte> <nomAte><span class="bordo">String</span></nomAte> <orgCla><span class="bordo">Integer</span></orgCla> <regCon><span class="bordo">String</span></regCon> <estCon><span class="bordo">String</span></estCon> <codDoe><span class="bordo">String</span></codDoe> <conTov><span class="bordo">String</span></conTov> <diaJus><span class="bordo">Integer</span></diaJus> <diaPrv><span class="bordo">Integer</span></diaPrv> <qhrAfa><span class="bordo">Time</span></qhrAfa> <cgcSuc><span class="bordo">String</span></cgcSuc> <datTer><span class="bordo">DateTime</span></datTer> <horTer><span class="bordo">Time</span></horTer> <prvTer><span class="bordo">DateTime</span></prvTer> <exmRet><span class="bordo">String</span></exmRet> <motRai><span class="bordo">Integer</span></motRai> <obsAfa><span class="bordo">String</span></obsAfa> <codOem><span class="bordo">Integer</span></codOem> <nroAut><span class="bordo">String</span></nroAut> <aciTra><span class="bordo">Integer</span></aciTra> <tipOpe><span class="bordo">String</span></tipOpe> <oriMot><span class="bordo">String</span></oriMot> <numPro><span class="bordo">String</span></numPro> <msmMot><span class="bordo">String</span></msmMot> <manCgc><span class="bordo">String</span></manCgc> <manRem><span class="bordo">String</span></manRem> </parameters> </ser:Afastamento> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Opcional | Integer | Código da empresa que será utilizado na integração
|
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser: - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Chave |
datAfa | Obrigatório | DateTime | Data inicial do afastamento do colaborador
- Chave - Máscara: DD/MM/YYYY |
horAfa | Opcional | Time | Hora inicial do afastamento
- Máscara: HH:MM |
sitAfa | Obrigatório | Integer | Informe a situação de afastamento, férias ou demissão.
Caso a situação seja do tipo - 03 (Auxílio-doença) ou - 04 (Acidente de Trabalho) e for informada uma quantidade de dias no campo Dias Licença Médica, estes serão calculados na situação com tipo 14 (Licença Médica) de menor código na tabela de situações. |
datPar | Opcional | DateTime | Data de término do afastamento
- Máscara: DD/MM/YYYY Quando o tipo da situação for "7 - Demitido" este parâmetro não poderá ser informado. |
datAlt | Opcional | DateTime | Data de alteração da situação do afastamento - Máscara: DD/MM/YYYY' Esse campo somente pode ser informado quando for alterado a situação de acordo com os seguintes cenários: - De 04 (Acidente Trabalho) para 03 (Auxílio-doença); - De 04 (Acidente Trabalho) para 22 (Aposentadoria); - De 03 (Auxílio-doença) para 04 (Acidente de Trabalho); - De 03 (Auxílio-doença) para 22 (Aposentadoria). |
cauDem | Opcional | Integer | Código da causa da demissão
Este parâmetro somente poderá ser informado quando o tipo da situação for: "7 - Demitido". |
codSub | Opcional | String | Informar o código do subgrupo de doenças que resultou no afastamento do colaborador.
Se este código estiver relacionado ao CNAE da filial do colaborador conforme consta na tabela de CIDs por CNAE em Tabelas/Gerais, será emitido uma mensagem de alerta, sugerindo para o próximo campo 'Risco Anexo' = Sim. Exemplo: A filial do colaborador possui o CNAE fiscal 1749 = Fabricação de outros artefatos têxteis, incluindo tecelagem. O afastamento ocorreu em decorrência do subgrupo da CID M75 = Lesões do ombro. Este campo ficará disponível se na tela de assinalamentos diversos o campo 'Controla Nexo Epidemiológico' estiver com Sim. Utilizado nos módulos: AP e SM |
risNex | Opcional | String | Informe o Risco Nexo:
Valores: S - Informar Sim quando este afastamento corre o risco de ser considerado no Nexo Técnico Epidemiológico (NTEP). Se o código do subgrupo da doença(CID) estiver relacionado com o CNAE da filial do colaborador, o sistema irá sugerir 'S'; N - Informar Não quando não existe a possibilidade da doença vir a ser considerada no nexo epidemiológico. Este campo ficará disponível se na tela de assinalamentos diversos o campo 'Controla Nexo Epidemiológico' estiver com Sim. Utilizado nos módulos: AP e SM |
datPer | Opcional | DateTime | Informar em que data ocorreu a decisão da perícia que avalia se o afastamento será ou não considerado no Nexo Epidemiológico.
Este campo ficará disponível se na tela de assinalamentos diversos o campo 'Controla Nexo Epidemiológico' estiver com Sim. Utilizado nos módulos: AP e SM |
datNex | Opcional | Time | Informar a data em que o afastamento por auxílio-doença foi alterado para Acidente de Trabalho. Este campo será preenchido automaticamente quando ocorrer o registro da CAT no sistema.
Exemplo: O colaborador foi afastado em 01/02/2008 pela situação 3-Auxílio-doença, pelo subgrupo da doença M75 que possui relação com o CNAE da filial do colaborador. Em 11/02/2008 foi registrada a CAT com afastamento para este colaborador. A data de início do nexo será 11/02/2008. Utilizado nos módulos: AP e SM |
sitIni | Opcional | Integer | Apresenta a situação inicial de afastamento que originou o Nexo Epidemiológico. Este campo só será habilitado se a data de início do nexo for preenchida.
Utilizado nos módulos: AP e SM |
codAte | Opcional | Integer | Código do Atendente
- Obrigatório, quando a empresa estiver utilizando o e-Social Este parâmetro somente poderá ser informado para situações com tipos iguais a: 3 - Auxílio-doença, 6 - Licença Maternidade, 14 - Auxílio-doença 15 dias, 19 - Auxílio Maternidade. Somente poderá ser informado um atendente que possua as informações do Conselho Profissional e Registro no Conselho já cadastradas. Disponível em todos os módulos |
nomAte | Opcional | String | Nome médico/dentista que emitiu o atestado |
orgCla | Opcional | Integer | Número de inscrição do órgão de classe |
regCon | Opcional | String | Registro no conselho profissional |
estCon | Opcional | String | UF da expedição do órgão de classe |
codDoe | Opcional | String | CID (Classificação Internacional de Doença)
23 - Acidente Trabalho 15 dias Este parâmetro somente poderá ser informado para situações com tipos iguais a: 3 - Auxílio-doença, 6 - Licença Maternidade, 14 - Auxílio-doença 15 dias, 19 - Auxílio Maternidade. Disponível em todos os módulos |
conTov | Opcional | String | Indicar se o afastamento deve ou não ser considerado no Turn-Over.
Valores: S - Sim N - Não Somente deve ser informado quando o tipo da situação for 7 - Demissão. Além disso, deve ser informado somente se o sistema estiver configurado para utilizar Turn-Over. Não deve ser informado no CP quando estiver não estiver integrado com outros módulos do Vetorh. |
diaJus | Opcional | Integer | Quantidade de dias justificados
Pode ser informados para situações do tipo: - 3 (auxílio-doença) - 4 (acidente de trabalho) |
diaPrv | Opcional | Integer | Dias Previsto para o término do afastamento.
- Máscara: 9999 Este parâmetro somente poderá ser informado para situações com tipos diferentes de: 7 - Demitido 15 - Faltas |
qhrAfa | Opcional | Time | Solicitada apenas para programações de faltas.
- Máscara: HHH:MM Somente deve ser informado quando o tipo da situação for 15 - Faltas. Não deve ser informado no CP quando estiver não estiver integrado com outros módulos do Vetorh. |
cgcSuc | Opcional | String | Informar o CNPJ da empresa Sucessora
- Se preenchido, deverá ser um CNPJ válido O campo só estará disponível quando o tipo da situação preenchida for igual a "Demitido" e quando o último histórico eSocial anterior à data de afastamento da causa de demissão for do tipo 11 ou 12 Disponível somente se o módulo estiver integrado com o Administração de Pessoal |
datTer | Opcional | DateTime | Data de término do afastamento
- Máscara: DD/MM/YYYY Quando o tipo da situação for "7 - Demitido" este parâmetro não poderá ser informado. |
horTer | Opcional | Time | Hora de término do afastamento
- Máscara: HH:MM Quando o tipo da situação for "7 - Demitido" este parâmetro não poderá ser informado. |
prvTer | Opcional | DateTime | Data final prevista para o término do afastamento.
- Máscara: DD/MM/YYYY Este parâmetro somente poderá ser informado para situações com tipos diferentes de: 7 - Demitido 15 - Faltas |
exmRet | Opcional | String | Exame de Retorno |
motRai | Opcional | Integer | Código do motivo para Rais
Valores: 10 - Acidente do trabalho típico 20 - Acidente do trabalho de trajeto 30 - Doença relacionada ao trabalho 40 - Doença não relacionada ao trabalho 50 - Licença Maternidade(e Paternidade até 2005) 60 - Serviço militar obrigatório 70 - Licença sem Remuneração/Vencimentos Disponível em todos os módulos, exceto no SM. Disponível quando a situação passada como parâmetro possuir o campo "DesRai" com o valor "S". Não deve ser informado no CP quando estiver não estiver integrado com os módulos SM e FP. Não deverá ser informado quando o tipo da situação for 11 (Licença Paternidade) e a "DataAfa" for maior que 31/12/2005. |
obsAfa | Opcional | String | Espaço para digitar qualquer mensagem relativa ao afastamento.
Disponível em todos os módulos, exceto no QL. |
codOem | Opcional | Integer | Indica o código da previdência (Internacional)
Somente utilizado no módulo FP, versão Internacional, para a Colômbia |
nroAut | Opcional | String | Número da autorização.
Somente utilizado no módulo FP, versão Internacional, para a Colômbia |
aciTra | Opcional | Integer | Tipo Acidente Trânsito
Este parâmetro somente poderá ser informado para situações com tipos iguais a: 3 - Auxílio-doença, 4 - Acidente Trabalho, 14 - Auxílio-doença 15 dias, 23 - Acidente Trabalho 15 dias Disponível em todos os módulos |
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
"I" - Inclusão "A" - Alteração "E" - Exclusão |
oriMot | Opcional | String | Origem do motivo de alteração |
numPro | Opcional | String | Número do processo, em caso de reintegração por determinação judicial |
msmMot | Opcional | String | Indica se o afastamento decorre de mesmo motivo de afastamento anterior |
atePat | Opcional | String |
Atestado Sem Incidência INSS
Valores:
|
manCgc | Opcional | String |
CNPJ de Mandato Eletivo. Informe o CNPJ do órgão no qual o trabalhador exercerá o mandato eletivo. Se preenchido, deverá ser um CNPJ válido. Fica disponível :
|
manRem | Opcional | String |
Indica se o servidor optou pela remuneração do cargo efetivo. Valores: S - Sim / N - Não Fica disponível :
|
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:Afastamento_3Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Afastamento_3Response>
</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. |
Cargo_2
Web service usado para efetuar as alterações ou promoções de cargos.
Quando há integração com os módulos de Quadro de Vagas e Orçamento, o sistema verificará (ou não) a existência de vagas para determinado histórico, dependendo dos seguintes assinalamentos no cadastro da empresa (FR030EMP):
- Ver Quadro Admissão
- Ver Quadro Transferências
- Ver Quadro Função
Se estes campos estiverem configurados como "1 - Verifica e permite incluir" ou "2 - Verifica e não permite incluir", ao executar o web service, será verificado se existe vaga para determinado histórico. Caso não exista, será emitida uma mensagem alertando que não existe vaga e o processo será cancelado.
Para incluir históricos via web service e ignorar esta verificação, recomendamos desabilitar estes campos no cadastro da empresa, configurando-os com a opção "3 - Não verifica".
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Cargo_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codCar>String</codCar> <carVag>String</carVag> <codCrr>Integer</codCrr> <codMot>Integer</codMot> <qtdConf>Integer</qtdConf> <funEso>String</funEso> <tipOpe>String</tipOpe> </parameters> </ser:Cargo_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data de alteração do cargo.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codCar | Opcional | String | Código do novo cargo do colaborador, terceiro ou parceiro.
-Obrigatório na inclusão |
carVag | Opcional | String | Código do cargo da vaga do colaborador, terceiro ou parceiro.
Neste campo deve ser informado o cargo que realmente o colaborador irá exercer, ou seja, o cargo para o qual será considerada a vaga. Este parâmetro somente deve ser informado quando a empresa utiliza Cargo da Vaga. No QL, em: Diversos\Assinalamentos, campo Cargo Vaga = 'S'. |
codCrr | Opcional | Integer | Código do carreira
- Opcinal Este campo somente é informado quando o assinalamento "Cargos Diversas Carreiras" for igual a "S". |
codMot | Opcional | Integer | Código do motivo da alteração do cargo.
-Obrigatório na inclusão |
qtdConf | Opcional | Integer | Quantidade de confirmações sobre questionamentos da rotina que devem ser respondidas.
- Opcional Este número irá variar de acordo com os parâmetros passados para a rotina. Para cada nova solicitação será feito um questionamento e, nestes casos, deve-se adicionas uma confirmação para que a rotina consiga prosseguir normalmente. |
funEso | Opcional | String | Este campo indica se o histórico de cargo representa a atuação de uma função do colaborador para o eSocial.
As opções possíveis são: S-Sim N-Não Ele somente deve ser preenchido quando nas Definições do eSocial estiver assinalado para considerar o histórico de cargo como Função do eSocial. |
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:Cargo_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Cargo_2Response>
</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. |
Local
Este web service permite alterar o histórico de local de trabalho (organograma) dos colaboradores.
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:Local> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <numLoc>String</numLoc> <conTov>String</conTov> <conTos>String</conTos> <locTra>Integer</locTra> <motAlt>Integer</motAlt> <tipOpe>String</tipOpe> </parameters> </ser:Local> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data de alteração do local
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
numLoc | Obrigatório | String | Código do novo local de trabalho do colaborador.
- Obrigatório |
conTov | Opcional | String | Indica se a troca do local deve ou não ser considerada no turn-over, quando da entrada do colaborador neste local.
- Opcional Valores: S - Sim N - Não Disponível nos módulos: BS, PLR, CP, RS, FP, SM, TR. Somente deverá ser informado quando o sistema estiver configurado para "Considerar Turn-Over". |
conTos | Opcional | String | Indica se a troca do local deve ou não ser considerada no turn-over quando da saída do colaborador deste local.
- Opcional Valores: S - Sim N - Não Disponível nos módulos: BS, PLR, CP, RS, FP, SM, TR. Somente deverá ser informado quando o sistema estiver configurado para "Considerar Turn-Over". |
locTra | Opcional | Integer | Código da cidade em que o colaborador efetivamente exerce sua função.
- Opcional Disponível somente no módulo FP. |
motAlt | Opcional | Integer | Código do motivo da alteração de local.
- Opcional |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:LocalResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:LocalResponse>
</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. |
Escala
Este web service é usado para registrar um histórico de escala, à qual todos os colaboradores estão associados, sejam administrativos, de revezamento, de rodízio, de produção ou outros.
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:Escala> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codEsc>Integer</codEsc> <codTma>Integer</codTma> <turInt>Integer</turInt> <codEqp>Integer</codEqp> <codCat>Integer</codCat> <tipOpe>String</tipOpe> <desSim>String</desSim> </parameters> </ser:Escala> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração do histórico de escala
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codEsc | Obrigatório | Integer | Código da nova escala do colaborador
- Obrigatório |
codTma | Opcional | Integer | Código da turma da escala do colaborador
- Obrigatório Disponível em todos os módulos, exceto no QL e JR Este parâmetro somente deve ser informado se a escala for dos tipos - P - Permanente, ou - B - Busca automática |
turInt | Opcional | Integer | Código da turma de intervalo
- Opcional Disponível nos módulos CP e PLR. |
codEqp | Opcional | Integer | Código da Equipe
- Obrigatório se tipo da escala for do tipo "G" Disponível em todos os módulos que possue histórico de escalas |
codCat | Opcional | Integer | Código da Categoria
- Obrigatório se tipo da escala for do tipo "G" Disponível em todos os módulos que possue histórico de escalas |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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". |
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:EscalaResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:EscalaResponse>
</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. |
Filial_4
Através deste web service o colaborador pode ser transferido para outra filial, dentro da mesma empresa ou para outra empresa, trocando ou não de código de cadastro.
Quando o web service de histórico de filial é executado com troca de cadastro do colaborador, é necessário preencher os parâmetros da guia Demais históricos.
Quando há integração com os módulos de Quadro de Vagas e Orçamento, o sistema verificará (ou não) a existência de vagas para determinado histórico, dependendo dos seguintes assinalamentos no cadastro da empresa (FR030EMP):
- Ver Quadro Admissão
- Ver Quadro Transferências
- Ver Quadro Função
Se estes campos estiverem configurados como "1 - Verifica e permite incluir" ou "2 - Verifica e não permite incluir", ao executar o web service, será verificado se existe vaga para determinado histórico. Caso não exista, será emitida uma mensagem alertando que não existe vaga e o processo será cancelado.
Para incluir históricos via web service e ignorar esta verificação, recomendamos desabilitar estes campos no cadastro da empresa, configurando-os com a opção "3 - Não verifica".
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 4
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Filial> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <novEmp>Integer</novEmp> <novCad>Integer</novCad> <codTap>Integer</codTap> <posTra>String</posTra> <novFil>Integer</novFil> <numLoc>String</numLoc> <codCcu>String</codCcu> <conFin>Integer</conFin> <natDes>Integer</natDes> <tipAdm>Integer</tipAdm> <admeSo>Integer</admeSo> <ficReg>Integer</ficReg> <conTov>String</conTov> <tipOpe>String</tipOpe> <motPos>Integer</motPos> <codCar>String</codCar> <carVag>String</carVag> <codMot>Integer</codMot> <horBas>Integer</horBas> <horSab>Integer</horSab> <horSem>Time</horSem> <horDsr>Time</horDsr> <codEsc>Integer</codEsc> <codTma>Integer</codTma> <turInt>Integer</turInt> <codVin>Integer</codVin> <codMts>Integer</codMts> <tipSal>Integer</tipSal> <codEst>Integer</codEst> <claSal>String</claSal> <nivSal>String</nivSal> <valSal>Double</valSal> <cplSal>Double</cplSal> <codSin>Integer</codSin> <socSin>String</socSin> <numCra>String</numCra> <traBHr>Integer</traBHr> <codBHr>Integer</codBHr> </parameters> </ser:Filial> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data de transferência para outra filial
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
novEmp | Opcional | Integer | Código da empresa para a qual o colaborador será transferido
- Obrigatório |
novCad | Opcional | Integer | Cadastro do colaborador na nova filial
- Obrigatório |
codTap | Opcional | Integer | Tipo de atuação de destino do colaborador.
Somente deverá ser informado quando houver troca de empresa ou de cadastro, e a empresa de destino utilizar posto de trabalho para o tipo de colaborador que será transferido |
posTra | Opcional | String | Posto de trabalho de destino do colaborador.
Somente deverá ser informado quando houver troca de empresa ou de cadastro, e a empresa de destino utilizar posto de trabalho para o tipo de colaborador que será transferido |
novFil | Opcional | Integer | Filial de destino do colaborador
- Obrigatório |
numLoc | Opcional | String | Código do novo local na nova filial.
- Obrigatório |
codCcu | Opcional | String | Código do centro de custo do colaborador na nova filial.
- Opcional - Máscara: U[18] Disponível nos módulos: BS, CS, JR, PLR, CP, AP |
conFin | Opcional | Integer | Código da conta financeira
- Opcional Disponível somente no módulo Administração de Pessoal. Este parâmetro só pode ser utilizado quando a empresa utilizar contabilização com rateio pelas contas financeiras e quando o parâmetro "CodCcu" for informado. |
natDes | Opcional | Integer | Código da Natureza de Despesa do colaborador na nova filial.
- Opcional Disponível nos módulos: BS, CS, JR, PLR, CP, AP |
tipAdm | Opcional | Integer | Código do tipo da admissão
- Obrigatório Disponível em todos os módulos, exceto no CS e QL. Valores: 1 - Primeiro Emprego 2 - Reemprego 3 - Transferência com Ônus 4 - Transferência sem Ônus 5 - Incorporação / Fusão / Cisão / Outros 6 - Reintegração 7 - Recondução (Servidor Público) 8 - Reversão / Readaptação (Servidor Público) |
admeSo | Opcional | Integer | Tipo de admissão do trabalhador para o eSocial
- Obrigatório Disponível somente no módulo Administração de Pessoal. Valores: 1 - Admissão 2 - Transferência de empresa do mesmo grupo econômico 3 - Admissão por sucessão, incorporação ou fusão 4 - Trabalhador Cedido 9 - Conversão Obs: - A opção 9 é para ser utilizada internamente dentro do sistema, não sendo possível seleciona-la. - Informar somente quando for histórico de admissão ou transferência de empresa. |
ficReg | Opcional | Integer | Número da ficha registro do colaborador
- Opcional Disponível somente nos módulos AP e CP |
conTov | Opcional | String | Considera Turn-Over
- Opcional Valores: S - Sim N - Não Somente deverá ser informado se o sistema estiver configurado para considerar "Turn-Over" |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
motPos | Opcional | Integer | Código do motivo de alteração do posto.
- Obrigatório Somente deverá ser informado se o sistema utiliza posto de trabalho. |
codCar | Opcional | String | Código do novo cargo.
- Obrigatório Será criado automaticamente um novo histórico de cargo com a data da transferência de filial |
carVag | Opcional | String | Cargo no qual o colaborador deveria estar exercendo, ou seja onde deveria ser considerada a vaga.
- Obrigatório Somente deverá ser informado se o sistema utiliza a opção de "Cargo da Vaga". |
codMot | Opcional | Integer | Código do motivo do cargo atual do colaborador.
- Obrigatório Será criado automaticamente um novo histórico de cargo, com o novo motivo, na data da transferência de filial |
horBas | Opcional | Integer | Código do horário base do colaborador
- Opcional Disponível nos módulos AP, RS, SM, TR Deve ser informado somente se o sistema não utiliza escala horária. |
horSab | Opcional | Integer | Código do horário de sábado do colaborador
- Opcional Disponível nos módulos AP, RS, SM, TR Deve ser informado somente se: - o sistema não utiliza escala horária e - se o parâmetro "HorBas" for informado. |
horSem | Opcional | Time | Quantidade de horas semanais
- Opcional - Máscara: HH:MM Disponível nos módulos AP, RS, SM, TR Deve ser informado somente se: - o sistema não utiliza escala horária e - se o parâmetro "HorBas" for informado. |
horDsr | Opcional | Time | Quantidade de horas DSR semanais
- Opcional - Máscara: HH:MM Disponível nos módulos AP, RS, SM, TR Deve ser informado somente se: - o sistema não utiliza escala horária e - se o parâmetro "HorBas" for informado. |
codEsc | Opcional | Integer | Código da nova escala do colaborador
- Opcional Este parâmetro somente deverá ser informado quando a empresa utilizar escala horária. |
codTma | Opcional | Integer | Código da nova turma de escala do colaborador
- Obrigatório Esse parâmetro somente deverá ser informado quando: - a empresa utilizar escala horária e - o parâmetro "CodEsc" for informado e - o tipo da escala for diferente de "D - Definida". |
turInt | Opcional | Integer | Código da nova turma de intervalo do colaborador
Disponível somente no módulo Controle de Ponto e Refeitório. Esse parâmetro somente deverá ser informado quando a empresa utilizar escala horária. |
codVin | Opcional | Integer | Código do novo vínculo do colaborador.
- Opcional Disponível nos módulos: BS, CS, JR, PLR, QL, CP, AP Caso este parâmetro seja informado com o valor 0 "zero", o sistema irá buscar o vínculo do colaborador na data da transferência. |
codMts | Opcional | Integer | Código do motivo da alteração do histórico salarial atual do colaborador.
- Opcional Disponível somente no módulo Administração de Pessoal. Será criado automaticamente um novo histórico salarial, com o novo motivo, na data da transferência de filial. |
tipSal | Opcional | Integer | Código do tipo de salário atual do colaborador.
- Obrigatório Disponível somente no módulo Administração de Pessoal. Somente deve ser informado se o parâmetro "CodMts" também for informado. Valores: 1 - Mensalista 2 - Horista 3 - Diarista 4 - Comissionado 5 - Tarefeiro 6 - Terceiro Será criado automaticamente um novo histórico salarial, com o novo tipo, na data da transferência de filial. |
codEst | Opcional | Integer | Código da nova estrutura salarial.
- Obrigatório Disponível somente no módulo Administração de Pessoal. Será criado automaticamente um novo histórico salarial, com a nova estrutura, na data da transferência de filial. |
claSal | Opcional | String | Código da nova classe salarial.
- Obrigatório Disponível somente no módulo Administração de Pessoal. Somente deverá ser informado se o parâmetro "CodEst" também for informado. Somente deverá ser informado quando o tipo da estrutura salarial for igual a M - Matriz |
nivSal | Opcional | String | Código do novo nível salarial.
- Obrigatório Disponível somente no módulo Administração de Pessoal. Somente deverá ser informado se o parâmetro "CodEst" também for informado. |
valSal | Opcional | Double | Se houver alteração de salário, informar o novo valor do salário.
- Opcional Disponível somente no módulo Administração de Pessoal. |
cplSal | Opcional | Double | Valor do complemento salarial
- Opcional Disponível somente no módulo Administração de Pessoal. |
codSin | Opcional | Integer | Código do novo sindicato.
- Opcional Disponível somente no módulo Administração de Pessoal. |
socSin | Opcional | String | Demonstra se atualmente o colaborador é sócio de seu sindicato.
- Opcional Valores: "S" - Sim "N" - Não Disponível somente no módulo Administração de Pessoal. |
numCra | Opcional | String | Número do novo crachá do colaborador para a transferência
- Opcional. Disponível nos módulos AP e AP (quando integrado com Controle de Ponto e Refeitório) |
codBHr | Opcional | Integer | Código do banco de horas para a transferência. - Opcional Disponível se integrado com o Gestão do Ponto e possuir conta em aberto no banco de horas. |
traBHr | Opcional | Integer | Opção de tratamento para banco de horas. - Opcional Valores: 1 - Somente Transferir 2 - Perdoar 3 - Pagar 4 - Descontar 5 - Migrar Caso possua Gestão do Ponto e banco de horas com saldo em aberto, o campo é Obrigatório, e, se não for preenchido, ocorre erro ao utilizar este web service. Caso não possua saldo em aberto e o preenchimento do campo na requisição seja enviado, também pode gerar erro. |
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:FilialResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:FilialResponse>
</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. |
Posto_4
Web service de integração que permite cadastrar Históricos de Postos de Trabalho.
Disponível em todos os módulo.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 4
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Posto_3> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tipOpe>String</tipOpe> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <iniAtu>DateTime</iniAtu> <codTap>Integer</codTap> <posTra>String</posTra> <motPos>Integer</motPos> <obsPos>String</obsPos> <excHis>String</excHis> <codCar>String</codCar> <carVag>String</carVag> <codEsc>Integer</codEsc> <codEqp>Integer</codEqp> <codCat>Integer</codCat> <funEso>String</funEso> <codTma>Integer</codTma> </parameters> </ser:Posto_3> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tipOpe | Opcional | String | Tipo da operação a ser efetuada
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão |
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave Máscara: 9[4] |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Máscara: 9[1] |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave Máscara: #[EdiCad]N(9,0)# |
iniAtu | Obrigatório | DateTime | Informar a data de inicio da atuação do posto.
- Obrigatório - Chave Máscara: DD/MM/YYYY |
codTap | Opcional | Integer | Informar o tipo de atuação do histórico de posto.
- Obrigatório na inserção Máscara: 9[3] |
posTra | Opcional | String | Informar o posto de trabalho do histórico
- Obrigatório na inserção Máscara: |
motPos | Opcional | Integer | Informar o motivo da alteração do histórico de posto de trabalho
- Obrigatório na inserção Máscara: 9[3] |
obsPos | Opcional | String | Outras observações referentes ao histórico do posto de trabalho do colaborador.
Máscara: A[700] |
excHis | Opcional | String | Determina se na exclusão do histórico de posto devem ser excluídos os históricos que ficarem inconsistentes.
Lista: S - Sim (ao utilizar essa opção, os históricos ficarão com as características do posto anterior). N - Não Máscara: A[1] |
codCar | Opcional | String | Neste campo é possível informar o cargo do novo histórico de cargo, oriundo da troca de posto.
- Informar somente quando o posto permitir vários cargos. Máscara: #[ediCar]# |
carVag | Opcional | String | Neste campo é possível informar o cargo da vaga do novo histórico de cargo, oriundo da troca de posto.
- Informar somente quando o posto permitir vários cargos. - Informar somente quando o sistema utilizar cargo da vaga. Máscara: #[ediCar]# |
codEsc | Opcional | Integer | - É possível definir a escala válida para o novo histórico de escala, que esteja de acordo com o turno informado na característica do posto.
- Informar somente caso nas características do posto, tenha um turno informado. - Informar somente caso a troca de posto for gerar um novo histórico de escala. |
codEqp | Opcional | Integer | É possível definir a equipe válida para o novo histórico de escala.
- Informar somente caso nas características do posto, não tenha uma equipe informada e tenha uma escala. - Informar somente caso a troca de posto for gerar um novo histórico de escala. - Informar somente caso o tipo da escala for Geração Automática. Máscara: 9[4] |
codCat | Opcional | Integer | É possível definir a categoria válida para o novo histórico de escala.
- Informar somente caso nas características do posto, não tenha uma categoria informada e tenha uma escala. - Informar somente caso a troca de posto for gerar um novo histórico de escala. - Informar somente caso o tipo da escala for Geração Automática. Máscara: 9[4] |
funEso | Opcional | String | Este campo indica se o cargo caracterizado no posto representa a atuação de uma função do colaborador para o eSocial.
As opções possíveis são: S-Sim N-Não Ele somente deve ser preenchido quando nas Definições do eSocial estiver assinalado para considerar o histórico de posto como Função do eSocial. |
codTma | Opcional | Integer | É possível definir a turma válida para o novo histórico de escala, que esteja de acordo com a escala informada na característica do posto.
- Informar somente caso nas características do posto, não tenha uma turma informada e tenha uma escala. - Informar somente caso a troca de posto for gerar um novo histórico de escala. Máscara: 9[1] |
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:Posto_3Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Posto_3Response>
</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. |
PostoAdicional_2
Web service de integração que permite cadastrar Históricos adicionais de Postos de Trabalho.
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:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:PostoAdicional_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tipOpe>String</tipOpe> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <iniAtu>DateTime</iniAtu> <seqHis>Integer</seqHis> <codTap>Integer</codTap> <motAlt>Integer</motAlt> <posTra>String</posTra> <terAtu>DateTime</terAtu> <tipSbs>Integer</tipSbs> <cadSbs>Integer</cadSbs> <perAdi>Integer</perAdi> <obsHpo>String</obsHpo> <funEso>String</funEso> </parameters> </ser:PostoAdicional_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão |
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave Máscara: 9[4] |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Máscara: 9[1] |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave Máscara: #[EdiCad]N(9,0)# |
iniAtu | Opcional | DateTime | Informar a data de inicio da atuação do posto adicional.
- Obrigatório - Chave Máscara: DD/MM/YYYY |
seqHis | Obrigatório | Integer | Informar a sequência do histórico
- Obrigatório - Chave Máscara: 9[2] |
codTap | Opcional | Integer | Informar o tipo de atuação do histórico adicional
- Obrigatório na inserção Máscara: 9[3] |
motAlt | Opcional | Integer | Informar o motivo da alteração do histórico adicional de posto de trabalho
- Obrigatório na inserção Máscara: 9[3] |
posTra | Opcional | String | Informar o posto de trabalho do histórico
- Obrigatório na inserção Máscara: |
terAtu | Opcional | DateTime | Informar o término da atuação do posto
Máscara: DD/MM/YYYY |
tipSbs | Opcional | Integer | Informar o tipo de colaborador que está sendo substituído.
- Habilitado somente quando o tipo de atuação for titular - Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Máscara: 9[1] |
cadSbs | Opcional | Integer | Informar o cadastro do colaborador que está sendo substituído.
- Habilitado somente quando o tipo de atuação for titular Máscara: #[EdiCad]N(9,0)# |
perAdi | Opcional | Integer | Informe o percentual que deve ser utilizado na regra de cálculo de adicional de posto.
Máscara: zzz9,99999 |
obsHpo | Opcional | String | Outras observações referentes ao histórico do posto de trabalho do colaborador.
Máscara: A[700] |
funEso | Opcional | String | Este campo indica se o cargo caracterizado no posto representa a atuação de uma função do colaborador para o eSocial.
As opções possíveis são: S-Sim N-Não Ele somente deve ser preenchido quando nas Definições do eSocial estiver assinalado para considerar o histórico de posto como Função do eSocial. |
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:PostoAdicional_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:PostoAdicional_2Response>
</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. |
DocumentosAfastamento
Através deste web service, nos é permitido cadastrar documentos para os afastamentos dos colaboradores.
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:DocumentosAfastamento> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAfa>DateTime</datAfa> <horAfa>Time</horAfa> <datArq>DateTime</datArq> <desArq>String</desArq> <uRL>String</uRL> <imagem>Blob</imagem> <nomArq>String</nomArq> </parameters> </ser:DocumentosAfastamento> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Opcional | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAfa | Obrigatório | DateTime | Data inicial do afastamento do colaborador
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
horAfa | Opcional | Time | Hora inicial do afastamento
- Obrigatório - Chave - Máscara: HH:MM |
datArq | Opcional | DateTime | Indicar uma data de inclusão do arquivo |
desArq | Opcional | String | Indicar uma descrição para o arquivo. |
uRL | Opcional | String | Indicar a URL que comporta um documento(limite 250 caracteres). |
imagem | Opcional | Blob | Campo blob para a passagem da imagem do documento via parâmetro, nos casos em que for possível.
- Opcional |
nomArq | Obrigatório | String | Nome do arquivo que será armazenado na base.
- Obrigatório. |
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:DocumentosAfastamentoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:DocumentosAfastamentoResponse>
</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. |
CentroCusto
Este web service permite cadastrar os históricos de centro de custo contábil por colaborador.
Quando há integração com os módulos de Quadro de Vagas e Orçamento, o sistema verificará (ou não) a existência de vagas para determinado histórico, dependendo dos seguintes assinalamentos no cadastro da empresa (FR030EMP):
- Ver Quadro Admissão
- Ver Quadro Transferências
- Ver Quadro Função
Se estes campos estiverem configurados como "1 - Verifica e permite incluir" ou "2 - Verifica e não permite incluir", ao executar o web service, será verificado se existe vaga para determinado histórico. Caso não exista, será emitida uma mensagem alertando que não existe vaga e o processo será cancelado.
Para incluir históricos via web service e ignorar esta verificação, recomendamos desabilitar estes campos no cadastro da empresa, configurando-os com a opção "3 - Não verifica".
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:CentroCusto> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codCCu>String</codCCu> <conFin>Integer</conFin> <tipOpe>String</tipOpe> </parameters> </ser:CentroCusto> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da transferência do centro de custo.
- Obrigatório - Chave |
codCCu | Obrigatório | String | Código do centro de custo para onde será transferido o colaborador.
- Obrigatório - Máscara: U[18] |
conFin | Opcional | Integer | Código da conta financeira (AP)
- Opcional Disponível somente para o módulo Administração de Pessoal. Somente deverá ser informado quando o sistema estiver configurado para utilizar contabilização com rateio pelas contas financeiras. |
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:CentroCustoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:CentroCustoResponse>
</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. |
Contrato
Este web service permite cadastrar os históricos de contrato dos colaboradores, somente permitindo registrar aos colaboradores dos tipos Terceiros ou Parceiros.
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:Contrato> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codOem>Integer</codOem> <numCon>String</numCon> <datFim>DateTime</datFim> <tipOpe>String</tipOpe> </parameters> </ser:Contrato> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data inicial do histórico, ou seja, a data a partir da qual o contrato teve início.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codOem | Opcional | Integer | Código da outra empresa a qual o colaborador pertence.
- Opcional |
numCon | Opcional | String | Número do contrato ao qual o colaborador pertence.
- Opcional. O número do contrato informado deve estar associado a uma outra empresa. Caso não seja infrmado o parâmetro "CodOem" este parâmetro também não deverá ser informado. |
datFim | Opcional | DateTime | Data de término do contrato.
- Obrigatório - Máscara: DD/MM/YYYY Este parâmetro não precisa ser informado caso o parâmetro "CodOem" tenha sido informado corretamente. |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:ContratoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:ContratoResponse>
</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. |
Sindicato
Este web service efetua as transferências de colaboradores entre os sindicatos cadastrados mantendo um histórico dessas alterações.
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:Sindicato> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codSin>Integer</codSin> <socSin>String</socSin> <tipOpe>String</tipOpe> </parameters> </ser:Sindicato> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração do sindicato.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codSin | Obrigatório | Integer | Código do sindicato do colaborador
- Obrigatório. |
socSin | Opcional | String | Sócio do Sindicato
- Obrigatório se: - Módulo Administração de Pessoal. Caso contrário, não informar. - LSimNao Valores: S - Sim N - Não |
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 Se não for informado, será considerado "alteração" |
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:SindicatoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:SindicatoResponse>
</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. |
Vinculo
Este web service efetua as transferências de colaboradores entre os vínculos cadastrados mantendo um histórico dessas alterações.
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:Vinculo> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codVin>Integer</codVin> <tipOpe>String</tipOpe> </parameters> </ser:Vinculo> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração do histórico de vínculo
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codVin | Obrigatório | Integer | Código do vínculo do colaborador.
- Obrigatório |
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 Se não for informado, será considerado "alteração" |
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:VinculoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:VinculoResponse>
</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. |
Anotacao
Este web service permite informar anotações para serem incluídas na ficha registro eletrônica. Estas anotações podem se referir a Contratos de Aprendizagem de Menores (Senai, Senac ou Senai), alteração de período aquisitivo de férias, transferência de banco de depósito FGTS, etc. Este item também pode servir para a empresa que deseja efetuar um registro particular de seus colaboradores tais como disciplinas, premiações etc.
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:Anotacao> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datNot>DateTime</datNot> <seqNot>Integer</seqNot> <tipNot>Integer</tipNot> <codTce>Integer</codTce> <nroDoc>String</nroDoc> <notFic>String</notFic> <empDig>Integer</empDig> <tipDig>Integer</tipDig> <cadDig>Integer</cadDig> <tipOpe>String</tipOpe> </parameters> </ser:Anotacao> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datNot | Obrigatório | DateTime | Data da anotação a ser feita na ficha.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
seqNot | Obrigatório | Integer | Número de sequência para as anotações da mesma data.
- Obrigatório - Chave Deve iniciar com o valor "1". |
tipNot | Opcional | Integer | Código do tipo da anotação sendo realizada.
- Opcional |
codTce | Opcional | Integer |
Código do treinamento, conforme tabela 28 eSocial* Este campo estará habilitado somente quando o tipo eSocial, do tipo de anotação for igual a 15, sendo também obrigatório neste caso. Máscara: 9[4] *Exceto aqui os treinamentos 1006, 1207 e 3719 que já são tratados de acordo com o tipo eSocial da anotação |
nroDoc | Opcional | String | Número de documento que gerou a anotação
- Opcional |
notFic | Opcional | String | Texto com 2500 bytes, onde pode ser efetuada a descrição que deverá constar da ficha registro em cada data.
- Opcional |
empDig | Opcional | Integer | Código da empresa do responsável pela anotação.
- Opcional |
tipDig | Opcional | Integer | Tipo do colaborador responsável pela anotação.
- Obrigatório Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro Somente deverá ser informado se o parâmetro "EmpDig" for maior que zero. |
cadDig | Opcional | Integer | Código do cadastro do responsável pela anotação.
- Obrigatório Somente deve ser informado se o parâmetro "EmpDig" for maior que zero. |
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 Se não for informado, será considerado "alteração" |
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:AnotacaoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:AnotacaoResponse>
</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. |
Adicional_2
Através deste web service, podemos informar os percentuais de insalubridade e periculosidade devidos ao colaborador que pode estar em local indicado como insalubre ou perigoso.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Adicional_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <perIns>Double</perIns> <perPer>Double</perPer> <fatTpo>Double</fatTpo> <apoEsp>Integer</apoEsp> <cmpTer>DateTime</cmpTer> <tipOpe>String</tipOpe> </parameters> </ser:Adicional_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data de início de validade dos percentuais cadastrados.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
perIns | Opcional | Double | Percentual de insalubridade devido, podendo ser zero.
- Opcional |
perPer | Opcional | Double | Percentual de periculosidade devido, podendo ser zero.
- Opcional |
fatTpo | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador sob estes percentuais, para o cálculo do tempo de serviço para aposentadoria.
- Opcional Disponível somente para o módulo Administração de Pessoal. |
apoEsp | Opcional | Integer | Indicar, se o colaborador tiver direito, a quantidade de anos devido de Aposentadoria Especial.
- Opcional Valores: 0 - Não possui aposentadoria especial 1 - Não exposição a agente nocivo. Trabalhador já esteve exposto 15 - Apos. especial aos quinze anos de serviço 20 - Apos. especial aos vinte anos de serviço 25 - Apos. especial aos vinte e cinco anos de serviço Disponível para os módulo AP e SM (quando não estiver integrado com Administração de Pessoal) |
cmpTer | Opcional | DateTime | Competência de Término do Adicional
- Opcional Máscara: MM/YYYY |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:Adicional_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Adicional_2Response>
</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. |
AdicionalLocalCargo_2
Este web service permite informar os percentuais de insalubridade e periculosidade devidos para os cargos em determinados locais do organograma. Dessa forma, os colaboradores que estiverem alocados a esse local e cargo receberão o adicional automaticamente no cálculo da folha.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:AdicionalLocalCargo_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <numLoc>String</numLoc> <codCar>String</codCar> <datAlt>DateTime</datAlt> <perIns>Double</perIns> <perPer>Double</perPer> <fatTph>Double</fatTph> <fatTpm>Double</fatTpm> <apoEsp>Integer</apoEsp> <cmpTer>DateTime</cmpTer> <tipOpe>String</tipOpe> </parameters> </ser:AdicionalLocalCargo_2> </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 |
numLoc | Obrigatório | String | Local de trabalho que deve ser pago o adicional
- Obrigatório - Chave |
codCar | Obrigatório | String | Código do cargo para o qual deve ser pago.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração que irá para o histórico
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
perIns | Opcional | Double | Percentual de insalubridade devido em cada local ou cargo.
- Opcional |
perPer | Opcional | Double | percentual de periculosidade devido em cada local ou cargo.
- Opcional |
fatTph | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Homens.
- Opcional - Máscara: 99,99 Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
fatTpm | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Mulheres.
- Opcional - Máscara: 99,99 Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
apoEsp | Opcional | Integer | Indicar, se o colaborador tiver direito, a quantidade de anos devido de Aposentadoria Especial
- Opcional Valores: 0 - Não possui aposentadoria especial 1 - Não exposição a agente nocivo. Trabalhador já esteve exposto. 15 - Apos. especial aos quinze anos de serviço 20 - Apos. especial aos vinte anos de serviço 25 - Apos. especial aos vinte e cinco anos de serviço Disponível somente no sistema SM. |
cmpTer | Opcional | DateTime | Competência de Término do Adicional
- Opcional Máscara: MM/YYYY |
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 Se não for informado, será considerado "alteração" |
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:AdicionalLocalCargo_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:AdicionalLocalCargo_2Response>
</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. |
AdicionalLocal_2
Este web service permite informar os percentuais de insalubridade e periculosidade devidos em cada local do organograma, assim os colaboradores neles alocados receberão o adicional automaticamente no cálculo da folha.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:AdicionalLocal_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <numLoc>String</numLoc> <datAlt>DateTime</datAlt> <perIns>Double</perIns> <perPer>Double</perPer> <fatTph>Double</fatTph> <fatTpm>Double</fatTpm> <apoEsp>Integer</apoEsp> <cmpTer>DateTime</cmpTer> <tipOpe>String</tipOpe> </parameters> </ser:AdicionalLocal_2> </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 |
numLoc | Obrigatório | String | Código do local de trabalho que deve ser pago o adicional
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração que irá para o histórico
- Obrigatório - Chave |
perIns | Opcional | Double | Percentual de insalubridade devido em cada local ou cargo.
- Opcional |
perPer | Opcional | Double | Percentual de periculosidade devido em cada local ou cargo.
- Opcional |
fatTph | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Homens.
- Opcional Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
fatTpm | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Mulheres.
- Opcional Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
apoEsp | Opcional | Integer | Indicar, se o colaborador tiver direito, a quantidade de anos devido de Aposentadoria Especial.
- Opcional Valores: 0 - Não possui aposentadoria especial 1 - Não exposição a agente nocivo. Trabalhador já esteve exposto 15 - Apos. especial aos quinze anos de serviço 20 - Apos. especial aos vinte anos de serviço 25 - Apos. especial aos vinte e cinco anos de serviço Disponível somente para o sistema SM. |
cmpTer | Opcional | DateTime | Competência de Término do Adicional
- Opcional Máscara: MM/YYYY |
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 Se não for informado, será considerado "alteração" |
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:AdicionalLocal_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:AdicionalLocal_2Response>
</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. |
AdicionalCargo
Este web service permite informar os percentuais de insalubridade e periculosidade devidos em cada cargo, assim os colaboradores neles alocados receberão o adicional automaticamente no cálculo da folha.
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:AdicionalCargo> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <codCar>String</codCar> <datAlt>DateTime</datAlt> <perIns>Double</perIns> <perPer>Double</perPer> <fatTph>Double</fatTph> <fatTpm>Double</fatTpm> <apoEsp>Integer</apoEsp> <cmpTer>DateTime</cmpTer> <tipOpe>String</tipOpe> </parameters> </ser:AdicionalCargo> </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 |
codCar | Obrigatório | String | Código do cargo que terá os adicionais vinculados
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Competência de Término do Adicional
- Opcional |
perIns | Opcional | Double | Percentual de insalubridade devido em cada local ou cargo.
- Opcional |
perPer | Opcional | Double | Percentual de periculosidade devido em cada local ou cargo.
- Opcional |
fatTph | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Homens.
- Opcional Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
fatTpm | Opcional | Double | Fator para conversão do período trabalhado pelo colaborador neste local, para o cálculo do tempo de serviço para aposentadoria para Mulheres.
- Opcional Somente deve ser informado quando estiver integrado com o sistema Administração de Pessoal. |
apoEsp | Opcional | Integer | Indicar, se o colaborador tiver direito, a quantidade de anos devido de Aposentadoria Especial.
- Opcional Valores: 0 - Não possui aposentadoria especial 1 - Não exposição a agente nocivo. Trabalhador já esteve exposto 15 - Apos. especial aos quinze anos de serviço 20 - Apos. especial aos vinte anos de serviço 25 - Apos. especial aos vinte e cinco anos de serviço |
cmpTer | Opcional | DateTime | Competência de Término do Adicional
- Opcional Máscara: MM/YYYY |
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 Se não for informado, será considerado "alteração" |
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:AdicionalCargoResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:AdicionalCargoResponse>
</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. |
ValeTransporte_2
Este web service permite cadastrar os históricos de escala de vale transporte por colaborador.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:ValeTransporte_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tipOpe>String</tipOpe> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <iniEvt>DateTime</iniEvt> <escVtr>String</escVtr> <ponEmb>Integer</ponEmb> <fimEvt>DateTime</fimEvt> <wGD038EVN> <tipOpe>String</tipOpe> <codLin>Integer</codLin> <numCar>String</numCar> </wGD038EVN> </parameters> </ser:ValeTransporte_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
"I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "Inclusão" |
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
iniEvt | Obrigatório | DateTime | Data inicial de validade do histórico.
- Obrigatório - Chave |
escVtr | Opcional | String |
Escala do Vale Transporte utilizada pelo colaborador. |
ponEmb | Opcional | Integer | Informar Ponto de embarque do colaborador.
- Opcional |
fimEvt | Opcional | DateTime | Data Final de validade do histórico.
- Opcional |
wGD038EVN | Opcional | Set | Número do cartão conforme a linha.
Observação: Ao inserir um histórico são sugeridas as linhas cadastradas na escala. |
wGD038EVN.tipOpe | Opcional | String | Tipo da operação a ser efetuada para o registro.
- Obrigatório - Máscara: U - Valores: "I" - Inclusão "A" - Alteração "E" - Exclusão - Obs.: Se não for informado, será considerado "Alteração". |
wGD038EVN.codLin | Opcional | Integer | (Obrigatório) - Number(005) - Linha |
wGD038EVN.numCar | Opcional | String | (Opcional) - String(016) - Número do cartão |
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:ValeTransporte_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:ValeTransporte_2Response>
</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. |
Estabilidade_2
Este web service é usado para cadastrar os históricos de estabilidade para os colaboradores.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Estabilidade_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <iniEtb>DateTime</iniEtb> <fimEtb>DateTime</fimEtb> <codEtb>Integer</codEtb> <tipOpe>String</tipOpe> <obsIni>String</obsIni> <obsFim>String</obsFim> </parameters> </ser:Estabilidade_2> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
numEmp | Obrigatório | Integer | Código da empresa que será utilizado na integração
- Obrigatório - Chave |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador, que poderá ser::
- Obrigatório - Chave Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
iniEtb | Obrigatório | DateTime | Data de início da estabilidade.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
fimEtb | Opcional | DateTime | Data de término da estabilidade do colaborador.
- Opcional - Máscara: DD/MM/YYYY |
codEtb | Obrigatório | Integer | Código do tipo de estabilidade do colaborador.
- Opcional Valores: 0 - Não Estável 1 - CIPA 2 - Acidente Trabalho 3 - Auxílio Maternidade 4 - Serviço Militar 5 - Mandato Sindical 6 - Servidor Público 7 - Retorno Férias 8 - Retorno Auxílio-doença 9 - Tempo Próximo Aposentadoria 10 - Convenção Coletiva (Dissídio) 11 - Tempo Anterior Opção FGTS 12 - Não Optante FGTS 13 - CIPA Empregador 14 - Membro da Comissão de Conciliação Prévia 15 - Membro do Conselho Curador do FGTS 16 - Membro do Conselho Nacional da Previdência Social 17 - Auxílio Educação 18 - Cooperativa de Consumo 19 - Cooperativa de Crédito 21 - Cooperativa do Sindicato 22 - CIPATR 99 - Outros |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
obsIni | Opcional | String | Campo Observação Inicial do histórico de estabilidade.
- Opcional - 255 caracteres |
obsFim | Opcional | String | Campo observação final do histórico de estabilidade.
- Opcional - 255 caracteres |
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:Estabilidade_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Estabilidade_2Response>
</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. |
Funcao_2
Este web service permite cadastrar os Históricos de Função dos colaboradores. Esses históricos possibilitarão o cálculo do adicional de função.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Funcao_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datIni>DateTime</datIni> <seqAlt>Integer</seqAlt> <tipSbs>String</tipSbs> <tclSbs>Integer</tclSbs> <cadSbs>Integer</cadSbs> <numLoc>String</numLoc> <codCar>String</codCar> <datFim>DateTime</datFim> <codEst>Integer</codEst> <claSal>String</claSal> <nivSal>String</nivSal> <perSbs>Double</perSbs> <desObs>String</desObs> <motAlt>Integer</motAlt> <funEso>String</funEso> <tipOpe>String</tipOpe> </parameters> </ser:Funcao_2> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datIni | Obrigatório | DateTime | Data inicial, ou seja, a partir de quando o colaborador passará a desempenhar a função.
- Obrigatório - Chave |
seqAlt | Obrigatório | Integer | Código da sequência do cadastro
- Obrigatório - Chave |
tipSbs | Obrigatório | String | Indicar se o colaborador será o titular ou substituto dessa função:
- Obrigatório Valores: T - Titular S - Substituto. |
tclSbs | Opcional | Integer | Tipo do substituído - Opcional Valores: 1 - Colaborador 2 - Terceiro 3 - Parceiro Este parâmetro somente deverá ser informado quando o "TipSbs" for "S - Substituto" |
cadSbs | Opcional | Integer | Cadastro do colaborador substituído - Obrigatório Este parâmetro somente deverá ser informado quando o "TipSbs" for "S - Substituto" |
numLoc | Opcional | String | Código do local em que o colaborador exercerá a função.
- Opcional |
codCar | Obrigatório | String | Código do cargo que o colaborador desempenhará no período
- Obrigatório |
datFim | Opcional | DateTime | Data final, ou seja, até quando o colaborador desempenhou a função.
- Opcional |
codEst | Opcional | Integer | Código da estrutura salarial, que será utilizada no cálculo do adicional de função.
- Opcional Disponível nos módulos: BS, CS, QL, PLR, AP. |
claSal | Opcional | String | Classe salarial, que será utilizada no cálculo do adicional de função.
- Opcional Disponível nos módulos: BS, CS, QL, PLR, AP. Somente deverá ser informado se: - o parâmetro "CodEst" também for informado. - o "Tipo do formato" for "M - Matriz" |
nivSal | Opcional | String | Nível salarial, que será utilizada no cálculo do adicional de função.
- Opcional Disponível nos módulos: BS, CS, QL, PLR, AP. Este parâmetro somente poderá ser informado se o parâmetro "CodEst" também for informado. |
perSbs | Opcional | Double | Percentual que será utilizado no cálculo do adicional de função.
- Opcional Disponível nos módulos: BS, QL, PLR, AP. |
desObs | Opcional | String | Texto de observação
- Opcional |
motAlt | Opcional | Integer | Motivo da alteração da Função.
- Opcional |
funEso | Opcional | String | Este campo indica se o histórico de função representa a atuação de uma função do colaborador para o eSocial.
As opções possíveis são: S-Sim N-Não Ele somente deve ser preenchido quando nas Definições do eSocial estiver assinalado para considerar o histórico de função como Função do eSocial. |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:Funcao_2Response>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:Funcao_2Response>
</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. |
NaturezaDespesa
Neste web service é feito o cadastramento do histórico de natureza de despesa do colaborador.
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:NaturezaDespesa> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <natDes>Integer</natDes> <tipOpe>String</tipOpe> </parameters> </ser:NaturezaDespesa> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da transferência para a nova natureza de despesa
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
natDes | Obrigatório | Integer | Código da nova natureza de despesa do colaborador
- Obrigatório |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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:NaturezaDespesaResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:NaturezaDespesaResponse>
</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. |
Horario
Este web service é usado para registrar qual o horário de trabalho de um colaborador, bem como seu horário no sábado, quantas horas semanais e também seu descanso semanal remunerado.
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:Horario> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <horBas>Integer</horBas> <horSab>Integer</horSab> <horSem>Time</horSem> <horDsr>Time</horDsr> <tipOpe>String</tipOpe> <desSim>String</desSim> </parameters> </ser:Horario> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data de alteração do horário do colaborador
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
horBas | Opcional | Integer | Código do horário base do colaborador
- Obrigatório |
horSab | Opcional | Integer | Código do horário de sábado do colaborador
- Obrigatório |
horSem | Opcional | Time | Quantidade de horas semanais do colaborador
- Obrigatório - Máscara: HH:MM |
horDsr | Opcional | Time | Quantidade de horas DSR do colaborador.
- Obrigatório - Máscara: HH:MM |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteração" |
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". |
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:HorarioResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:HorarioResponse>
</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. |
Salario_2
Este web service permite alterar os salários individualmente por colaborador.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Salario> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <seqAlt>Integer</seqAlt> <codMot>Integer</codMot> <datDis>DateTime</datDis> <tipSal>Integer</tipSal> <codEst>Integer</codEst> <claSal>String</claSal> <nivSal>String</nivSal> <valSal>Double</valSal> <cplSal>Double</cplSal> <codIdm>Integer</codIdm> <salEst>Double</salEst> <cplEst>Double</cplEst> <tipOpe>String</tipOpe> </parameters> </ser:Salario> </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 |
tipCol | Obrigatório | Integer | Informar o tipo de colaborador.
- Obrigatório - Chave Valores: "1" - Empregado "2" - Terceiro "3" - Parceiro |
numCad | Obrigatório | Integer | Indicar um número de cadastro para identificar cada colaborador, terceiro ou parceiro.
- Obrigatório - Chave |
datAlt | Obrigatório | DateTime | Data da alteração salarial do colaborador.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
seqAlt | Obrigatório | Integer | Código da sequência para reajustes na mesma data.
- Obrigatório - Chave Sempre inicia com o valor "1". |
codMot | Obrigatório | Integer | Código do motivo da alteração salarial.
- Obrigatório |
datDis | Opcional | DateTime | Informar a data do fechamento do dissídio (máscara DD/MM/YYYY). Somente pode ser informado, se o motivo (parâmetro codMot) for do tipo "Legal". |
tipSal | Obrigatório | Integer | Código do tipo do salário
- Obrigatório Valores: 1 - Mensalista 2 - Horista 3 - Diarista 4 - Comissionado 5 - Tarefeiro 6 - Terceiro |
codEst | Opcional | Integer | Código da estrutura salarial do colaborador.
- Opcional Disponível somente para os módulos: CS, CP, PLR, AP |
claSal | Opcional | String | Classe da estrutura salarial a que pertence.
- Obrigatório Disponível para os módulos: CS, CP, PLR, AP Somente pode ser informado se o parâmetro "CodEst" for maior que zero. |
nivSal | Opcional | String | Valor do nível da classe a que pertence o salário.
- Obrigatório Disponível para os módulos: CS, CP, PLR, AP Somente pode ser informado se o parâmetro "CodEst" for maior que zero. |
valSal | Opcional | Double | Valor do salário do colaborador.
- Opcional O valore informado para o colaborador deverá ser maior que o valor do salário anterior que este já possuía. |
cplSal | Opcional | Double | - Valor do complemento salarial
- Opcional Disponível para os módulos: CS, CP, PLR, AP, BS, JR |
codIdm | Opcional | Integer | Código do índice a ser utilizado
- Opcional Disponível somente para o módulo Administração de Pessoal, versão Internacional e para o "Peru" |
salEst | Opcional | Double | Valor do salário em moeda estrangeira
- Opcional Disponível somente para o módulo Administração de Pessoal, versão Internacional e para o "Peru" |
cplEst | Opcional | Double | Valor do complemento salarial em moeda estrangeira.
- Opcional Disponível somente para o módulo Administração de Pessoal, versão Internacional e para o "Peru" |
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 Se não for informado, será considerado "alteração" |
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:SalarioResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:SalarioResponse>
</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. |
Receita
Este web service permite que colaboradores, residentes ou domiciliados no exterior, participem de um cálculo diferenciado de IR, os quais têm uma aplicação direta da alíquota devida sobre a base de cálculo, não havendo deduções. Dessa forma os colaboradores enquadrados nesta situação devem possuir uma receita e alíquota específicas.
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:Receita> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <numEmp>Integer</numEmp> <tipCol>Integer</tipCol> <numCad>Integer</numCad> <datAlt>DateTime</datAlt> <codRec>Integer</codRec> <tipIrf>String</tipIrf> <perAli>Double</perAli> <forTri>Integer</forTri> <tipRen>Integer</tipRen> <tipOpe>String</tipOpe> </parameters> </ser:Receita> </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 - Máscara: 9999 |
tipCol | Obrigatório | Integer | Tipo de colaborador.
- Obrigatório - Chave - Máscara: 9 Valores: 1 - Empregado 2 - Terceiro 3 - Parceiro |
numCad | Obrigatório | Integer | Código do Colaborador.
- Obrigatório - Chave - Máscara: 999999999 |
datAlt | Obrigatório | DateTime | Data da alteração do histórico.
- Obrigatório - Chave - Máscara: DD/MM/YYYY |
codRec | Obrigatório | Integer | Código da receita de IR do colaborador.
- Obrigatório - Máscara: 9999 |
tipIrf | Obrigatório | String | Cálcular IR Normal.
- Obrigatório - Máscara: U Valores: "S" - Sim "N" - Não |
perAli | Opcional | Double | Percentual a ser utilizado no cálculo do IR
- Obrigatório - Máscara: 99,99 Este parâmetro só deve ser informado se o parâmetro TipIrf for igual a "N". |
forTri | Opcional | Integer | Forma de Tributação.
- Opcional - Máscara: 999 Este parâmetro só deve ser informado se o parâmetro TipIrf for igual a "N" ou "E". |
tipRen | Opcional | Integer | Tipo de Rendimento
- Opcional - Máscara: 99 Este parâmetro só deve ser informado se o parâmetro TipIrf for igual a "N" ou "E". |
tipOpe | Obrigatório | String | Tipo da operação a ser efetuada na integração.
- Obrigatório - Máscara: U Valores: "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "Alteração". |
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:ReceitaResponse>
<result>
<erroExecucao>String</erroExecucao>
</result>
</ser:ReceitaResponse>
</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. |