Árvore de páginas

Versões comparadas

Chave

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

O método ManterProdutoLC_Integração do Live Connector tem a função incluir novos produtos de sistemas externos no live.


Compatibilidade
Ambiente SAAS
  •     

Ambiente OnPremise

  •     
Nota
titlePré-requisitos
  •  Connector Habilitado:
Informações
iconfalse
titleExemplo de Utilização:

Neste método recebemos como Payload uma lista de 1 ou mais produtos ficando a critério do integrador a quantidade de produtos por requisição, nossa recomendação é passar 1(um) por requisição para maior controle de cada lado da integração e facilitar a abertura de chamados para o Suporte dos sistemas. Para esta finalidade utiliza-se o campo "NumeroSequencia" para determinar o registro na lista ex: passar "1" para o primeiro elemento "2" para o segundo e implementar para cada elemento.


Como se trata de um método de entrada é obrigatório passar o numero do ticket(Campo Numero do XML) no formato que o Live Connector aceita conforme regra abaixo:

Dica
titleDICA 01: Formato do número do Ticket

O Número do Ticket do Live deverá ser uma string de 16 caracteres, composta pelo primeiro dígito um Zero(0) para ticket de entrada seguido do ano atual (dois dígitos), mês, dia, hora, minuto, segundo e milissegundos atuais.  

Exemplo de número para a data de criação igual “2019-12-11 14:05:46.677” 

Numero Ticket = 0191211140546677.


Exemplo de inclusão Via SoapUI:

Image RemovedImage Added



Informações
titleCampos de retorno
CampoTipoFormatoDescriçãoObrigatório?
DataVarChar(8)yyyyMMddData da solicitação ex: 20200729Sim
HoraVarChar(6)hhmmssHora da solicitação ex: 160055Sim
CodigoSistemaSateliteVarChar(10)
Cliente Solicita com time de Serviços LiveSim
ChaveGuid
Chave de acesso Obtida no método ObterChaveAcessoSim
NumeroString0AAMMDDHHMMSSMMMNúmero do Ticket de entrada, ver detalhes no item "DICA 01" acimaSim
DocumentosList
Objetos de Ticket(Documento) no formato da mensagem ver detalhes abaixoSim



Aviso
titleImportante

Os parâmetros devem ser passados na ordem apresentada abaixo.


Documentos (List)

Campos ProdutoTipoDescrição/ FormatoObrigatório
NumeroSequenciaVarchar(6)

Numero sequencia do documento implementar a cada documento.

Ex: 1

Sim
AtivoBooleanSituação do produto.Não
CNPJFornecedor

Varchar(20)

CNPJ do fornecedor do produto.Não
CNPJFornecedorEscalaNaoRelevante

Varchar(20)

DescricaoClassificacaoStringDescricaoTipoClassificacao

CNPJ do Fornecedor da escala não relevante

*Obrigatório caso o campo “EscalaNaoRelevante” esteja como “true”.

*Não
ClassificacoesList

Lista dos classificadores do produto.

Não
String
CodigoAlternativo

Varchar(20)

Código alternativo do produto.Sim
CodigoClassificacaoFiscal

Varchar(20)

Código da classificação fiscal do produto NCM (Nomenclatura Comum do Mercosul).

Ex: 96099000

Sim
CodigoPadrao
CodigoItemServicoVarchar(4)Código de item serviço do produto.Não
CodigoPadrao

Varchar(20)

Código padrão do produto.Sim
CodigoPrincipal

Varchar(

20)

18)

Código principal do Live.

Não
CodigoProdutoPorFornecedor

Varchar(20)

Código de produto por fornecedor.Não
DescontoMaximoDoubleDesconto máximo do produto.Não
DescontoVendaPromocaoDoubleDesconto de venda em promoção do produto.Não
Descricao

Varchar(200)

DescricaoResumida

Varchar(50)

DescricaoTipoProduto
Descrição do produto.Sim
DescricaoResumida

Varchar(50)

EscalaNaoRelevanteBooleanIPPT
Descrição resumida do produto.Sim
DescricaoTipoProduto

Varchar(

1

50)

IndicadorArredondamentoBooleanInserirClassificacaoBooleanPesoBrutoDoublePesoLiquidoDoublePrecoCentralizadoBooleanAceitaPedidoCompraBooleanCNPJ_CPF

Varchar(20)

CodigoFornecedor

Varchar(10)

ConsignadoBooleanPrincipalBooleanFatorConversaoDoubleSiglaUnidadeMedida

Varchar(10)

QuantidadeMultiplaCompraFloatQuantidadePacoteCaixaFloatQuantidadeUnidadeCaixaFloatQuantidadeCasaDecimalQuantidadeCasaDecimalValorQuantidadeMultiplaCompraSiglaUnidadeMedida

Varchar(10)

