O método RecuperarClienteLC_Integracao do Live Connector tem a função de disponibilizar informações dos clientes no Live para o sistema externo consumir.
Pré-requisitos
- Habilitar parâmetros do Connector para recuperar ClienteSaida:
Parâmetro = 122| LiveConnector - Cliente (1 = SIM | 0 = NAO)
Parâmetro Unidade de Negócio = 109 | LiveConnector - Cliente (1 = SIM | 0 = NAO)
XML = SIM
Obs: Somente após a configuração dos parâmetros as informações alteradas/incluídas serão enviadas para integração.
As informações modificadas anteriormente e as bloqueadas para edição não serão enviadas e para integra-las devera ser feita a carga inicial com a equipe de Serviços Live.
Exemplo de Utilização:
1 - No Live para Alterar ou criar um novo Cliente acessar o seguintes caminho. (Live\Clientes)
2 - Após a criação ou alteração de um cliente devemos realizar a requisição RecuperarClienteLC_Integracao no Connector vai gerar uma lista com os cliente que foram cadastrados ou alterados no live.
Exemplo de consumo Via SoapUI:
Parâmetros de Entrada
ENTRADA
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Chave | varchar(16) | Sim | Sim | Não se Aplica | Não se Aplica | Chave de acesso do Sistema Satélite |
| CodigoSistemaSatelite | varchar(20) | Sim | Sim | Não se Aplica | Não se Aplica | Código do Sistema Sátelite |
| NumeroTicket | varchar(16) | Não | Não | Não se Aplica | Não se Aplica | Número do Ticket para Retorno |
Campos de retorno
RETORNO
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Chave | varchar(16) | Sim | Sim | Não se Aplica | Não se Aplica | Chave de acesso do Sistema Satélite |
| CodigoSistemaSatelite | varchar(20) | Sim | Sim | Não se Aplica | Não se Aplica | Código do Sistema Satélite |
| NumeroTicket | varchar(16) | Não | Não | Não se Aplica | Não se Aplica | Número do Ticket para Retorno |
| NumeroSequencia | varchar(16) | Não | Sim | Não se aplica | Não se aplica | Sequência número dos objetos retornados no ticket |
| Apelido | Varchar(100) | Não | Sim | Sim | Sim | Apelido ou Nome Fantasia do cliente. |
| CPF_CNPJ | Varchar(20) | Sim | Sim | Não | Não | CPF ou CNPJ do cliente |
| CnpjLojaCadastro | Varchar(20) | Não | Não | Sim | Sim | CNPJ da loja que efetuou cadastro |
| DataNascimento | DateTime | Não | Sim | Sim | Não | Data de nascimento, obrigatório para cliente de pessoa Física |
| Inativo | Boolean | Não | Sim | Sim | Não | Situação do cliente - true ou false |
| Indicacao | Varchar(120) | Não | Não | Sim | Sim | Texto de dados complementares |
| LGPD_AceiteCarta | Boolean | Não | Sim | Sim | Não | Aceite da carta de consentimento LGPD - true ou false |
| LGPD_DataAceiteCarta | DateTime | Não | Sim | Sim | Não | Data de aceite do consentimento LGPD |
| LGPD_IDCarta | Guid | Não | Sim | Sim | Não | ID do Consentimento LGPD |
| ListaClassificacaoClienteSaida | List | Não | Não | Sim | Sim | Classificação do cliente |
| ListaDocumentosClienteSaida | List | Sim | Sim | Sim | Não | Lista de documentos do cliente |
| ListaEnderecosEletronicosSaida | List | Sim | Não | Sim | Sim | Lista de e-mail ou site do cliente |
| ListaEnderecosSaida | List | Sim | Sim | Sim | Não | Lista de endereços do cliente |
| ListaTelefonesSaida | List | Não | Não | Sim | Sim | Lista de telefones do cliente |
| Nome_RazaoSocial | Varchar(100) | Não | Sim | Sim | Sim | Razão social ou nome do cliente |
| Nota | Varchar(255) | Não | Não | Sim | Sim | Nota de informação |
| NumeroSerieLojaCadastro | Varchar(9) | Não | Não | Sim | Sim | Série da loja de cadastro |
| Obsercacoes | Varchar(255) | Não | Não | Sim | Sim | Observações de cadastro |
| Sexo | Varchar(10) | Não | Não | Sim | Sim | Obrigatório para cliente de pessoa Física |
| TipoClassificacaoClienteCodigo | int | Não | Não | Sim | Sim | Código do Tipo de Classificação |
| TipoClassificacaoClienteDescricao | Varchar(100) | Não | Não | Sim | Sim | Descrição do Tipo de Classificação |
| TipoCliente | Varchar(10) | Não | Sim | Não | Não | Tipo de cliente: Física, Jurídica ou Informal |
ListaClassificacaoClienteSaida
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| TipoClassificacao | Varchar(100) | Sim | Não | Sim | Sim | Tipo da classificação criada para cliente |
| Descrição | Varchar(100) | Não | Não | Sim | Sim | Descrição da classificação |
| ParticipaDesconto | int | Não | Não | Sim | Sim | Informa se a classificação vinculada ao cliente irá aplicar desconto ou não |
ListaDocumentosClienteSaida
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Identificacao | Varchar(50) | Sim | Sim | Sim | Sim | É possível Editar ou excluir tipos diferente de CPF ou CNPJ que são chave e obrigatório |
| TipoDocumentoCliente | Varchar(10) | Sim | Sim | Sim | Sim | Tipo do documento: CPF, RG, CNPJ e IE obrigatório apenas CPF ou CNPJ |
ListaEnderecosEletronicosSaida
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Descrição | Varchar(100) | Não | Não | Sim | Sim | Informação do e-mail ou site Obrigatório quando o tipo por informado |
| Tipo | Varchar(10) | Sim | Não | Sim | Sim | Tipo de Identificação: e-mail ou site |
ListaEnderecosSaida
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Bairro | Varchar(50) | Não | Sim | Sim | Sim | Bairro do endereço, obrigatório quando endereço for cadastrado |
| CEP | Varchar(10) | Não | Sim | Sim | Sim | CEP do endereço, obrigatório quando endereço for cadastrado |
| Cidade_NumeroMunicipioIBGE | Long | Não | Sim | Sim | Sim | Código do IBGE da cidade, obrigatório quando endereço for cadastrado |
| Complemento | Varchar(200) | Não | Não | Sim | Sim | Complemento do endereço |
| Estado | Varchar(2) | Não | Sim | Sim | Sim | Estado da Cidade do endereço, obrigatório quando endereço for cadastrado |
| Logradouro | Varchar(100) | Não | Sim | Sim | Sim | Logradouro do endereço, obrigatório quando endereço for cadastrado |
| Numero | Int | Não | Sim | Sim | Sim | Número do endereço, obrigatório quando endereço for cadastrado |
| TipoEndereco | varchar(20) | Sim | Sim | Sim | Sim | Tipo de Endereço: Principal, Comercial, Residencial, Cobrança e Entrega |
ListaTelefonesSaida
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Complemento | varchar(30) | Não | Não | Sim | Sim | Complemento do telefone |
| DDD | varchar(3) | Não | Não | Sim | Sim | Informação do DDD Obrigatório quando o tipo for informado |
| Numero | varchar(9) | Não | Não | Sim | Sim | Número do telefone Obrigatório quando o tipo for informado |
| TipoTelefone | varchar(20) | Sim | Não | Sim | Sim | Tipo de telefone: Principal, Residencial, Cobrança, Fax, Recados, Celular, Comercial, Entrega |
Exemplo de Chamada do Método
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">
<soapenv:Header/>
<soapenv:Body>
<liv:RecuperarClienteLC_Integracao>
<liv:identificacao>
<ren1:Chave>47f358ce-9d0a-490f-bdc0-2aedc225e402</ren1:Chave>
<ren1:CodigoSistemaSatelite>2200002879</ren1:CodigoSistemaSatelite>
</liv:identificacao>
<liv:numeroTicket>9999999999999999</liv:numeroTicket>
</liv:RecuperarClienteLC_Integracao>
</soapenv:Body>
</soapenv:Envelope>
Retorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <RecuperarClienteLC_IntegracaoResponse xmlns="http://LiveConnector/"> <RecuperarClienteLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_TicketClienteSaida</ClassID> <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:31.9909159-03:00</Creation> <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:31.9909159-03:00</LastUpdate> <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID> <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID> <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID> <a:Chave>00000000-0000-0000-0000-000000000000</a:Chave> <a:CodigoSistemaSatelite>051411123</a:CodigoSistemaSatelite> <a:Data>07/08/2020</a:Data> <a:Hora>17:55</a:Hora> <a:Numero>1200805112820337</a:Numero> <a:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <b:anyType i:type="a:LC_ClienteSaida"> <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_ClienteSaida</ClassID> <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.0569152-03:00</Creation> <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.0569152-03:00</LastUpdate> <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID> <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID> <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID> <a:NumeroSequencia>000001</a:NumeroSequencia> <a:Apelido>empTeste</a:Apelido> <a:CPF_CNPJ>36932853000109</a:CPF_CNPJ> <a:CnpjLojaCadastro i:nil="true"/> <a:DataNascimento>0001-01-01T00:00:00</a:DataNascimento> <a:Inativo>false</a:Inativo> <a:Indicacao/> <a:LGPD_AceiteCarta>false</a:LGPD_AceiteCarta> <a:LGPD_DataAceiteCarta>0001-01-01T00:00:00</a:LGPD_DataAceiteCarta> <a:LGPD_IDCarta/> <a:ListaClassificacaoClienteSaida/> <a:ListaDocumentosClienteSaida> <b:anyType i:type="a:LC_DocumentoClienteSaida"> <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_DocumentoClienteSaida</ClassID> <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.105921-03:00</Creation> <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.105921-03:00</LastUpdate> <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID> <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID> <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID> <a:Identificacao>36932853000109</a:Identificacao> <a:TipoDocumentoCliente>CNPJ</a:TipoDocumentoCliente> </b:anyType> </a:ListaDocumentosClienteSaida> <a:ListaEnderecosEletronicoSaida/> <a:ListaEnderecosSaida> <b:anyType i:type="a:LC_EnderecoSaida"> <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_EnderecoSaida</ClassID> <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.1389145-03:00</Creation> <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.1389145-03:00</LastUpdate> <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID> <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID> <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID> <a:Bairro>bairro TESTE</a:Bairro> <a:CEP>11111111</a:CEP> <a:Cidade_NumeroMunicipioIBGE>3550308</a:Cidade_NumeroMunicipioIBGE> <a:Complemento/> <a:Estado>SP</a:Estado> <a:Logradouro>rua teste</a:Logradouro> <a:Numero>12</a:Numero> <a:TipoEndereco>Principal</a:TipoEndereco> </b:anyType> </a:ListaEnderecosSaida> <a:ListaTelefonesSaida> <b:anyType i:type="a:LC_TelefoneSaida"> <ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_TelefoneSaida</ClassID> <Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.2819314-03:00</Creation> <LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-08-07T17:55:32.2819314-03:00</LastUpdate> <ObjectID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</ObjectID> <OwnerID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</OwnerID> <UserID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">00000000-0000-0000-0000-000000000000</UserID> <a:Complemento/> <a:DDD>11</a:DDD> <a:Numero>999999999</a:Numero> <a:TipoTelefone>Residencial</a:TipoTelefone> </b:anyType> </a:ListaTelefonesSaida> <a:Nome_RazaoSocial>empresaTeste</a:Nome_RazaoSocial> <a:Nota/> <a:NumeroSerieLojaCadastro i:nil="true"/> <a:Obsercacoes/> <a:Sexo>Masculino</a:Sexo> <a:TipoClassificacaoClienteCodigo>1</a:TipoClassificacaoClienteCodigo> <a:TipoClassificacaoClienteDescricao>Cliente</a:TipoClassificacaoClienteDescricao> <a:TipoCliente>Juridica</a:TipoCliente> </b:anyType> </a:Documentos> </RecuperarClienteLC_IntegracaoResult> </RecuperarClienteLC_IntegracaoResponse> </s:Body> </s:Envelope>
Chamada Método: XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/"> <soapenv:Header/> <soapenv:Body> <liv:RecuperarClienteLC_Integracao_Xml> <liv:codigoSistemaSatelite>751501123</liv:codigoSistemaSatelite> <liv:xmlIdentificacao> <![CDATA[<LC_Identificacao><Chave>0d5d999d-38f2-40c2-b92e-377a21e037de</Chave><CodigoSistemaSatelite>751501123</CodigoSistemaSatelite><Data>20200810</Data><Hora>100000</Hora></LC_Identificacao>]]> </liv:xmlIdentificacao> </liv:RecuperarClienteLC_Integracao_Xml> </soapenv:Body> </soapenv:Envelope>
Retorno Método: XML
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <RecuperarClienteLC_Integracao_XmlResponse xmlns="http://LiveConnector/"> <RecuperarClienteLC_Integracao_XmlResult> <![CDATA[<LC_TicketClienteSaida> <Creation>2020-08-10T10:57:24.16526-03:00</Creation> <LastUpdate>2020-08-10T10:57:24.16526-03:00</LastUpdate> <Data>10/08/2020</Data> <Hora>10:57</Hora> <CodigoSistemaSatelite>751501123</CodigoSistemaSatelite> <Chave>00000000-0000-0000-0000-000000000000</Chave> <Numero>1200222199999</Numero> <Documentos> <LC_ClienteSaida> <Creation>2020-08-10T10:57:24.3059048-03:00</Creation> <LastUpdate>2020-08-10T10:57:24.3059048-03:00</LastUpdate> <NumeroSequencia>000001</NumeroSequencia> <TipoCliente>Juridica</TipoCliente> <CPF_CNPJ>36900000000000</CPF_CNPJ> <Nome_RazaoSocial>empresaTeste</Nome_RazaoSocial> <Apelido>empTeste</Apelido> <Indicacao /> <Nota /> <Sexo>Masculino</Sexo> <DataNascimento>0001-01-01T00:00:00</DataNascimento> <Obsercacoes /> <Inativo>false</Inativo> <ListaEnderecosSaida> <LC_EnderecoSaida> <Creation>2020-08-10T10:57:24.680873-03:00</Creation> <LastUpdate>2020-08-10T10:57:24.680873-03:00</LastUpdate> <TipoEndereco>Principal</TipoEndereco> <Logradouro>rua teste</Logradouro> <Numero>12</Numero> <Complemento /> <Bairro>bairro TESTE</Bairro> <CEP>11111111</CEP> <Estado>SP</Estado> <Cidade_NumeroMunicipioIBGE>3550308</Cidade_NumeroMunicipioIBGE> </LC_EnderecoSaida> </ListaEnderecosSaida> <ListaDocumentosClienteSaida> <LC_DocumentoClienteSaida> <Creation>2020-08-10T10:57:24.4933815-03:00</Creation> <LastUpdate>2020-08-10T10:57:24.4933815-03:00</LastUpdate> <TipoDocumentoCliente>CNPJ</TipoDocumentoCliente> <Identificacao>36900000000000</Identificacao> </LC_DocumentoClienteSaida> </ListaDocumentosClienteSaida> <ListaEnderecosEletronicoSaida /> <ListaTelefonesSaida> <LC_TelefoneSaida> <Creation>2020-08-10T10:57:25.1809002-03:00</Creation> <LastUpdate>2020-08-10T10:57:25.1809002-03:00</LastUpdate> <TipoTelefone>Residencial</TipoTelefone> <DDD>11</DDD> <Numero>999999999</Numero> <Complemento /> </LC_TelefoneSaida> </ListaTelefonesSaida> <ListaClassificacaoClienteSaida /> <TipoClassificacaoClienteDescricao>Cliente</TipoClassificacaoClienteDescricao> <TipoClassificacaoClienteCodigo>1</TipoClassificacaoClienteCodigo> <LGPD_AceiteCarta>false</LGPD_AceiteCarta> <LGPD_DataAceiteCarta>0001-01-01T00:00:00</LGPD_DataAceiteCarta> <LGPD_IDCarta /> </LC_ClienteSaida> </Documentos> </LC_TicketClienteSaida>]]> </RecuperarClienteLC_Integracao_XmlResult> </RecuperarClienteLC_Integracao_XmlResponse> </s:Body> </s:Envelope>
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas