TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 22

changes.mady.by.user Raphael Gomes Cristino

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Francini Monteiro Carlomagno

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
iconfalse

O método RecuperarSaldoEstoqueLC_Integracao do Live Connector tem a função de disponibilizar informações do Saldo Estoque dos Produtos por Loja.

Quando o método for consumido solicitando o retorno de todos os produtos (TodosProdutos = true) não haverá limite máximo de retorno de itens.

Quando o método for consumido sem solicitar o retorno de todos os produtos (TodosProdutos = false) haverá limite máximo de retorno de itens, conforme descrito na especificação do campo "QuantidadeResultado". Caso os dados que serão retornados excedam o limite máximo de retorno, o ticket retornado deverá ser consumido e confirmado. A próxima requisição irá retornar os dados de estoque a partir do último registro consumido.


Compatibilidade
Ambiente SAAS
  •     

Ambiente OnPremise

  •     
Informações
iconfalse
titleExemplo de Utilização:

Exemplo de consumo Via SoapUI:



Informações
titleParâmetros de Entrada

ENTRADA

Descrição
Campo
Tipo
(Tamanho)
ChaveObrigatório
Permite AlteraçãoPermite ExclusãoInformação Negocial
Descrição
Chavevarchar(16)SimSimNão se AplicaNão se AplicaChave de acesso
gerado conforme exemplo: Como Obter uma chave de acesso válida.
do Sistema Satélite
CodigoSistemaSatelitevarchar(20)Sim
Para obter um Sistema Satélite é necessário entrar em contato nos canais TOTVS de atendimento.
SimNão se AplicaNão se AplicaCódigo do Sistema Sátelite
IdentificacaoLojaVarchar(20)NãoSim
É o Local do estoque que deseja retorno das informações (Esse código pode ser obtido nas seguintes mensagens RecuperarLojasLC_Integracao ou RecuperarUnidadesDeNegocioLC_Integracao)
SimNão se AplicaNúmero de série da loja
EstoquePositivoBooleanNão
Caso
NãoSimNão se AplicaCaso informado verdadeiro(True) serão retornados apenas os produtos com estoque maior que zero.
TodosProdutosBooleanNãoNãoSimNão se AplicaCaso informado verdadeiro (true) serão retornados todos os produtos mesmo que não tenham registro na tabela de estoque, caso passe Falso(False) ou não passe serão retornados apenas produtos com movimentação na tabela de estoque.
QuantidadeResultadoIntNãoNãoSimNão se AplicaLimita a quantidade de resultados
na pesquisa
no retorno
Caso não seja especificado nenhum valor, a quantidade padrão de retorno são de 100 itens.
A quantidade de retorno máxima são de 5000 itens.
Este campo é desconsiderado quando o filtro todos os produtos for verdadeiro (true).
ListaProdutoListNãoNãoNão se AplicaNão se AplicaDefine os produtos que serão retornados, caso não informado(Padrão) serão retornados os produto com movimentação de estoque.
NumeroTicketvarchar(16)NãoNãoNão se AplicaNão se AplicaNúmero do Ticket para Retorno


ListaProduto

DescriçãoTipoChaveObrigatórioPermite AlteraçãoPermite ExclusãoInformação Negocial
NumeroSequenciavarchar(16)NãoSimNão se aplicaNão se aplicaSequência número dos objetos retornados no ticket
CodigoLojavarchar(9)SimSimNãoNãoNúmero de série da loja que será retornado o estoque
CodigoProdutovarchar(20)SimSimNãoNãoCódigo padrão de identificação do produto
List<LocalEstoqueProduto>
Informações
titleCampos de retorno

RETORNO

DescriçãoTipoChaveObrigatórioPermite AlteraçãoPermite ExclusãoInformação Negocial
Chavevarchar(16)SimSimNão se AplicaNão se AplicaChave de acesso do Sistema Satélite
CodigoSistemaSatelitevarchar(20)SimSimNão se AplicaNão se AplicaCódigo do Sistema Satélite
NumeroTicketvarchar(16)NãoNãoNão se AplicaNão se AplicaNúmero do Ticket para Retorno
NumeroSequenciavarchar(16)NãoSimNão se aplicaNão se aplicaSequência número dos objetos retornados no ticket
CodigoLojavarchar(9)NãoSimNãoNãoNúmero de série da loja que será retornado o estoque
CodigoProdutovarchar(20)SimSimNãoNãoCódigo padrão de identificação do produto
DescricaoProdutovarchar(200)NãoSimNãoNãoDescrição do produto
LocalEstoqueProdutoListNãoNãoSimNãoLista de localidade de estoque
PosicaoAtualEstoquefloatNãoSimSimSimSaldo atual do estoque do produto da sequência
PrecoProdutofloatNãoNãoSimSimPreço atual do produto da sequência
UltimoCustoMediofloatNãoNãoSimSimÚltimo custo médio do produto da sequência