SituacaoTributariaOrigemSituacaoVendaBoolean

Descrição do Tipo de Produto.

Os valores podem variar de acordo com o cadastro realizado por cada usuário.


Os tipos mais comuns e que geralmente já estão cadastrados são:

Consumo
Revenda
Kit
Materia Prima
Produto Acabado
Servico


Os valores devem ser passados exatamente como no cadastro do sistema.

Sim
EscalaNaoRelevanteBooleanInforma se o produto pertence a uma escala não relevante.Não
IPPT

Varchar(1)

Código IPPT do produto.Não
IndicadorArredondamentoBooleanIndicador de arredondamento.Não
InserirClassificacaoBooleanSinalizador de inclusão da classificação do produto.Não
PesoBrutoDoublePeso bruto do produto.Não
PesoLiquidoDoublePeso líquido do produto.Não
PrecoCentralizadoBooleanSinalizador de preço centralizado.Não
ProdutoFornecedoresListLista de produto fornecedorNão
QuantidadeCasaDecimalIntQuantidade de casas decimais de quantidade do produto.Não
QuantidadeCasaDecimalValorIntQuantidade de casas decimais de valor do produto.Não
QuantidadeMultiplaCompraDoubleQuantidade de multiplicidade de compra do produto.Não
SiglaUnidadeMedida

Varchar(10)

Unidade de medida do produto.

Os valores podem variar de acordo com o cadastro realizado por cada usuário.


Os tipos mais comuns e que geralmente já estão cadastrados são:

UN

CX

PC

KG


Os valores devem ser passados exatamente como no cadastro do sistema.

Sim
SituacaoTributariaOrigem

Situação tributária do produto.


Conforme exemplos abaixo:

Nacional

EstrangeiraImportacaoDireta

EstrangeiraAdquiridaMercadoInterno

NacionalSupQuarentaPorCento

NacionalProdutivo

NacionalInfOuIgualQuarentaPorCento

EstrangeiraImpDiretaSemSimilar

EstrangeiraAdqMercadoIntSemSimilar

NacionalSupSetentaPorCento


O valor é case sensitive e deve ser passado exatamente como exemplo acima.

Não
SituacaoVendaBooleanAtiva ou desativa o produto para vendaNão

Classificacoes

Tipo

Descrição / FormatoObrigatório?
DescricaoClassificacaoString(50)

Descrição da classificação de produto.

Deve estar cadastrado previamente.

Não
DescricaoTipoClassificacaoString(50)

Descrição do tipo de classificador da classificação de produto.

Deve estar cadastrado previamente.

Não

ProdutoFornecedores

Tipo

Descrição / FormatoObrigatório?
AceitaPedidoCompraBooleanLoja aceita pedido de compraNão
CNPJ_CPF

Varchar(20)

CNPJ da loja.Não
CodigoFornecedor

Varchar(10)

Código do fornecedorNão
ConsignadoBooleanPermite venda consignadaNão
ProdutoFornecedorUnidadesMedidaListLista de Unidades Medidas do Produto fornecedorNão
QuantidadeMultiplaCompraFloatQuantidade de multiplicidade de compra do produto.Não
QuantidadePacoteCaixaFloatQuantidade de pacotes por caixa do produto.Não
QuantidadeUnidadeCaixaFloatQuantidade de unidades por caixa do produto.Não

ProdutoFornecedorUnidadesMedida

Tipo

Descrição / FormatoObrigatório?
FatorConversaoDoubleFator de conversãoSim
SiglaUnidadeMedida

Varchar(10)

Sigla da unidade de medidasim
Exemplo de Chamada do Método
Informações
titleExemplo de Chamada do Método

Exemplo de chamada e retorno do método ManterClienteLC_Integracao


1 - Exemplo somente  com campos obrigatórios:


