Exibir origem

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:

TOTVS Varejo Franquias e Redes > ManterClienteLC_Integracao > image2020-4-8_15-38-27.png

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

Cliente	Tipo	Descrição/ Formato	Obrigatório?
NumeroSequencia	Varchar(16)
Apelido	Varchar(100)		Não
CPF_CNPJ	Varchar(20)
DataNascimento	Datetime	aaaammdd
Inativo	Boolean
Indicacao	Varchar(120)
ListaClassificacaoCliente	array list
ListaDocumentosCliente	array list
ListaEnderecos	array list
ListaEnderecosEletronico	array list
ListaLimiteCredito	array list
ListaModalidades	array list
ListaTelefones	array list
Nome_RazaoSocial	Varchar(100)
Nota	Varchar(225)
Observacoes	Varchar(255)
Sexo	int
TipoClassificaoCliente	int
TipoCliente	int
LGPD_AceiteCarta	Boolean
LGPD_DataAceiteCarta	Datetime	aaaa/mm/dd
LGPD_IDCarta	Guid

ListaClassificacaoCliente	Tipo
Descricao	Varchar(20)
DescricaoTipoClassificacao	Varchar(20)
ParticipaDesconto	Boolean

ListaDocumentosCliente	Tipo
Identificacao	Varchar(50)
TipoDocumentoCliente	Varchar(20)

ListaEnderecos	Tipo
Bairro	Varchar(50)
CEP	Varchar(10)
Cidade_NumeroMunicipioIBGE	Ling
Complemento	Varchar(200)
Estado	Varchar(2)
Logradouro	Varchar(100)
Numero	Int
TipoEndereco	int

ListaEnderecosEletronico

Tipo

Descrição/ Formato

Obrigatório?

Descricao

Varchar(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)

TipoEnderecoEletronico

int

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
Ativo	Boolean
CodigoLoja	Varchar(20)
LimiteCredito	Double
LimiteMensal	Double
Estado	Varchar(20)

ListaModalidades	Tipo	Observação / Formato
Codigo	int
Descricao	Varchar(30)

ListaTelefones	Tipo	Observação / Formato
Complemento	Varchar(30)
DDD	Varchar(3)
Numero	Varchar(9)
TipoTelefone	Varchar(30)

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

aaaammdd

aaaa/mm/dd