ManterProdutoLC_Integração

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

Pré-requisitos

Connector Habilitado:

Exemplo 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 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:

Campos de retorno

Campo	Tipo	Formato	Descrição	Obrigatório?
Data	VarChar(8)	yyyyMMdd	Data da solicitação ex: 20200729	Sim
Hora	VarChar(6)	hhmmss	Hora da solicitação ex: 160055	Sim
CodigoSistemaSatelite	VarChar(10)		Cliente Solicita com time de Serviços Live	Sim
Chave	Guid		Chave de acesso Obtida no método ObterChaveAcesso	Sim
Numero	String	0AAMMDDHHMMSSMMM	Número do Ticket de entrada, ver detalhes no item "DICA 01" acima	Sim
Documentos	List		Objetos de Ticket(Documento) no formato da mensagem ver detalhes abaixo	Sim

Importante

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

Documentos (List)

Campos Produto	Tipo	Descrição/ Formato	Obrigatório
NumeroSequencia	Varchar(6)	Numero sequencia do documento implementar a cada documento. Ex: 1	Sim
Ativo	Boolean	Situação do produto.	Não
CNPJFornecedor	Varchar(20)	CNPJ do fornecedor do produto.	Não
CNPJFornecedorEscalaNaoRelevante	Varchar(20)	CNPJ do Fornecedor da escala não relevante Obrigatório caso o campo “EscalaNaoRelevante” esteja como “true*”.	*Não
Classificacoes	List	Lista dos classificadores do produto.	Não
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
CodigoItemServico	Varchar(4)	Código de item serviço do produto.	Não
CodigoPadrao	Varchar(20)	Código padrão do produto.	Sim
CodigoPrincipal	Varchar(18)	Código principal do Live.	Não
CodigoProdutoPorFornecedor	Varchar(20)	Código de produto por fornecedor.	Não
DescontoMaximo	Double	Desconto máximo do produto.	Não
DescontoVendaPromocao	Double	Desconto de venda em promoção do produto.	Não
Descricao	Varchar(200)	Descrição do produto.	Sim
DescricaoResumida	Varchar(50)	Descrição resumida do produto.	Sim
DescricaoTipoProduto	Varchar(50)	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
EscalaNaoRelevante	Boolean	Informa se o produto pertence a uma escala não relevante.	Não
IPPT	Varchar(1)	Código IPPT do produto.	Não
IndicadorArredondamento	Boolean	Indicador de arredondamento.	Não
InserirClassificacao	Boolean	Sinalizador de inclusão da classificação do produto.	Não
PesoBruto	Double	Peso bruto do produto.	Não
PesoLiquido	Double	Peso líquido do produto.	Não
PrecoCentralizado	Boolean	Sinalizador de preço centralizado.	Não
ProdutoFornecedores	List	Lista de produto fornecedor	Não
QuantidadeCasaDecimal	Int	Quantidade de casas decimais de quantidade do produto.	Não
QuantidadeCasaDecimalValor	Int	Quantidade de casas decimais de valor do produto.	Não
QuantidadeMultiplaCompra	Double	Quantidade 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
SituacaoVenda	Boolean	Ativa ou desativa o produto para venda	Não

Classificacoes

Tipo

Descrição / Formato

Obrigatório?

DescricaoClassificacao

String(50)

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

Deve estar cadastrado previamente.

Não

DescricaoTipoClassificacao

String(50)

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

Deve estar cadastrado previamente.

Não

ProdutoFornecedores	Tipo	Descrição / Formato	Obrigatório?
AceitaPedidoCompra	Boolean	Loja aceita pedido de compra	Não
CNPJ_CPF	Varchar(20)	CNPJ da loja.	Não
CodigoFornecedor	Varchar(10)	Código do fornecedor	Não
Consignado	Boolean	Permite venda consignada	Não
ProdutoFornecedorUnidadesMedida	List	Lista de Unidades Medidas do Produto fornecedor	Não
QuantidadeMultiplaCompra	Float	Quantidade de multiplicidade de compra do produto.	Não
QuantidadePacoteCaixa	Float	Quantidade de pacotes por caixa do produto.	Não
QuantidadeUnidadeCaixa	Float	Quantidade de unidades por caixa do produto.	Não

ProdutoFornecedorUnidadesMedida	Tipo	Descrição / Formato	Obrigatório?
FatorConversao	Double	Fator de conversão	Sim
SiglaUnidadeMedida	Varchar(10)	Sigla da unidade de medida	sim

Exemplo de Chamada do Método

Exemplo de chamada e retorno do método ManterClienteLC_Integracao

1 - Exemplo somente com campos obrigatórios:

Chamada 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:

Chamada:

<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>
				<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>
								<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>

Retorno:

<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:

Retorno Raw - Http Soap:

Atalhos

Árvore de páginas