Bloco de código
titleChamada para inclusão
<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"
    xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <soapenv:Header/>
    <soapenv:Body>
        <liv:ManterProdutoLC_Integracao>
            <liv:produto
                xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects"
                xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <ren1:Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</ren1:Chave>
                <ren1:CodigoSistemaSatelite>XXXXXXXXX</ren1:CodigoSistemaSatelite>
                <ren1:Data>20220124</ren1:Data>
                <ren1:Hora>100000</ren1:Hora>
                <ren1:Numero>0191205115556676</ren1:Numero>
                <ren1:Documentos
                    xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                    <b:anyType i:type="a:LC_Produto">
                        <a:NumeroSequencia>1</a:NumeroSequencia>
                        <a:Ativo>true</a:Ativo>
                        <a:CNPJFornecedor>07278350000163</a:CNPJFornecedor>
                        <a:CNPJFornecedorEscalaNaoRelevante>07278350000163</a:CNPJFornecedorEscalaNaoRelevante>
                        <a:Classificacoes>
                            <b:anyType i:type="a:LC_ClassificacaoProduto">
                                <a:DescricaoClassificacao>Produto</a:DescricaoClassificacao>
                                <a:DescricaoTipoClassificacao>MODELO</a:DescricaoTipoClassificacao>
                            </b:anyType>
                        </a:Classificacoes>
                        <a:CodigoAlternativo>999888011</a:CodigoAlternativo>
                        <a:CodigoClassificacaoFiscal>96099000</a:CodigoClassificacaoFiscal>
                        <a:CodigoItemServico/>
                        <a:CodigoPadrao>999888011</a:CodigoPadrao>
                        <a:CodigoPrincipal>999888011</a:CodigoPrincipal>
                        <a:CodigoProdutoPorFornecedor>999888011</a:CodigoProdutoPorFornecedor>
                        <a:DescontoMaximo>100</a:DescontoMaximo>
                        <a:DescontoVendaPromocao>100</a:DescontoVendaPromocao>
                        <a:Descricao>PRODUTO TESTE SOAP CONNECTOR </a:Descricao>
                        <a:DescricaoResumida>PRODUTO TESTE SOAP CONNECTOR </a:DescricaoResumida>
                        <a:DescricaoTipoProduto>REVENDA</a:DescricaoTipoProduto>
                        <a:EscalaNaoRelevante>true</a:EscalaNaoRelevante>
                        <a:IPPT>0</a:IPPT>
                        <a:IndicadorArredondamento>true</a:IndicadorArredondamento>
                        <a:InserirClassificacao>true</a:InserirClassificacao>
                        <a:PesoBruto>0</a:PesoBruto>
                        <a:PesoLiquido>0</a:PesoLiquido>
                        <a:PrecoCentralizado>true</a:PrecoCentralizado>
                        <a:ProdutoFornecedores>
                            <b:anyType i:type="a:LC_ProdutoFornecedor">
                                <a:AceitaPedidoCompra>true</a:AceitaPedidoCompra>
                                <a:CNPJ_CPF>07278350000163</a:CNPJ_CPF>
                                <a:CodigoFornecedor>2</a:CodigoFornecedor>
                                <a:Consignado>true</a:Consignado>
                                <a:Principal>false</a:Principal>
                                <a:ProdutoFornecedorUnidadesMedida>
                                    <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida">
                                        <a:FatorConversao>1.10</a:FatorConversao>
                                        <a:SiglaUnidadeMedida>PC</a:SiglaUnidadeMedida>
                                    </b:anyType>
                                    <b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida">
                                        <a:FatorConversao>1.20</a:FatorConversao>
                                        <a:SiglaUnidadeMedida>CX</a:SiglaUnidadeMedida>
                                    </b:anyType>
                                </a:ProdutoFornecedorUnidadesMedida>
                                <a:QuantidadeMultiplaCompra>10.20</a:QuantidadeMultiplaCompra>
                                <a:QuantidadePacoteCaixa>10.20</a:QuantidadePacoteCaixa>
                                <a:QuantidadeUnidadeCaixa>10.20</a:QuantidadeUnidadeCaixa>
                                <a:TemTaxaServico>true</a:TemTaxaServico>
                            </b:anyType>
                        </a:ProdutoFornecedores>
                        <a:QuantidadeCasaDecimal>2</a:QuantidadeCasaDecimal>
                        <a:QuantidadeCasaDecimalValor>2</a:QuantidadeCasaDecimalValor>
                        <a:QuantidadeMultiplaCompra>2</a:QuantidadeMultiplaCompra>
                        <a:SiglaUnidadeMedida>UN</a:SiglaUnidadeMedida>
                        <a:SituacaoTributariaOrigem>Nacional</a:SituacaoTributariaOrigem>
                        <a:SituacaoVenda>true</a:SituacaoVenda>
                    </b:anyType>
                </ren1:Documentos>
            </liv:produto>
        </liv:ManterProdutoLC_Integracao>
    </soapenv:Body>
</soapenv:Envelope>


2 - Exemplo com demais campos:

Informações
title

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" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   	<soapenv:Header/>
   	<soapenv:Body>
      		<liv:ManterProdutoLC_Integracao>
         			<liv:produto xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            				<ren:ClassID>?</ren:ClassID>
            				<ren:Creation>2019-11-28T00:00:00</ren:Creation>
            				<ren:LastUpdate>2019-11-28T00:00:00</ren:LastUpdate>
            				<ren1:Chave>ec6e631b-9f93-4076-96da-a30e97423b6e</ren1:Chave>
            				<ren1:CodigoSistemaSatelite>2200002661</ren1:CodigoSistemaSatelite>
            				<ren1:Data>20191127</ren1:Data>
            				<ren1:Hora>120000</ren1:Hora>
            Hora>
				<ren1:Numero>0191205115556676</ren1:Numero>
            				<ren1:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
					<b:anyType i:type="a:LC_Produto">
     						<a:NumeroSequencia>1</a:NumeroSequencia>
						<a:Ativo>true</a:Ativo>
     						<a:CNPJFornecedor>07278350000163</a:CNPJFornecedor>
 						<a:CNPJFornecedorEscalaNaoRelevante>07278350000163</a:CNPJFornecedorEscalaNaoRelevante>
     						<a:Classificacoes>
        							<b:anyType i:type="a:LC_ClassificacaoProduto">
            								<a:DescricaoClassificacao>Royal canin</a:DescricaoClassificacao>