LocalEstoqueProduto

DescriçãoTipoChaveObrigatórioPermite AlteraçãoPermite ExclusãoInformação Negocial
CodigoIntSimSimNãoNãoCódigo da Localidade do estoque
LocalidadeEstoquevarchar(20)NãoSimSimNãoNome da localidade de estoque
PosicaoAtualIntNãoSimSimNãoSaldo atual de estoque do produto dentro a localidade específica
Informações
titleCampos de retorno
CampoTipo
NumeroSequenciavarchar(6)
CodigoLojavarchar(9)
CodigoProdutovarchar(20)
DescricaoProdutovarchar(200)
PosicaoAtualEstoquefloat
PrecoProdutofloat
UltimoCustoMediofloat
LocalEstoqueProduto
Informações
titleExemplo de Chamada do Método
Bloco de código
titleChamada:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/" xmlns:ren="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data" xmlns:ren1="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects">
  <soapenv:Header/>
  <soapenv:Body>
     <liv:RecuperarSaldoEstoqueLC_Integracao>
        <liv:identificacao>
           <ren1:Chave>00000000-0000-0000-0000-000000000000</ren1:Chave>
           <ren1:CodigoSistemaSatelite>XXXXXXXXX</ren1:CodigoSistemaSatelite>            
        </liv:identificacao>
        <liv:identificacaoLoja>XXXXXXXXX</liv:identificacaoLoja>
        <liv:quantidadeResultado>10</liv:quantidadeResultado>
        <liv:estoquePositivo>1</liv:estoquePositivo>
        <liv:todosProdutos>0</liv:todosProdutos>
     </liv:RecuperarSaldoEstoqueLC_Integracao>
  </soapenv:Body>
</soapenv:Envelope>
Bloco de código
titleRetorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <RecuperarSaldoEstoqueLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <RecuperarSaldoEstoqueLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_TicketMovimentoEstoque</ClassID>
            <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-04-03T15:01:18.4516523-03:00</Creation>
            <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-04-03T15:01:18.4516523-03:00</LastUpdate>
            <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID>
            <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID>
            <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID>
            <a:Chave>00000000-0000-0000-0000-000000000000</a:Chave>
            <a:CodigoSistemaSatelite>XXXXXXXXXX</a:CodigoSistemaSatelite>
            <a:Data>03/04/2020</a:Data>
            <a:Hora>15:01</a:Hora>
            <a:Numero>1200403150118480</a:Numero>
            <a:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
               <b:anyType i:type="a:LC_ProdutoEstoque">
                  <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_ProdutoEstoque</ClassID>
                  <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-04-03T15:01:21.0298014-03:00</Creation>
                  <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-04-03T15:01:21.0298014-03:00</LastUpdate>
                  <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID>
                  <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID>
                  <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID>
                  <a:NumeroSequencia i:nil="true"/>
                  <a:CodigoLoja>XXXXXXXXX</a:CodigoLoja>
                  <a:CodigoProduto>XXXXXXXX</a:CodigoProduto>
                  <a:DescricaoProduto>XXXXX - XXXXXXXXXXXXXXXX</a:DescricaoProduto>
				  <a:LocalEstoqueProduto>
                     <a:LC_LocalEstoqueProduto>
                        <a:Codigo>0</a:Codigo>
                        <a:LocalidadeEstoque>Padrão</a:LocalidadeEstoque>
                        <a:PosicaoAtual>XX</a:PosicaoAtual>
                     </a:LC_LocalEstoqueProduto>
                     <a:LC_LocalEstoqueProduto>
                        <a:Codigo>2</a:Codigo>
                        <a:LocalidadeEstoque>Avaria</a:LocalidadeEstoque>
                        <a:PosicaoAtual>XX</a:PosicaoAtual>
                     </a:LC_LocalEstoqueProduto>
                  </a:LocalEstoqueProduto>
                  <a:PosicaoAtualEstoque>XX</a:PosicaoAtualEstoque>
                  <a:PrecoProduto>X</a:PrecoProduto>
                  <a:UltimoCustoMedio>X</a:UltimoCustoMedio>
               </b:anyType>
            </a:Documentos>
         </RecuperarSaldoEstoqueLC_IntegracaoResult>
      </RecuperarSaldoEstoqueLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>
