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.int.varejo.pessoas

Web service Com.senior.g5.co.int.varejo.pessoas

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

ClosedConsultarCliente
ClosedRequisição:
ClosedParâmetros da requisição:
Nome Tipo Descrição
codEmp Integer (Obrigatório) - Number(004) - Código da Empresa
codFil Integer (Obrigatório) - Number(005) - Código da Filial
codCli Integer (Obrigatório) - Number(009) - Código do Cliente
ClosedResposta:
ClosedAtributos da resposta:
Nome Tipo Descrição
erroExecucao 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 sucessoA mensagem do erro ocorrido no servidorSó impede a gravação quando o retorno.tipRet for igual a "2"
salDup String (Obrigatório) - Number(15,2) - Saldo devedor de duplicatas do cliente
salOut String (Obrigatório) - Number(15,2) - Saldo devedor de outros títulos do cliente
salCre String (Obrigatório) - Number(15,2) - Saldo de créditos do cliente
tipoRetorno Integer (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação
mensagemRetorno String (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento
datLim String (Obrigatório) - Date (DD/MM/AAAA) - Data da última atualização do limite de crédito
vlrLim String (Obrigatório) - Number(15,2) - Valor do limite de crédito do cliente
creDis String (Obrigatório) - Number(15,2) - Valor do crédito disponível para o cliente no momento da consulta
limApr String (Opcional) - String(001) - Indica se o limite de crédito está aprovado - Lista: S = Sim, N = Não
creBlo String (Obrigatório) - String(001) - Indica se o crédito disponível para o cliente está bloqueado - Lista: S=Sim, N=Não
motBlo String (Obrigatório) - String(250) - Descreve por extenso se o crédito do cliente está liberado ou se está bloqueado e expõe o motivo
ClosedConsultar

Gestão Empresarial | ERP - Integrações - Varejo - Pessoas - Consultar Cliente

Necessita autenticação: Sim

Situação de 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:Consultar>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <CodCli>Integer</CodCli>
        <TpqCli>Integer</TpqCli>
        <SistemaIntegracao>String</SistemaIntegracao>
        <CodCli>Integer</CodCli>
        <TpqCli>Integer</TpqCli>
        <NomPes>String</NomPes>
        <TpqNom>Integer</TpqNom>
        <EndPes>String</EndPes>
        <TpqEnd>Integer</TpqEnd>
        <NenPes>String</NenPes>
        <TpqNen>Integer</TpqNen>
        <UfsPes>String</UfsPes>
        <TpqUfs>Integer</TpqUfs>
        <CidPes>String</CidPes>
        <TpqCid>Integer</TpqCid>
        <NomMae>String</NomMae>
        <TpqMae>Integer</TpqMae>
        <NomPai>String</NomPai>
        <TpqPai>Integer</TpqPai>
        <CgcCpf>Double</CgcCpf>
        <TpqCgc>Integer</TpqCgc>
      </parameters>
    </ser:Consultar>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Tipo Descrição
CodCli Integer ( Opcional) - Código do Cliente
TpqCli Integer ( Opcional) - Tipo de filtro aplicado ao campo CodCli 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
SistemaIntegracao String (Opcional) - Sigla do sistema integrado
CodFor Integer (Opcional) - Código do Fornecedor
TpqFor Integer (Opcional) - Tipo de filtro aplicado ao campo CodFor 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
NomPes String (Opcional) - Nome do cliente ou do fornecedor
TpqNom Integer (Opcional) - Tipo de filtro aplicado ao campo NomPes 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
EndPes String (Opcional) - Endereço do cliente ou do fornecedor
TpqEnd Integer (Opcional) - Tipo de filtro aplicado ao campo EndPes 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
NenPes String (Opcional) - Número do endereço do cliente ou do fornecedor
TpqNen Integer (Opcional) - Tipo de filtro aplicado ao campo NenPes 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
UfsPes String (Opcional) - Sigla do estado do cliente ou fornecedor
TpqUfs Integer (Opcional) - Tipo de filtro aplicado ao campo UfsPes 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
CidPes String (Opcional) - Opcional | Cidade do cliente ou do fornecedor
TpqCid Integer (Opcional) - Tipo de filtro aplicado ao campo CidPes 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
NomMae String (Opcional) - Nome da mãe do cliente
TpqMae Integer (Opcional) - Tipo de filtro aplicado ao campo NomMae 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
NomPai String (Opcional) - Nome do pai do cliente
TpqPai Integer (Opcional) - Tipo de filtro aplicado ao campo NomPai 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
CgcCpf Double (Opcional) - Número do CNPJ ou CPF do cliente ou do fornecedor
TpqCgc Integer (Opcional) - Tipo de filtro aplicado ao campo CgcCpf 0 - Não filtrar, 1 - Igual a, 2 - Diferente de, 3 - Que contenha, 4 - Que não contenha, 5 - Que comece com, 6 - Que termine com
TpqCgc Integer (Opcional) - Tipo de pessoa que será filtrada. 1 - Cliente, 2 - Fornecedor
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:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarResponse>
      <result>
        <TipoRetorno>Integer</TipoRetorno>
        <Pessoa>
          <CodPes>Integer</CodPes>
          <CgcCpf>Double</CgcCpf>
          <NomPes>String</NomPes>
          <EndPes>String</EndPes>
          <NenPes>String</NenPes>
          <UfsPes>String</UfsPes>
          <CidPes>String</CidPes>
          <CodIbg>String</CodIbg>
        </Pessoa>
        <MensagemRetorno>String</MensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
Nome Tipo Descrição
TipoRetorno Integer (Opcional) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação
Pessoa Set (Opcional) - Conjunto de clientes e fornecedores encontrado
Pessoa.CodPes Integer (Opcional) - Código do cliente ou do fornecedor
Pessoa.TipCgc Integer (Opcional) - Tipo de pessoa. Lista: F - Física, J - Jurídica
Pessoa.CgcCpf String (Opcional) - Número do CNPJ ou CPF do cliente ou do fornecedor
Pessoa.NomPes String (Opcional) - Nome do cliente ou do fornecedor
Pessoa.EndPes Integer (Opcional) - Endereço do cliente ou do fornecedor
Pessoa.NenPes DateTime (Opcional) - Número do endereço do cliente ou do fornecedor
Pessoa.UfsPes Double (Opcional) - Sigla do estado do cliente ou do fornecedor
Pessoa.CidPes Integer (Opcional) - Nome da cidade do cliente ou do fornecedor
Pessoa.CodIbg String (Opcional) - Código da cidade conforme a tabela do IBGE
MensagemRetorno Integer (Opcional) - Mensagem de Retorno de Processamento
erroExecucao String (Opcional) - 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ê?

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