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

Compatibilidade
Ambiente SAAS
  •    

Ambiente OnPremise

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

Exemplo de consumo Via Postman:

ManterFornecedorLC_Integracao


ManterFornecedorLC_Integracao_Xml


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


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

ListaDocumentosCliente

Tipo

Descrição / FormatoObrigatório?Observação
Identificacao

Varchar(50)

Identificação de documento do fornecedor.Sim
TipoDocumentoClienteVarchar(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


ListaEnderecos

Tipo

Descrição/ FormatoObrigatório?Observação
BairroVarchar(50)

Bairro do endereço do cliente.

Caso ultrapassar o tamanho máximo o valor será truncado.

Sim
CEPVarchar(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_NumeroMunicipioIBGEIntCó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
NumeroIntNúmero do endereço do fornecedor.Não
TipoEnderecoVarChar

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/ FormatoObrigatório?Observação
DescricaoVarchar(60)Descrição do endereço eletrônico do cliente. ex: [email protected]

Sim



TipoEnderecoEletronicoVarchar

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 / FormatoObrigatório?Observação
ComplementoVarchar(30)

Complemento do telefone, pode ser usado para adicionar o DDI por exemplo.

Ex: DDI +55

Não
DDDVarchar(3)DDD do Telefone cadastradoSim
NumeroVarchar(9)Numero do telefoneSim
TipoTelefoneVarchar(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


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


<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:ManterFornecedorLC_Integracao>
			<liv:fornecedor>
				<ren1:Chave>767c0c99-9387-411b-bb19-2aaaaaaa4</ren1:Chave>
				<ren1:CodigoSistemaSatelite>050000000</ren1:CodigoSistemaSatelite>
				<ren1:Data>13122019</ren1:Data>
				<ren1:Hora>111708</ren1:Hora>
				<ren1:Numero>202012171628</ren1:Numero>
				<ren1:Documentos>
					<ren1:LC_Fornecedor>
						<ren1:NumeroSequencia>0</ren1:NumeroSequencia>
						<ren1:Apelido>FORNECEDOR QA D</ren1:Apelido>
						<ren1:CPF_CNPJ>12744404000250</ren1:CPF_CNPJ>
						<ren1:DataNascimento>1990-01-01T00:00:00</ren1:DataNascimento>
						<ren1:Inativo>false</ren1:Inativo>
						<ren1:ListaDocumentosFornecedor>
							<ren1:LC_DocumentoFornecedor>
								<ren1:Identificacao>12744404000250</ren1:Identificacao>
								<ren1:TipoDocumentoFornecedor>CNPJ</ren1:TipoDocumentoFornecedor>
								<ren1:Identificacao>188068292119</ren1:Identificacao>
								<ren1:TipoDocumentoFornecedor>IE</ren1:TipoDocumentoFornecedor>
								<ren1:Identificacao/>
								<ren1:TipoDocumentoFornecedor>IM</ren1:TipoDocumentoFornecedor>
							</ren1:LC_DocumentoFornecedor>
						</ren1:ListaDocumentosFornecedor>
						<ren1:ListaEnderecos>
							<ren1:LC_Endereco>
								<ren1:Bairro>LARANJA AZUL</ren1:Bairro>
								<ren1:Tipo>casa</ren1:Tipo>
								<ren1:CEP>07430350</ren1:CEP>
								<ren1:Cidade>ARUJA</ren1:Cidade>
								<ren1:Cidade_NumeroMunicipioIBGE>3503901</ren1:Cidade_NumeroMunicipioIBGE>
								<ren1:Estado>SP</ren1:Estado>
								<ren1:Logradouro>Av Tower Automotive</ren1:Logradouro>
								<ren1:Numero>300</ren1:Numero>
								<ren1:Complemento/>
								<ren1:TipoEndereco>Principal</ren1:TipoEndereco>
							</ren1:LC_Endereco>
						</ren1:ListaEnderecos>
						<ren1:ListaEnderecosEletronico/>
						<ren1:ListaTelefones/>
						<ren1:Nome_RazaoSocial>Mundial Distribuidora de Consumos</ren1:Nome_RazaoSocial>
						<ren1:TipoFornecedor>Juridica</ren1:TipoFornecedor>
					</ren1:LC_Fornecedor>
				</ren1:Documentos>
			</liv:fornecedor>
		</liv:ManterFornecedorLC_Integracao>
	</soapenv:Body>
</soapenv:Envelope>

<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>
Exemplo de chamada e retorno do método ManterFornecedorLC_Integracao_Xml: apenas com os campos obrigatórios*:


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