Histórico da Página

Informações

icon	false

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

Compatibilidade
Ambiente SAAS
Ambiente OnPremise

Nota

title	Pré-requisitos

Habilitar parâmetros do Connector para recuperar forma de pagamento:

Parâmetro = 108 | LiveConnector - Fornecedor (1 = SIM | 0 = NAO)

Parâmetro Unidade de Negócio = 94 | LiveConnector - Fornecedor (1 = SIM | 0 = NAO)

Informações

icon	false
title	Exemplo de Utilização:

Exemplo de

Utilização:

1 - No Live cadastro Preço. (Live\Global\Tabela de Preços\Filtrar)

Image Removed

2 - Para validar os preços dos produtos cadastrados clicar no caminho (Opções \ Consultar Manutenção de Preços \ Filtrar )

Image Removed

Exemplo de consumo Via SoapUI:

Image Removed

consumo Via Postman:

ManterFornecedorLC_Integracao

Image Added

ManterFornecedorLC_Integracao_Xml

Image Added

Consulta dos dados enviados ao Practico Live, em Global > Fornecedor:

Image Added

Informações

title	Parâmetros de Entrada

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

Informações

title	Parâmetros de Entrada - Documentos

Pivot Table

id	1581521954499_556941873

ListaDocumentosCliente

Tipo

Descrição / Formato

Obrigatório?

Observação

Identificacao

Varchar(50)

Identificação de documento do fornecedor.

Sim

TipoDocumentoCliente

Varchar(20)

Tipo do Documento do Cliente aceitos:

CNPJ, IE, IM

O valor é case sensitive e deve ser passado

exatamente como exemplo acima.

Sim

Método ManterFornecedorLC_Integracao_Xml

utiliza o tipo Int.

0 - CNPJ

1 - IE

3 - IM

Informações

title	Parâmetros de Entrada - Endereços

Informações

title	Campos de retorno

Pivot Table

id	1581521954499_556941873

Dodumentos

Tipo

NumeroSequencia

Codigo

Descricao

DiasEncargo

Inativo

Boolean

Itens

PercentualEncargoEmbutido

PrecoCentralizado

PrecoDeCompra

QTDItens

Regiao

UnidadesNegocio

VigenciaPadrao

Datetime

Ite

Apagar

CodigoProduto

DescricaoProduto

IDProduto

InicioVigencia

Datetime

NaoConsistirVigencia

Observacao

Valor

UnidadesNegocio

CNPJUnidadeNegocio

NumeroLojaUnidadeNegocio

ListaEnderecos	Tipo	Descrição/ Formato	Obrigatório?	Observação
Bairro	Varchar(50)	Bairro do endereço do cliente. Caso ultrapassar o tamanho máximo o valor será truncado.	Sim
CEP	Varchar(10)	CEP do endereço do cliente. Formato aceito: 02511000 02511-000 02511.000 Caso ultrapassar o tamanho máximo o valor será truncado.	Sim
Cidade_NumeroMunicipioIBGE	Int	Código IBGE da cidade do endereço do fornecedor.	Não
Complemento	Varchar(200)	Complemento do endereço do fornecedor. Este campo pode ser usado para adicionar o Pais do Cliente caso necessário.	Não
Estado	Varchar(2)	Estado do endereço do cliente.	Sim
Logradouro	Varchar(100)	Logradouro do endereço do fornecedor.	Sim
Numero	Int	Número do endereço do fornecedor.	Não
TipoEndereco	VarChar	Tipo do endereço do fornecedor: Principal Entrega Comercial Cobrança Residencial O valor é case sensitive e deve ser passado exatamente como exemplo acima. Deve ser passado pelo menus 1(um) endereço como Principal.	Sim Caso não informado a tag, assume o valor como Principal	Método ManterFornecedorLC_Integracao_Xml utiliza o tipo Int. 0 - Principal 1 - Entrega 2 - Comercial 3 - Cobrança 4 - Residencial

ListaEnderecosEletronico

Tipo

Descrição/ Formato

Obrigatório?

Observação

Descricao

Varchar(60)

Descrição do endereço eletrônico do cliente. ex: [email protected]

Sim

TipoEnderecoEletronico

Varchar

Tipo do endereço eletrônico informado:

Email

Site

Aceita apenas um Endereço eletrônico por tipo

O valor é case sensitive e deve ser passado

exatamente como exemplo acima.

Sim

Método ManterFornecedorLC_Integracao_Xml

utiliza o tipo Int.

0 - Email

1 - Site

