O método ManterClienteLC_Integracao do Live Connector tem a função de Incluir/alterar clientes do sistema externo para o Live.


Existem dois métodos para incluir clientes:

  • ManterClienteLC_Integracao:

Recebe Objeto Xml no formato Rentech.PracticoLive.Connector.Objects este é o método Padrão e usado pela maioria dos usuários


  • ManterClienteLC_Integracao_Xml:

Recebe as informações de entrada no formato XML.

Este método é utilizado pelos usuários que por alguma limitação técnica não conseguem manipular o formato padrão.



  • Connector Habilitado:
  • Classificador de cliente válido para enviar via Connector:       



Neste método recebemos como Payload uma lista de 1 ou mais clientes ficando a critério do integrador a quantidade de clientes 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 "01" para o primeiro elemento "02" 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 abaixo:

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 consumo Via SoapUI:



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
Numero
0AAMMDDHHMMSSMMMNúmero do Ticket de entrada, ver detalhes no item DICA 01 acimaSim
DocumentosList
Objetos de Ticket(Documento) no formato da mensagem ver detalhes abaixoSim

Cliente

Tipo

Descrição/ FormatoObrigatório?
NumeroSequenciaVarchar(16)

ApelidoVarchar(100)
Não
CPF_CNPJ

Varchar(20)



DataNascimentoDatetime
aaaammdd

InativoBoolean

IndicacaoVarchar(120)

ListaClassificacaoClientearray list

ListaDocumentosClientearray list

ListaEnderecosarray list

ListaEnderecosEletronicoarray list

ListaLimiteCreditoarray list

ListaModalidadesarray list



ListaTelefonesarray list

Nome_RazaoSocial

Varchar(100)

(aviso) 
Nota

Varchar(225)

(aviso) 
Observacoes

Varchar(255)

(aviso) 
Sexo

int

(aviso) 
TipoClassificaoClienteint(aviso) 
TipoCliente

int

(aviso) 
LGPD_AceiteCarta

Boolean

(informação)
LGPD_DataAceiteCartaDatetime
aaaa/mm/dd (informação) 

LGPD_IDCartaGuid(informação)

ListaClassificacaoCliente

Tipo

Descricao

Varchar(20)

DescricaoTipoClassificacao

Varchar(20)

ParticipaDescontoBoolean

ListaDocumentosCliente

Tipo

Identificacao

Varchar(50)

TipoDocumentoClienteVarchar(20)

ListaEnderecos

Tipo

BairroVarchar(50)
CEPVarchar(10)
Cidade_NumeroMunicipioIBGELing
Complemento

Varchar(200)

Estado

Varchar(2)

Logradouro

Varchar(100)

NumeroInt
TipoEnderecoint

ListaEnderecosEletronico

Tipo

Descrição/ FormatoObrigatório?
DescricaoVarchar(60)Descrição do endereço eletrônico do cliente. ex: [email protected]

Não


(Se torna obrigatório se passar valor no campo TipoEnderecoEletronico)

TipoEnderecoEletronicoint

Tipo do endereço eletrônico informado:

Email = 0,

Site = 1 


Aceita apenas um Endereço eletrônico por tipo

Não


(Se torna obrigatório se passar valor no campo Descricao)

ListaLimiteCredito

Tipo

Observação / Formato
AtivoBoolean
CodigoLojaVarchar(20)
LimiteCreditoDouble
LimiteMensalDouble
EstadoVarchar(20)(informação)

ListaModalidades

Tipo

Observação / Formato
Codigoint(informação) (aviso) 
DescricaoVarchar(30)(informação) (aviso) 

ListaTelefones

Tipo

Observação / Formato
ComplementoVarchar(30)
DDDVarchar(3)
NumeroVarchar(9)
TipoTelefoneVarchar(30)(aviso) 



