Web service com.senior.g5.rh.sm.outrasempresas

Tipo de execução

Para cada tipo de execução, existem parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.

Autenticação

Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.

WSDL

Portas

OutrasEmpresas

Por meio deste web service, nos é permitido informar outras empresas para o módulo SM.

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:OutrasEmpresas> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <codOem>Integer</codOem> <nomOem>String</nomOem> <apeOem>String</apeOem> <codPai>Integer</codPai> <codEst>String</codEst> <codCid>Integer</codCid> <codBai>Integer</codBai> <codCep>String</codCep> <endOem>String</endOem> <endNum>String</endNum> <endCpl>String</endCpl> <ddiTel>Integer</ddiTel> <dddTel>Integer</dddTel> <numTel>String</numTel> <ddiFax>Integer</ddiFax> <dddFax>Integer</dddFax> <numFax>String</numFax> <homPag>String</homPag> <emaEmp>String</emaEmp> <tipIns>Integer</tipIns> <numCgc>Double</numCgc> <numCNO>String</numCNO> <nCAEPF>String</nCAEPF> <insEst>String</insEst> <pesCo1>String</pesCo1> <indObr>Integer</indObr> <iniVal>String</iniVal> <fimVal>String</fimVal> <tipOpe>String</tipOpe> <numRam>String</numRam> <faxRam>String</faxRam> </parameters> </ser:OutrasEmpresas> </soapenv:Body> </soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

codOem

Obrigatório

Integer

Código de outras empresas.



Máscara: 9[8]

nomOem

Opcional

String

Nome da outra empresa.



Máscara: A[60]


apeOem

Opcional

String

Apelido da outra empresa.



Edição A[040]


Observação: nome reduzido da empresa que irá aparecer nos relatórios e na linha inferior do vídeo.

codPai

Opcional

Integer

Código do país.



Máscara: 9[4]


codEst

Opcional

String

Estado.



Máscara: U[4]

codCid

Opcional

Integer

Cidade da empresa.

Máscara: 99.99999

codBai

Opcional

Integer

Código do bairro.

Máscara: 9[4]

codCep

Opcional

String

CEP.

Máscara: #[EdiCep]N(8,0)#

Observação: o CEP é sugerido automaticamente pelo sistema de acordo com a cidade e o bairro informados.

endOem

Opcional

String

Endereço da empresa.

Máscara: A[60]

endNum

Opcional

String

Número logradouro.

Máscara: A[5]

endCpl

Opcional

String

Complemento do endereço.

Máscara: A[25]

ddiTel

Opcional

Integer

Código DDI do telefone.



Máscara: 9[3]


dddTel

Opcional

Integer

Código DDD do telefone.



Máscara: 9[3]


numTel

Opcional

String

Telefone da empresa.



Máscara: A[20]



Observação: informar o telefone da outra empresa, precedido dos códigos DDI e DDD (exemplo: 055 047 3221-3300).

ddiFax

Opcional

Integer

Código DDI do fax.



Máscara: 9[3]


dddFax

Opcional

Integer

Código DDD do fax.

Máscara: 9[3]

numFax

Opcional

String

Fax da empresa.

Máscara: A[15]

Observação: informar o número do fax da outra empresa, precedido dos códigos DDI e DDD (exemplo: 055 047 3221-3300).

homPag

Opcional

String

Homepage da empresa.



Máscara: A[50]

emaEmp

Opcional

String

E- mail da outra empresa.

Máscara: A[100]

tipIns

Opcional

Integer

Tipo de inscrição da filial (CNPJ/CEI/CPF/INCRA).

Máscara: 9[1]

Observação: determinar o tipo de inscrição da outra empresa que está sendo cadastrada ou deixar “0” para que não seja preciso informar o número no campo sequencial.

numCgc

Opcional

Double

Informar o número do cadastro do CNPJ/MF.



Máscara: z99.999.999/9999-99



Observação: se foi indicado tipo “CEI”, “CPF” ou “INCRA” no dado anterior, é este número que deve ser informado neste espaço.


numCNO

Opcional

String

Inscrição no CNO.



Máscara: A[14]


nCAEPF

Opcional

String

Inscrição no CAEPF.



Máscara: A[14]


insEst

Opcional

String

Inscrição estadual.

Máscara: A[15]

Observação: indicar a inscrição estadual da outra empresa ou indicar “Isento”.

pesCo1

Opcional

String

Pessoa de contato na empresa.



Máscara: A[30]


indObr

Opcional

Integer

Indicativo de obra.



Máscara: 9[1]


iniVal

Opcional

DateTime

Data início validade.



Máscara: DD/MM/YYYY


fimVal

Opcional

DateTime

Data fim da validade.



Máscara: DD/MM/YYYY

tipOpe

Opcional

String

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



“I - Inclusão”


“A - Alteração”


“E - Exclusão”

numRam

Opcional

String

Número do ramal do telefone.



Máscara: A[15]

faxRam

Opcional

String

Número do ramal do fax.



Máscara: A[15]

Resposta:

Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, a mensagem do erro ocorrido.

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:OutrasEmpresasResponse> <result> <erroExecucao>String</erroExecucao> </result> </ser:OutrasEmpresasResponse> </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.
### OutrasEmpresas_2 Por meio deste web service, é possível informar outras empresas no módulo SM.