ListaTelefones	Tipo	Observação / Formato	Obrigatório?	Observação
Complemento	Varchar(30)	Complemento do telefone, pode ser usado para adicionar o DDI por exemplo. Ex: DDI +55	Não
DDD	Varchar(3)	DDD do Telefone cadastrado	Sim
Numero	Varchar(9)	Numero do telefone	Sim
TipoTelefone	Varchar(30)	Tipo do telefone: Principal Cobrança Residencial Entrega Recados Fax Comercial Celular O valor é case sensitive* e deve ser passado* exatamente como exemplo acima.	Sim	Método ManterFornecedorLC_Integracao_Xml utiliza o tipo Int. 0 - Principal 1 - Cobrança 2 - Residencial 3 - Entrega 4 - Recados 5 - Fax 6 - Comercial 7 - Celular

Informações

title	Exemplo de chamada e retorno do método ManterFornecedorLC_Integracao e ManterFornecedorLC_Integracao_Xml

Exemplo de chamada e retorno do método ManterFornecedorLC_Integracao: apenas com os campos obrigatórios*:

Bloco de código

theme	Confluence
title	Chamada do método ManterFornecedorLC_Integracao :
linenumbers	true

<soapenv:Envelope xmlns:soapenv

Informações

title	Exemplo de Chamada do Método

Bloco de código

title	Chamada:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Body>
		<ManterPrecoLC_Integracao xmlnsxmlns:liv="http://LiveConnector/">
			<publicDomain>28655D69-9999-4FD4-0000-EF26791D1969</publicDomain>
			<protectedDomain>2F9E5324-6066-4A91-BF52-F95CF5BC819F</protectedDomain>
			<preco xmlns:aren="http://schemas.datacontract.org/2004/07/Rentech.PracticoLiveFramework.Connector.Objects" Data"
	xmlns:iren1="http://wwwschemas.w3datacontract.org/2001/XMLSchema-instance2004/07/Rentech.PracticoLive.Connector.Objects">
	<soapenv:Header/>
			<a:Chave>b0b24c69-b7af-ABCD-XXXX-3964526277b2</a<soapenv:Body>
		<liv:ManterFornecedorLC_Integracao>
			<liv:fornecedor>
				<ren1:Chave>767c0c99-9387-411b-bb19-2aaaaaaa4</ren1:Chave>
				<a<ren1:CodigoSistemaSatelite>220000999<CodigoSistemaSatelite>050000000</aren1:CodigoSistemaSatelite>
				<a<ren1:Data>20200416<Data>13122019</aren1:Data>
				<a<ren1:Hora>120000<Hora>111708</aren1:Hora>
				<a<ren1:Numero>202004161445<Numero>202012171628</aren1:Numero>
				<a:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"><ren1:Documentos>
					<b:anyType i:type="a:LC_Preco"><ren1:LC_Fornecedor>
						<a<ren1:NumeroSequencia>1<NumeroSequencia>0</aren1:NumeroSequencia>
						<a:Codigo>27</a:Codigo><ren1:Apelido>FORNECEDOR QA D</ren1:Apelido>
						<a:Descricao>Tabel de Preço de Venda Master RAPHA</a:Descricao><ren1:CPF_CNPJ>12744404000250</ren1:CPF_CNPJ>
						<a:DiasEncargo>0</a:DiasEncargo><ren1:DataNascimento>1990-01-01T00:00:00</ren1:DataNascimento>
						<a<ren1:Inativo>false</aren1:Inativo>
						<a<ren1:Itens>ListaDocumentosFornecedor>
							<b:anyType i:type="a:LC_ItemPreco"><ren1:LC_DocumentoFornecedor>
								<a<ren1:Apagar>false<Identificacao>12744404000250</aren1:Apagar>Identificacao>
								<a<ren1:CodigoProduto>11012<TipoDocumentoFornecedor>CNPJ</aren1:CodigoProduto>TipoDocumentoFornecedor>
								<a:DescricaoProduto i:nil="true"/>
								<a:IDProduto>81AA238E-YTRE-ASDF-ABCD-8533CD1B1C50</a:IDProduto><ren1:Identificacao>188068292119</ren1:Identificacao>
								<a:InicioVigencia>2020-04-16T00:00:00</a:InicioVigencia><ren1:TipoDocumentoFornecedor>IE</ren1:TipoDocumentoFornecedor>
								<a:NaoConsistirVigencia>true</a:NaoConsistirVigencia>
								<a:Observacao i:nil="true"<ren1:Identificacao/>
								<a<ren1:Valor>110.12<TipoDocumentoFornecedor>IM</aren1:Valor>TipoDocumentoFornecedor>
							</b:anyType>
							<b:anyType i:type="a:LC_ItemPreco">ren1:LC_DocumentoFornecedor>
								<a:Apagar>false</a:Apagar></ren1:ListaDocumentosFornecedor>
								<a:CodigoProduto>11013</a:CodigoProduto><ren1:ListaEnderecos>
								<a:DescricaoProduto i:nil="true"/><ren1:LC_Endereco>
								<a:IDProduto>1710E82E-QAWS-45BB-95BA-8F21319FAF4C</a:IDProduto><ren1:Bairro>LARANJA AZUL</ren1:Bairro>
								<a:InicioVigencia>2020-04-16T00:00:00</a:InicioVigencia><ren1:Tipo>casa</ren1:Tipo>
								<a<ren1:NaoConsistirVigencia>true<CEP>07430350</aren1:NaoConsistirVigencia>CEP>
								<a:Observacao i:nil="true"/>
								<a:Valor>110.13</a:Valor>
							</b:anyType>