<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:ManterClienteLC_Integracao>
			<liv:cliente>
				<ren1:Chave>4212ce50-4b8f-4da6-a0b6-c25c9f87d406</ren1:Chave>
				<ren1:CodigoSistemaSatelite>11111111</ren1:CodigoSistemaSatelite>
				<ren1:Data>20200729</ren1:Data>
				<ren1:Hora>160000</ren1:Hora>
				<ren1:Numero>00002</ren1:Numero>
				<ren1:Documentos>
					<ren1:LC_Cliente>
						<ren1:NumeroSequencia>1</ren1:NumeroSequencia>
						<ren1:Apelido>AMIGAO</ren1:Apelido>
						<ren1:CPF_CNPJ>88888888888</ren1:CPF_CNPJ>
						<ren1:Inativo>false</ren1:Inativo>
						<ren1:Indicacao>TESTE FRAPHAEL</ren1:Indicacao>
						<ren1:ListaClassificacaoCliente>
							<ren1:LC_ClassificacaoCliente>
								<ren1:Descricao>UPA</ren1:Descricao>
								<ren1:DescricaoTipoClassificacao>CLIENTE FIDELIDADE</ren1:DescricaoTipoClassificacao>
								<ren1:ParticipaDesconto>false</ren1:ParticipaDesconto>
							</ren1:LC_ClassificacaoCliente>
						</ren1:ListaClassificacaoCliente>
						<ren1:ListaDocumentosCliente>
							<ren1:LC_DocumentoCliente>
								<ren1:Identificacao>88888888888</ren1:Identificacao>
								<ren1:TipoDocumentoCliente>CPF</ren1:TipoDocumentoCliente>
							</ren1:LC_DocumentoCliente>
						</ren1:ListaDocumentosCliente>
						<ren1:ListaEnderecos>
							<ren1:LC_Endereco>
								<ren1:Bairro>ANHANGABAU</ren1:Bairro>
								<ren1:CEP>13208056</ren1:CEP>
								<ren1:Cidade>SAO PAULO</ren1:Cidade>
								<ren1:Cidade_NumeroMunicipioIBGE>3525904</ren1:Cidade_NumeroMunicipioIBGE>
								<ren1:Complemento>1 ANDAR</ren1:Complemento>
								<ren1:Estado>SP</ren1:Estado>
								<ren1:Logradouro>AVENIDA BRAZ LEME</ren1:Logradouro>
								<ren1:Numero>1000</ren1:Numero>
							</ren1:LC_Endereco>
						</ren1:ListaEnderecos>
						<ren1:ListaEnderecosEletronico>
							<ren1:LC_EnderecoEletronico>
								<ren1:Descricao>[email protected]</ren1:Descricao>
							</ren1:LC_EnderecoEletronico>
						</ren1:ListaEnderecosEletronico>
						<ren1:ListaLimiteCredito>
							<ren1:LC_LimiteCredito>
								<ren1:Ativo>true</ren1:Ativo>
								<ren1:CodigoLoja>08888888000888</ren1:CodigoLoja>
								<ren1:LimiteCredito>1000</ren1:LimiteCredito>
								<ren1:LimiteMensal>10000</ren1:LimiteMensal>
								<ren1:NomeContrato>TESTE RAPHAEL 1</ren1:NomeContrato>
							</ren1:LC_LimiteCredito>
						</ren1:ListaLimiteCredito>
						<ren1:ListaTelefones>
							<ren1:LC_Telefone>
								<ren1:Complemento>RAMAL 171</ren1:Complemento>
								<ren1:DDD>11</ren1:DDD>
								<ren1:Numero>11999999990</ren1:Numero>
							</ren1:LC_Telefone>
						</ren1:ListaTelefones>
					</ren1:LC_Cliente>
				</ren1:Documentos>
			</liv:cliente>
		</liv:ManterClienteLC_Integracao>
	</soapenv:Body>
