PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial PME | GO UP - versão 5.10.3 (XTended)
No conteúdo deste manual são citados Identificadores de Regras, porém, no GO UP não é possível incluir, excluir ou alterar identificadores e suas regras associadas, pois o sistema possui funções nativas devido aos processos de negócio pré-definidos.
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.cad.cidades

Web service Com.senior.g5.co.cad.cidades

Este web service permite exportar o cadastro de cidades da tabela Cidades para RAIS - SIG (E008RAI).

Para seu correto funcionamento, é necessário possuir um sistema integrado cadastrado e ativo na tela Cadastro de Sistemas Integrados (F000SIS), e ativar o tipo de informação Cidade na tela Configuração de Tipos de Informação (F000SXT) para o sistema integrado.

O web service também possui o modo consulta, e para este é necessário informar o parâmetro Cidade. Este campo permite informar somente o Código RAI da cidade, a pesquisa não é realizada pelo nome.

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 identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.

Campos numéricos

Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.

ClosedCampos que representam valores monetários, quantidade e percentual e estão declarados como String
  • Envio no formato ZZZZ,ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com vírgula, e não com ponto
  • Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
ClosedExemplo:

number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;

number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;

number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

ClosedCampos que representam valores monetários, quantidade e percentual e não estão declarados como String
  • Envio no formato ZZZZ.ZZ
  • É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
  • Obrigatória a utilização do separador decimal com ponto, e não com vírgula
ClosedExemplo:
  • number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
  • number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
  • number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.

WSDL

Porta

ClosedExportar
Exportar

Exportar o cadastro de cidades da tabela E008RAI.

Necessita autenticação: Sim.

Situação da versão:Atual.

Versão: 1.

ClosedRequisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
	<ser:Exportar>
	  <user>String</user>
	  <password>String</password>
	  <encryption>Integer</encryption>
	  <parameters>
		<codEmp>Integer</codEmp>
		<consulta>
		  <cidade>String</cidade>
		</consulta>
		<codFil>Integer</codFil>
		<tipoIntegracao>String</tipoIntegracao>
		<quantidadeRegistros>Integer</quantidadeRegistros>
		<identificacaoSistema>String</identificacaoSistema>
	  </parameters>
	</ser:Exportar>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
NomePreenchimentoTipoDescrição
codEmpObrigatórioIntegerCódigo da Empresa.
consulta    
consulta.cidadeOpcionalStringConsulta a Cidade.
codFilObrigatórioInteger Código da Filial.
tipoIntegracaoObrigatórioStringTipo de Integração - Lista: T= Todos, A= Somente Alterados, E= Registro Específico.
quantidadeRegistrosOpcionalIntegerQuantidade de registros limite para retorno da solicitação. Quando o tipo de integração for "E", este valor não é utilizado.
identificacaoSistemaObrigatórioString Identificação do sistema integrado.
ClosedResposta:

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:ExportarResponse>
	  <result>
		<cidade>
		  <codRai>Integer</codRai>
		  <nomCid>String</nomCid>
		  <sigUfs>String</sigUfs>
		  <locGeo>String</locGeo>
		  <numFeb>String</numFeb>
		  <seqInt>Integer</seqInt>
		</cidade>
		<gridErros>
		  <msgErr>String</msgErr>
		</gridErros>
		<finalizaramRegistros>String</finalizaramRegistros>
		<tipoRetorno>Integer</tipoRetorno>
		<mensagemRetorno>String</mensagemRetorno>
		<numeroLote>Integer</numeroLote>
		<erroExecucao>String</erroExecucao>
	  </result>
	</ser:ExportarResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
NomePreenchimentoTipoDescrição
cidade   
cidade.codRaiOpcionalIntegerRetorno do código RAI da cidade.
cidade.nomCid OpcionalStringNome da cidade.
cidade.sigUfsOpcionalStringSigla do Estado.
cidade.locGeo OpcionalStringCódigo localização geográfica.
cidade.numFeb OpcionalStringCódigo do município para o Febraban.
cidade.seqIntOpcionalIntegerCódigo sequencial do registro.
gridErrosOpcionalSetLista dos erros.
gridErros.msgErrOpcionalStringErros.
finalizaramRegistrosOpcionalStringIndicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não.
tipoRetornoOpcionalIntegerTipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação.
mensagemRetornoOpcionalStringMensagem de Retorno de Processamento.
numeroLoteObrigatórioIntegerIdentificação do Lote de Exportação.
erroExecucaoOpcionalStringIndica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores: - Vazio ou nulo, indicando que a execução foi feita com sucesso; - A mensagem do erro ocorrido no servidor.

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

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

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

Ver site completo