:DescricaoClassificacao>
								<a:DescricaoTipoClassificacao>MODELO</a:DescricaoTipoClassificacao>
       							</b:anyType>
     						</a:Classificacoes>
     						<a:CodigoAlternativo>999888011</a:CodigoAlternativo>
     						<a:CodigoClassificacaoFiscal>96099000</a:CodigoClassificacaoFiscal>
     						<a:CodigoItemServico/>
     						<a:CodigoPadrao>999888011</a:CodigoPadrao>
     						<a:CodigoPrincipal>999888011</a:CodigoPrincipal>
     						<a:CodigoProdutoPorFornecedor>999888011</a:CodigoProdutoPorFornecedor>
     						<a:DescontoMaximo>100</a:DescontoMaximo>
     						<a:DescontoVendaPromocao>100</a:DescontoVendaPromocao>
     						<a:Descricao>PRODUTO TESTE SOAP CONNECTOR </a:Descricao>
     						<a:DescricaoResumida>PRODUTO TESTE SOAP CONNECTOR </a:DescricaoResumida>
     						<a:DescricaoTipoProduto>REVENDA</a:DescricaoTipoProduto>
 						<a:EscalaNaoRelevante>true</a:EscalaNaoRelevante>
               						<a:IPPT>0</a:IPPT>
     						<a:IndicadorArredondamento>true</a:IndicadorArredondamento>
     						<a:InserirClassificacao>true</a:InserirClassificacao>
						<a:PesoBruto>0</a:PesoBruto>
     						<a:PesoLiquido>0</a:PesoLiquido>
     						<a:PrecoCentralizado>true</a:PrecoCentralizado>
     						<a:ProdutoFornecedores>
       							<b:anyType i:type="a:LC_ProdutoFornecedor">
        								<a:AceitaPedidoCompra>true</a:AceitaPedidoCompra>
        								<a:CNPJ_CPF>07278350000163</a:CNPJ_CPF>
        								<a:CodigoFornecedor>2</a:CodigoFornecedor>
CodigoFornecedor>
								<a:Consignado>true</a:Consignado>
								<a:Principal>false</a:Principal>
        								<a:ProdutoFornecedorUnidadesMedida>
									<b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida">
                										<a:FatorConversao>1.10</a:FatorConversao>
                										<a:SiglaUnidadeMedida>PC</a:SiglaUnidadeMedida>
              									</b:anyType>
              									<b:anyType i:type="a:LC_ProdutoFornecedorUnidadeMedida">
                										<a:FatorConversao>1.20</a:FatorConversao>
                										<a:SiglaUnidadeMedida>CX</a:SiglaUnidadeMedida>
              									</b:anyType>
              								</a:ProdutoFornecedorUnidadesMedida>
								<a:QuantidadeMultiplaCompra>10.20</a:QuantidadeMultiplaCompra>
QuantidadeMultiplaCompra>
								<a:QuantidadePacoteCaixa>10.20</a:QuantidadePacoteCaixa>
								<a:QuantidadeUnidadeCaixa>10.20</a:QuantidadeUnidadeCaixa>
								<a:TemTaxaServico>true</a:TemTaxaServico>
          							</b:anyType>
          						</a:ProdutoFornecedores>
     						<a:QuantidadeCasaDecimal>2</a:QuantidadeCasaDecimal>
     						<a:QuantidadeCasaDecimalValor>2</a:QuantidadeCasaDecimalValor>
     						<a:QuantidadeMultiplaCompra>2</a:QuantidadeMultiplaCompra>
     						<a:SiglaUnidadeMedida>UN</a:SiglaUnidadeMedida>
     						<a:SituacaoTributariaOrigem>Nacional</a:SituacaoTributariaOrigem>
     						<a:SituacaoVenda>true</a:SituacaoVenda>

					</b:anyType>
            				</ren1:Documentos>
         			</liv:produto>
      		</liv:ManterProdutoLC_Integracao>
   	</soapenv:Body>
</soapenv:Envelope>


Retorno:

Bloco de código
titleRetorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterProdutoLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterProdutoLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterProdutoLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>


Retorno xml - Soap:

Image Added



Retorno Raw - Http Soap:

Image Added