Nota

Esta porta apresenta um ou mais parâmetros que permitem o envio de CNPJ alfanumérico.

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:OutrasEmpresas> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <codOem>Integer</codOem> <nomOem>String</nomOem> <apeOem>String</apeOem> <codPai>Integer</codPai> <codEst>String</codEst> <codCid>Integer</codCid> <codBai>Integer</codBai> <codCep>String</codCep> <endOem>String</endOem> <endNum>String</endNum> <endCpl>String</endCpl> <ddiTel>Integer</ddiTel> <dddTel>Integer</dddTel> <numTel>String</numTel> <numRam>String</numRam> <ddiFax>Integer</ddiFax> <dddFax>Integer</dddFax> <numFax>String</numFax> <faxRam>String</faxRam> <homPag>String</homPag> <emaEmp>String</emaEmp> <tipIns>Integer</tipIns> <numCNO>String</numCNO> <nCAEPF>String</nCAEPF> <insEst>String</insEst> <pesCo1>String</pesCo1> <indObr>Integer</indObr> <iniVal>DateTime</iniVal> <fimVal>DateTime</fimVal> <cfjCgc>Double</cfjCgc> <tipOpe>String</tipOpe> </parameters> </ser:OutrasEmpresas> </soapenv:Body> </soapenv:Envelope>

Parâmetros da requisição:

Nome

Preenchimento

Tipo

Descrição

codOem

Obrigatório

Integer

Código de outras empresas.



Máscara: 9[8]

nomOem

Opcional

String

Nome da outra empresa.



Máscara: A[60]

apeOem

Opcional

String

Apelido da outra empresa.



Edição A[040]


Observação: nome reduzido da empresa que irá aparecer nos relatórios e na linha inferior do vídeo.

codPai

Opcional

Integer

Código do país.



Máscara: 9[4]


codEst

Opcional

String

Estado.



Máscara: U[4]

codCid

Opcional

Integer

Cidade da empresa.

Máscara: 99.99999

codBai

Opcional

Integer

Código do bairro.

Máscara: 9[4]

codCep

Opcional

String

CEP.

Máscara: #[EdiCep]N(8,0)#

Observação: o CEP é sugerido automaticamente pelo sistema de acordo com a cidade e o bairro informados.

endOem

Opcional

String

Endereço da empresa.

Máscara: A[60]

endNum

Opcional

String

Número logradouro.

Máscara: A[5]

endCpl

Opcional

String

Complemento do endereço.

Máscara: A[25]

ddiTel

Opcional

Integer

Código DDI do telefone.



Máscara: 9[3]


dddTel

Opcional

Integer

Código DDD do telefone.



Máscara: 9[3]


numTel

Opcional

String

Telefone da empresa.



Máscara: A[20]



Observação: informar o telefone da outra empresa, precedido dos códigos DDI e DDD (exemplo: 055 047 3221-3300).

ddiFax

Opcional

Integer

Código DDI do fax.



Máscara: 9[3]


dddFax

Opcional

Integer

Código DDD do fax.

Máscara: 9[3]

numRam

Opcional

String

Número do ramal do telefone.



Máscara: A[15]

numFax

Opcional

String

Fax da empresa.

Máscara: A[15]

Observação: informar o número do fax da outra empresa, precedido dos códigos DDI e DDD (exemplo: 055 047 3221-3300).

faxRam

Opcional

String

Número do ramal do fax.



Máscara: A[15]

homPag

Opcional

String

Homepage da empresa.



Máscara: A[50]

emaEmp

Opcional

String

E- mail da outra empresa.

Máscara: A[100]

tipIns

Opcional

Integer

Tipo de inscrição da filial (CNPJ/CEI/CPF/INCRA).

Máscara: 9[1]

Observação: determinar o tipo de inscrição da outra empresa que está sendo cadastrada ou deixar “0” para que não seja preciso informar o número no campo sequencial.

numCNO

Opcional

String

Inscrição no CNO.



Máscara: A[14]

nCAEPF

Opcional

String

Inscrição no CAEPF.



Máscara: A[14]

insEst

Opcional

String

Inscrição estadual.

Máscara: A[15]

Observação: indicar a inscrição estadual da outra empresa ou indicar “Isento”.

pesCo1

Opcional

String

Pessoa de contato na empresa.



Máscara: A[30]

indObr

Opcional

Integer

Indicativo de obra.



Máscara: 9[1]

iniVal

Opcional

DateTime

Data início validade.



Máscara: DD/MM/YYYY

fimVal

Opcional

DateTime

Data fim da validade.



Máscara: DD/MM/YYYY

cfjCgc

Opcional

Double

Informar o número de inscrição da outra empresa.


tipOpe

Opcional

String

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



“I - Inclusão”


“A - Alteração”


“E - Exclusão”

Resposta:
Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, a mensagem do erro ocorrido.

<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:ser=“http://services.senior.com.br”> <soapenv:Body> <ser:OutrasEmpresasResponse> <result> <erroExecucao>String</erroExecucao> </result> </ser:OutrasEmpresasResponse> </soapenv:Body> </soapenv:Envelope>

Atributos da resposta:

Nome

Preenchimento

Tipo

Descrição

erroExecucao

Opcional

String

Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:


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

  • A mensagem do erro ocorrido no servidor.

Este artigo ajudou você?