English
Español
Web service Com.senior.g5.co.mcm.est.precomediomovimento
Este web service é responsável pelo envio das informações de preço médio de produtos na integração de sistema terceiros, possibilitando a consulta por diversos filtros, além de permitir a busca total de produtos, produtos que sofreram alterações em seu preço médio (por exemplo, fechamento de estoque), ou produtos que houveram movimentos de requisições.
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.
Campos 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
Exemplo:
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.
Campos 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
Exemplo:
- 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
- Síncrono: http://servidor:1234/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_est_precomediomovimento?wsdl
- Assíncrono: http://servidor:1234/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_est_precomediomovimento?wsdl
- Agendado: http://servidor:1234/g5-senior-services/sapiens_Schedulecom_senior_g5_co_mcm_est_precomediomovimento?wsdl
Em casos de erros neste web service, serão apresentadas mensagens nos seguintes formatos:
- Erro no item de Produto:
Serão exibidos “Produto:”, “Derivação:” e “Complemento:”, desde que informados. Além disso, será exibida a respectiva mensagem de erro. Na ausência de algum, a informação específica será suprimida. - Erro no item de Serviço:
Serão exibidos “Serviço” e “Complemento:”, desde que informados. Além disso a respectiva mensagem de erro. Na ausência de algum, a informação específica será suprimida.
Observação
- não é possível inserir requisição apenas por complemento, mas se houver a tentativa então será exibido o Complemento informado e a respectiva mensagem de erro;
- na tentativa de inserir um item sem nenhuma informação então será exibida apenas a mensagem de erro.
Porta
Exportar
Conforme os movimentos de estoque são integrados ao ERP e seu preços devidamente atualizados, o sistema gera pendências que são exportadas para GAtec através do web service em questão, seguindo os mesmos padrões de exportação dos demais web services..
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 1.
Versão atual: 1.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Exportar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<identificadorSistema>String</identificadorSistema>
<datIni>DateTime</datIni>
<datFim>DateTime</datFim>
<origem>String</origem>
<tipoIntegracao>String</tipoIntegracao>
<quantidadeRegistros>Integer</quantidadeRegistros>
<codPro>String</codPro>
<codDer>String</codDer>
<codDep>String</codDep>
<datMov>DateTime</datMov>
<seqMov>Integer</seqMov>
<numEme>Integer</numEme>
<seqEme>Integer</seqEme>
</parameters>
</ser:Exportar>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| parametrosEntrada | Set | |
| parametrosEntrada.codEmp | Integer | (Obrigatório) - Number(004) - Código da empresa |
| parametrosEntrada.codFil | Integer | (Obrigatório) - Number(004) - Código da filial |
| identificadorSistema | Integer | (Obrigatório) - Number(004) - Sigla do sistema integrado |
| parametrosEntrada.datIni | DateTime | (Opcional) - Date - Data Inicial para consulta (apenas para TipoIntegração = T-Todos) |
| parametrosEntrada.datFim | DateTime | (Opcional) - Date - Data Final para consulta (apenas para TipoIntegração = T-Todos) |
| parametrosEntrada.origem | String | (Obrigatório) - String(001) - Exportar Movimentos Originados: T - Todos, R - Requisição |
| parametrosEntrada.tipoIntegracao | String | (Obrigatório) - String(001) - Tipo de Integração - Lista: T = Todos, A = Somente Alterados, E = Registro Específico. Este campo só será considerado caso esteja com o valor igual a E - Registro Específico |
| parametrosEntrada.quantidadeRegistros | Integer | (Opcional) - Number(005) - Quantidade de Registros a serem exportados |
| parametrosEntrada.codPro | String | (Opcional) - String(014) - Código do Produto Movimentado. Este campo é habilitado quando o TipoIntegracao for igual a E - Registro Específico |
| parametrosEntrada.codDer | String | (Opcional) - String(007) - Código da Derivação do Produto Movimentado |
| parametrosEntrada.codDep | String | (Opcional) - String(010) - Código do Depósito Movimentado. Este campo é habilitado quando o TipoIntegracao for igual a E - Registro Específico. |
| parametrosEntrada.datMov | DateTime | (Opcional) - Date - Data do Movimento de Estoque. Este campo é habilitado quando o TipoIntegracao for igual a E - Registro Específico |
| parametrosEntrada.seqMov | Integer | (Opcional) - Date - Sequência do Movimento de Estoque. Este campo é habilitado quando o TipoIntegracao for igual a E - Registro Específico |
| numEme | Integer | (Opcional) - Number(009) - Número da requisição |
| seqEme | Integer | (Opcional) - Number(004) - Sequência da requisiçã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:ExportarResponse>
<result>
<erros>
<mensagemErro>String</mensagemErro>
</erros>
<tipoRetorno>Integer</tipoRetorno>
<movimentoEstoque>
<codEmp>Integer</codEmp>
<codPro>String</codPro>
<codDer>String</codDer>
<codDep>String</codDep>
<datMov>String</datMov>
<seqMov>Integer</seqMov>
<filDep>Integer</filDep>
<numEme>Integer</numEme>
<seqEme>Integer</seqEme>
<prmEst>String</prmEst>
<datFec>String</datFec>
<seqFec>Integer</seqFec>
<obsMvp>String</obsMvp>
</movimentoEstoque>
<mensagemRetorno>String</mensagemRetorno>
<finalizaramRegistros>String</finalizaramRegistros>
<numeroLote>Integer</numeroLote>
<erroExecucao>String</erroExecucao>
</result>
</ser:ExportarResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos da resposta:
| Nome | Tipo | Descrição |
|---|---|---|
| erros | 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" |
| erros.mensagemErro | String | (Opcional) - Itens da lista de erros. |
| tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação. |
| movimentoEstoque | Set | Lista de Preço Médio Movimento Estoque. |
| movimentoEstoque.codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa. |
| movimentoEstoque.codPro | String | (Opcional) - String(014) - Código do Produto Movimentado. |
| movimentoEstoque.codDer | String | (Opcional) - String(007) - Código da Derivação do Produto Movimentado. |
| movimentoEstoque.codDep | String | (Opcional) - String(010) - Código do Depósito Movimentado. |
| movimentoEstoque.datMov | String | (Opcional) - Date - Data do Movimento de Estoque. |
| movimentoEstoque.seqMov | Integer | (Opcional) - Date - Sequência do Movimento de Estoque. |
| movimentoEstoque.filDep | Integer | (Obrigatório) - Number(005) - Código da Filial de Depósito. |
| movimentoEstoque.numEme | Integer | Number(009) - Número do documento de entrada do movimento de estoque. |
| movimentoEstoque.seqEme | Integer | (Obrigatório) - Number(004) - Sequência do Poduto no Documento de Movimento de Estoque. |
| movimentoEstoque.prmEst | String | (Obrigatório) - Number(021,10) - Preço Médio do Estoque Total. |
| movimentoEstoque.datFec | String | (Obrigatório) - Date - Data de Fechamento do Estoque. |
| movimentoEstoque.seqFec | Integer | (Obrigatório) - Number(006) - Sequência base para o fechamento do Estoque. |
| movimentoEstoque.obsMvp | String | (Obrigatório) - String(250) - Observação do fechamento do Estoque. |
| mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento. |
| finalizaramRegistros | String | (Obrigatório) - String(001) - Indicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não. |
| numeroLote | Integer | (Obrigatório) - Inteiro - Identificação do Lote de Exportaçã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 sucesso" ou "a mensagem do erro ocorrido no servidor". |
English
Español