</soapenv:Envelope>
		      
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterClienteLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterClienteLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterClienteLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
	<soapenv:Header/>
	<soapenv:Body>
		<liv:ManterClienteLC_Integracao_Xml>
			<liv:codigoSistemaSatelite>1111111</liv:codigoSistemaSatelite>
			<liv:xmlTicketCliente>
				<![CDATA[<?xml version="1.0"?>
<LC_TicketCliente>
	<Chave>4212ce50-4b8f-4da6-a0b6-c25c9f87d406</Chave>
	<CodigoSistemaSatelite>111111111</CodigoSistemaSatelite>
	<Data>20200729</Data>
	<Hora>160000</Hora>
	<Numero>00003</Numero>
	<Documentos>
		<LC_Cliente>
			<Apelido>Rafael P</Apelido>
			<CPF_CNPJ>01068124083</CPF_CNPJ>
			<DataNascimento>01/02/1999</DataNascimento>
			<Inativo>false</Inativo>
			<Indicacao/>
			<Nome_RazaoSocial>Rafael P</Nome_RazaoSocial>
			<Nota>0</Nota>
			<NumeroSequencia>1</NumeroSequencia>
			<Observacoes>Observação TESTE </Observacoes>
			<Sexo>1</Sexo>
			<TipoCliente>1</TipoCliente>
			<TipoClassificacaoCliente>2</TipoClassificacaoCliente>
			<ListaClassificacaoCliente>
				<LC_ClassificacaoCliente>
					<Descricao>ATACADO VIP</Descricao>
					<DescricaoTipoClassificacao>CLIENTE ATACADO</DescricaoTipoClassificacao>
					<ParticipaDesconto>false</ParticipaDesconto>
				</LC_ClassificacaoCliente>
			</ListaClassificacaoCliente>
			<ListaDocumentosCliente>
				<LC_DocumentoCliente>
					<Identificacao>01068124083</Identificacao>
					<TipoDocumentoCliente>1</TipoDocumentoCliente>
				</LC_DocumentoCliente>
			</ListaDocumentosCliente>
			<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>
					<TipoEndereco>0</TipoEndereco>
				</LC_Endereco>
			</ListaEnderecos>
			<ListaEnderecosEletronico>
				<LC_EnderecoEletronico>
					<Descricao>[email protected]</Descricao>
					<TipoEnderecoEletronico>0</TipoEnderecoEletronico>
				</LC_EnderecoEletronico>
			</ListaEnderecosEletronico>
			<ListaTelefones>
				<LC_Telefone>
					<Complemento>RAMAL 8800</Complemento>
					<DDD>11</DDD>
					<Numero>123456789321</Numero>
					<TipoTelefone>0</TipoTelefone>
				</LC_Telefone>
			</ListaTelefones>
			<ListaLimiteCredito>
				<LC_LimiteCredito>
					<Ativo>true</Ativo>
					<CodigoLoja>01851716000165</CodigoLoja>
					<LimiteCredito>75</LimiteCredito>
					<LimiteMensal>750</LimiteMensal>
					<NomeContrato>TESTE JOAO 1</NomeContrato>
				</LC_LimiteCredito>
				<LC_LimiteCredito>
					<Ativo>false</Ativo>
					<CodigoLoja>01851716000165</CodigoLoja>
					<LimiteCredito>40</LimiteCredito>
					<LimiteMensal>400</LimiteMensal>
					<NomeContrato>TESTE JOAO 2</NomeContrato>
				</LC_LimiteCredito>
			</ListaLimiteCredito>
		</LC_Cliente>
	</Documentos>
</LC_TicketCliente>]]>
			</liv:xmlTicketCliente>
		</liv:ManterClienteLC_Integracao_Xml>
	</soapenv:Body>
</soapenv:Envelope>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Body>
		<ManterClienteLC_Integracao_XmlResponse xmlns="http://LiveConnector/">
			<ManterClienteLC_Integracao_XmlResult>
				<![CDATA[<?xml version="1.0" encoding="utf-8"?>
					<Resultado>
						<LC_Retorno>
							<Chave>27badbda-d179-4c85-9172-c7bec32632d0</Chave>
							<CodigoErro>0</CodigoErro>
							<CodigoSistemaSatelite>05140003</CodigoSistemaSatelite>
							<Data>10/08/2020</Data><DescricaoErro>Processamento realizado com sucesso</DescricaoErro>
							<Hora>11:59</Hora>
							<NumeroSequencia>0</NumeroSequencia>
							<NumeroTicket>0</NumeroTicket>
						</LC_Retorno>
					</Resultado>]]>
			</ManterClienteLC_Integracao_XmlResult>
		</ManterClienteLC_Integracao_XmlResponse>
	</s:Body>
</s:Envelope>