<ren1:Cidade>ARUJA</ren1:Cidade>
								<b:anyType i:type="a:LC_ItemPreco">
								<a:Apagar>false</a:Apagar><ren1:Cidade_NumeroMunicipioIBGE>3503901</ren1:Cidade_NumeroMunicipioIBGE>
								<a<ren1:CodigoProduto>11130<Estado>SP</aren1:CodigoProduto>Estado>
								<a<ren1:DescricaoProduto i:nil="true"/>
								<a:IDProduto>55CCBB46-9BE0-WERT-9F1D-92AA9B101DB6</a:IDProduto>Logradouro>Av Tower Automotive</ren1:Logradouro>
								<a:InicioVigencia>2020-04-16T00:00:00</a:InicioVigencia><ren1:Numero>300</ren1:Numero>
								<a:NaoConsistirVigencia>true</a:NaoConsistirVigencia>
								<a:Observacao i:nil="true"<ren1:Complemento/>
								<a<ren1:Valor>111.30<TipoEndereco>Principal</aren1:Valor>TipoEndereco>
							</bren1:anyType>LC_Endereco>
						</aren1:Itens>ListaEnderecos>
						<a<ren1:PercentualEncargoEmbutido>0<ListaEnderecosEletronico/a:PercentualEncargoEmbutido>>
						<a<ren1:PrecoCentralizado>true<ListaTelefones/a:PrecoCentralizado>>
						<a:PrecoDeCompra>false</a:PrecoDeCompra><ren1:Nome_RazaoSocial>Mundial Distribuidora de Consumos</ren1:Nome_RazaoSocial>
						<a<ren1:QTDItens>1<TipoFornecedor>Juridica</aren1:QTDItens>TipoFornecedor>
						<a:Regiao>US</a:Regiao>
						<a:UnidadesNegocio>
							<b:anyType i:type="a:LC_PrecoUnidadeNegocio">
								<a:CNPJUnidadeNegocio>17222541000167</a:CNPJUnidadeNegocio>
								<a:NumeroLojaUnidadeNegocio>0010462</a:NumeroLojaUnidadeNegocio></ren1:LC_Fornecedor>
							</bren1:anyType>Documentos>
						</a:UnidadesNegocio>
						<a:VigenciaPadrao>2029-12-31T00:00:00</a:VigenciaPadrao>liv:fornecedor>
					</b:anyType>
				</a:Documentos>
			</preco>
		</ManterPrecoLCliv:ManterFornecedorLC_Integracao>
	</ssoapenv:Body>
</ssoapenv:Envelope>

Bloco de código

title	ChamadaRetorno método ManterFornecedorLC_Integracao : XML

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <ManterFornecedorLC_IntegracaoResponse xmlns="http://LiveConnector/">
            <ManterFornecedorLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
        </ManterFornecedorLC_IntegracaoResponse>
    </s:Body>
</s:Envelope>

Informações

title	Chamada método ManterFornecedorLC_Integracao_Xml :

Exemplo de chamada e retorno do método ManterFornecedorLC_Integracao_Xml: apenas com os campos obrigatórios*:

Bloco de código

theme	Confluence
title	Chamada:
linenumbers	true

<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:liv='http://LiveConnector/'>
    <soapenv:Header/>
    <soapenv:Body>
        <liv:ManterFornecedorLC_Integracao_Xml>
            <liv:codigoSistemaSatelite>0500000</liv:codigoSistemaSatelite>
            <liv:xmlTicketFornecedor><![CDATA[<?xml version="1.0"?><LC_TicketFornecedor><Chave>767c0c99-9387-411b-bb19-24dd62c6b6a4</Chave><CodigoSistemaSatelite>0500000</CodigoSistemaSatelite><Data>20161118</Data><Hora>115000</Hora><Numero>202012171702</Numero><Documentos><LC_Fornecedor><NumeroSequencia>0</NumeroSequencia><Apelido>FORNECEDOR QA TESTE</Apelido><CPF_CNPJ>82925879000147</CPF_CNPJ><DataNascimento>1990-01-01T00:00:00</DataNascimento><Inativo>false</Inativo><ListaDocumentosFornecedor><LC_DocumentoFornecedor><Identificacao>188068292119</Identificacao><TipoDocumentoFornecedor>1</TipoDocumentoFornecedor></LC_DocumentoFornecedor></ListaDocumentosFornecedor><ListaEnderecos><LC_Endereco><Bairro>ANHANGABAU</Bairro><CEP>13208056</CEP><Cidade_NumeroMunicipioIBGE>3525904</Cidade_NumeroMunicipioIBGE><Complemento>1 ANDAR</Complemento><Estado>SP</Estado><Logradouro>AVENIDA NOVE DE JULHO</Logradouro><Numero>2960</Numero><Complemento/><Tipo>casa</Tipo><TipoEndereco>Principal</TipoEndereco></LC_Endereco></ListaEnderecos><ListaEnderecosEletronico/><ListaTelefones/><Nome_RazaoSocial>Mundial Distribuidora de Consumos</Nome_RazaoSocial><Sexo>Masculino</Sexo><TipoFornecedor>Juridica</TipoFornecedor></LC_Fornecedor></Documentos></LC_TicketFornecedor>]]>
