Histórico da Página

...

Informações

icon	false

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.

Compatibilidade
Ambiente SAAS
Ambiente OnPremise

Nota

title	Pré-requisitos

Connector Habilitado:
Classificador de cliente pré cadastrado para enviar na requisição:

Informações

icon	false
title	Exemplo de Utilização:

Neste método recebemos como Payload uma lista de 1 ou mais clientes ficando . Fica 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 "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

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

...

Informações

title	Documentos - Campos de Entrada

Aviso

title	Importante

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

Sim

Cliente (Campos)	Tipo	Descrição/ Formato	Obrigatório?	Observação
NumeroSequencia	Varchar(6)	Numero sequencia do documento implementar a cada documento. Ex: 1	Sim
Apelido	Varchar(100)	Apelido do Cliente	Não
CPF_CNPJ	Varchar(20)	Numero do documento do Cliente CPF ou CNPJ Formatos CPF válidos: 67925165030 679.251.650-30 Formatos CNPJ válidos: 95823917000100 95.823.917/0001-00	.917/0001-00	Sim	Este campo é utilizado como código referência para Clientes do Tipo Informal(TipoCliente). Este campo recebe e válida um CPF ou CNPJ válido.
CodigoLoja	VarChar(9)	Código Loja onde o cliente foi cadastrado. Se for informado essa ele vai encontrar a Central da Loja e cadastrar o cliente na Central.	Não	Caso seja informada um código de loja inválido será retornado erro na inclusão.
DataNascimento	Datetime	Data de nascimento do cliente ex: 1999-12-25 A data deve estar em um intervalo entre 1900-01-01 e a data Atual.	Sim
Inativo	Boolean	Indica se o Cliente está inativo. Valor padrão = Falso	Não
Indicacao	Varchar(120)	Indicação do cliente.	Não
LGPD_AceiteCarta	Boolean	Aceite da Carta LGPD	Não
LGPD_DataAceiteCarta	Datetime	Data do aceita da carta LGPD ex: aaaa/mm/dd	Não
LGPD_IDCarta	Guid	Identificação única interna LGPD	Não	Envio do ID da carta consentimento
ListaClassificacaoCliente	array list	Lista de classificação do cliente. O Classificador deve estar cadastrado previamente no TOTVS Live no momento da implantação. Exemplo: Para uma integração Ecommerce pode-se criar no Live um Tipo classificador "CLIENTE ECOMMERCE" e um classificador "ECOMMERCE" e deixar esses valores fixos no Request da integração.	Não
ListaDocumentosCliente	array list	Lista de documentos do cliente	Não
ListaEnderecos	array list	Lista de endereços do cliente	Sim Deve ter pelo menos 1 Endereço como Principal
ListaEnderecosEletronico	array list	Lista de endereços eletrônicos do cliente	Não
ListaLimiteCredito	array list	Lista de limite de crédito do cliente	Não
ListaModalidades	array list	Lista de limite de modalidades	Não
ListaTelefones	array list	Lista de telefones do cliente	Não
Nome_RazaoSocial	Varchar(100)	Nome para pessoa física ou razão social para pessoa jurídica.	Sim
Nota	Varchar(225)	Nota do cliente.	Não
NumeroPreVenda	Int	Numero de Pré-Venda associada ao cliente	Não
Observacoes	Varchar(255)	Observações do cliente.	Não
Sexo	VarChar	Sexo do cliente: Masculino Feminino O valor é case sensitive e deve ser passado exatamente como exemplo acima.	Não Caso não informado assume o padrão do sistema como sexo Masculino	Método ManterClienteLC_Integracao_Xml utiliza o tipo Int. 0 - Masculino 1 - Feminino
TipoClassificacaoCliente	VarChar	Tipo de classificação do cliente: Indefinido Cliente Revendedor O valor é case sensitive e deve ser passado exatamente como exemplo acima.	Não Caso não informado assume o padrão do sistema como tipo Cliente	Método ManterClienteLC_Integracao_Xml utiliza o tipo Int. 0 - Indefinido 1 - Cliente 2 - Revendedor
TipoCliente	VarChar	Tipo do cliente FisicaFísica Juridica InformalJurídica O valor é case sensitive e deve ser passado exatamente como exemplo acima.	Não Caso não informado assume o padrão do sistema como pessoa Fisica Física	Método ManterClienteLC_Integracao_Xml utiliza o tipo Int. 0 - FisicaFísica 1 - Juridica 2 - InformalJurídica

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 cliente.	Não	Caso o código do IBGE não seja enviado, as informações de Cidade / Estado/ Pais não serão registradas no Live.
Complemento	Varchar(200)	Complemento do endereço do cliente. 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 cliente.	Sim
Numero	Int	Número do endereço do cliente.	Não
TipoEndereco	VarChar	Tipo do endereço do cliente: 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 ManterClienteLC_Integracao_Xml utiliza o tipo Int. 0 - Principal 1 - Entrega 2 - Comercial 3 - Cobrança 4 - Residencial

ListaClassificacaoCliente	Tipo	Descrição / Formato	Obrigatório?
Descricao	Varchar(20)	Descricao do classifidor do cliente	Sim
DescricaoTipoClassificacao	Varchar(20)	Descricao do tipo do classifidor do cliente	Sim
ParticipaDesconto	Boolean	Classificação participa de descontos	Não

ListaDocumentosCliente

Tipo

Descrição / Formato

Obrigatório?

Observação

Identificacao

Varchar(50)

Identificação de documento do cliente.

Sim

TipoDocumentoCliente

Varchar(20)

Tipo do Documento do Cliente aceitos:

RG, Cracha, CPF, CNPJ, IE, IM

Ex: CPF para clientes pessoa física:

O valor é case sensitive e deve ser passado

exatamente como exemplo acima.

Sim

Método ManterClienteLC_Integracao_Xml

utiliza o tipo Int.

0 - RG

1 - Cracha

2 - CPF

3 - CNPJ

4 - IE

5 - IM

*** Para cliente informal deve passar um CPF válido.

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 ManterClienteLC_Integracao_Xml

utiliza o tipo Int.

0 - Email

1 - Site

ListaLimiteCredito	Tipo	Observação / Formato	Obrigatório?
Ativo	Boolean	Status do contrato de crédito do cliente.	Sim
CodigoLoja	Varchar(20)	Código de loja do crédito do cliente.	Sim
LimiteCredito	Double	Limite de crédito do cliente	Sim
LimiteMensal	Double	Limite mensagem de crédito do cliente.	Sim
Estado	Varchar(20)	Nome do contrato de crédito do cliente	Sim

ListaModalidades	Tipo	Observação / Formato	Obrigatório?
Codigo	int	Código da modalidade.	Sim
Descricao	Varchar(30)	Descrição da Modalidade	Sim

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 ManterClienteLC_Integracao_Xml utiliza o tipo Int. 0 - Principal 1 - Cobrança 2 - Residencial 3 - Entrega 4 - Recados 5 - Fax 6 - Comercial 7 - Celular

...

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 68

Nova versão Atual

Chave

Data de nascimento do cliente ex:

Data do aceita da carta LGPD ex:

aaaa/mm/dd