Bloco de código
titleChamada: XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
   <soapenv:Header/>
   <soapenv:Body>
      <liv:RecuperarSaldoEstoqueLC_Integracao_Xml>
         <liv:codigoSistemaSatelite>220000343</liv:codigoSistemaSatelite>
         <liv:xmlIdentificacao><![CDATA[<?xml version="1.0"?><LC_Identificacao><QuantidadeResultado>100</QuantidadeResultado><IdentificacaoLoja>112021639</IdentificacaoLoja><Chave>d59b19b1-3c90-48f1-b20a-d284dcbfe206</Chave><CodigoSistemaSatelite>220000343</CodigoSistemaSatelite></LC_Identificacao>]]>
		 </liv:xmlIdentificacao>
      </liv:RecuperarSaldoEstoqueLC_Integracao_Xml>
   </soapenv:Body>
</soapenv:Envelope>
Bloco de código
titleRetorno: XML
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <RecuperarSaldoEstoqueLC_Integracao_XmlResponse xmlns="http://LiveConnector/">
         <RecuperarSaldoEstoqueLC_Integracao_XmlResult><![CDATA[<LC_TicketMovimentoEstoque>
  <Creation>2020-08-04T09:23:38.4057484-03:00</Creation>
  <LastUpdate>2020-08-04T09:23:38.4057484-03:00</LastUpdate>
  <Data>04/08/2020</Data>
  <Hora>09:23</Hora>
  <CodigoSistemaSatelite>99999999</CodigoSistemaSatelite>
  <Chave>00000000-0000-0000-0000-000000000000</Chave>
  <Numero>9999999999999999</Numero>
  <Documentos>
    <LC_ProdutoEstoque>
      <Creation>2020-08-04T09:23:38.5776577-03:00</Creation>
      <LastUpdate>2020-08-04T09:23:38.5776577-03:00</LastUpdate>
      <CodigoProduto>33333</CodigoProduto>
      <DescricaoProduto>BRINQUEDO DE PELUCIA PORQUINHO</DescricaoProduto>
      <PosicaoAtualEstoque>-8</PosicaoAtualEstoque>
      <PrecoProduto>0</PrecoProduto>
      <CodigoLoja>222222222</CodigoLoja>
      <UltimoCustoMedio>9.48733333333333</UltimoCustoMedio>'
    </LC_ProdutoEstoque>
    <LC_ProdutoEstoque>
      <Creation>2020-08-04T09:23:38.5776577-03:00</Creation>
      <LastUpdate>2020-08-04T09:23:38.5776577-03:00</LastUpdate>
      <CodigoProduto>105</CodigoProduto>
      <DescricaoProduto>ABSORVENTE HIGIENICO PP</DescricaoProduto>
      <PosicaoAtualEstoque>0</PosicaoAtualEstoque>
      <PrecoProduto>0</PrecoProduto>
      <CodigoLoja>222222222</CodigoLoja>
      <UltimoCustoMedio>3.7</UltimoCustoMedio>
    </LC_ProdutoEstoque>
    <LC_ProdutoEstoque>
      <Creation>2020-08-04T09:23:38.5776577-03:00</Creation>
      <LastUpdate>2020-08-04T09:23:38.5776577-03:00</LastUpdate>
      <CodigoProduto>103</CodigoProduto>
      <DescricaoProduto>ABSORVENTE HIGIENICO M</DescricaoProduto>
      <PosicaoAtualEstoque>0</PosicaoAtualEstoque>
      <PrecoProduto>0</PrecoProduto>
      <CodigoLoja>222222222</CodigoLoja>
      <UltimoCustoMedio>3.9</UltimoCustoMedio>
    </LC_ProdutoEstoque>
  </Documentos>
</LC_TicketMovimentoEstoque>]]></RecuperarSaldoEstoqueLC_Integracao_XmlResult>
      </RecuperarSaldoEstoqueLC_Integracao_XmlResponse>
   </s:Body>
</s:Envelope>

...