</liv:xmlTicketFornecedor>
</liv:ManterFornecedorLC_Integracao_Xml>
</soapenv:Body>
</soapenv:Envelope><?xml version="1.0"?>
<LC_TicketPreco>
  <Chave>0c28d44f-a0a3-4080-bb54-8382543276e0</Chave>
  <CodigoSistemaSatelite>220999996</CodigoSistemaSatelite>
  <Data>20180206</Data>
  <Hora>120000</Hora>
  <Numero>875454545500</Numero>
  <Documentos>
	<LC_Preco>
	  <Codigo>2</Codigo>
	  <Descricao>Tabela Preço de venda</Descricao>
	  <DiasEncargo>0</DiasEncargo>
	  <Inativo>false</Inativo>
	  <NumeroSequencia>1</NumeroSequencia>
	  <PercentualEncargoEmbutido>0</PercentualEncargoEmbutido>
	  <PrecoCentralizado>true</PrecoCentralizado>
	  <PrecoDeCompra></PrecoDeCompra>
	  <QTDItens>2</QTDItens>
	  <Regiao>BR</Regiao>
	  <VigenciaPadrao>25/07/2018</VigenciaPadrao>
	  <CodigoMotivoDesconto>3</CodigoMotivoDesconto>
	  <Itens>
			<LC_ItemPreco>
			  <Apagar>false</Apagar>
			  <CodigoProduto>7798157072089</CodigoProduto>
			  <DescricaoProduto>Vinho TESTE 01 DE 750ml</DescricaoProduto>
			  <IDProduto>2FA99BDE-B8FB-44F8-AFDA-8670AEB775F6</IDProduto>
			  <InicioVigencia>18/03/2018</InicioVigencia>
			  <NaoConsistirVigencia>true</NaoConsistirVigencia>
			  <Observacao>TESTE 1001</Observacao>
			  <Valor>90</Valor>
			</LC_ItemPreco>
			<LC_ItemPreco>
			  <Apagar>false</Apagar>
			  <CodigoProduto>7798135572044</CodigoProduto>
			  <DescricaoProduto>Vinho TESTE 02 DE 750ml</DescricaoProduto>
			  <IDProduto>1YU465F7-2WWE-4370-8303-B1WWWWBD6B1D</IDProduto>
			  <InicioVigencia>18/03/2018</InicioVigencia>
			  <NaoConsistirVigencia>true</NaoConsistirVigencia>
			  <Observacao>TESTE 1002</Observacao>
			  <Valor>90</Valor>
			</LC_ItemPreco>
	   </Itens>
	  <UnidadesNegocio>
		<LC_PrecoUnidadeNegocio>
		  <CNPJUnidadeNegocio>24793408000195</CNPJUnidadeNegocio>
		  <NumeroLojaUnidadeNegocio>991513706</NumeroLojaUnidadeNegocio>
		</LC_PrecoUnidadeNegocio>
	  </UnidadesNegocio>  
	</LC_Preco>
  </Documentos>
</LC_TicketPreco>

Bloco de código

title	Retorno:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterPrecoLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterPrecoLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterPrecoLC_IntegracaoResponse>
   </s:Body>
</s:Envelope><?xml version="1.0" encoding="utf-8"?>
<Resultado>
	<LC_Retorno>
		<Chave>767c0c99-9387-411b-bb19-24dd62c6b6a4</Chave>
		<CodigoErro>0</CodigoErro>
		<CodigoSistemaSatelite>05140003</CodigoSistemaSatelite>
		<Data>17/12/2020</Data>
		<DescricaoErro>Processamento realizado com sucesso</DescricaoErro>
		<Hora>17:02</Hora>
		<NumeroSequencia>0</NumeroSequencia>
		<NumeroTicket>0</NumeroTicket>
	</LC_Retorno>
</Resultado>

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave