ManterFornecedorLC_Integracao

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

Pré-requisitos

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 Utilização:

Exemplo de consumo Via Postman:

ManterFornecedorLC_Integracao

ManterFornecedorLC_Integracao_Xml

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

Parâmetros de Entrada

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

Parâmetros de Entrada - Documentos

Oops, it seems that you need to place a table or a macro generating a table within the Pivot Table macro.

The table is being loaded. Please wait for a bit ...

ListaDocumentosCliente

Tipo

Descrição / Formato

Obrigatório?

Observação

Identificacao

Varchar(50)

Identificação de documento do fornecedor.

Sim

TipoDocumentoCliente

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

Parâmetros de Entrada - Endereços

Oops, it seems that you need to place a table or a macro generating a table within the Pivot Table macro.

The table is being loaded. Please wait for a bit ...

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 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
Numero	Int	Número do endereço do fornecedor.	Não
TipoEndereco	VarChar	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/ 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 ManterFornecedorLC_Integracao_Xml

utiliza o tipo Int.

0 - Email

1 - Site

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

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

Chamada do método ManterFornecedorLC_Integracao :

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

Retorno método ManterFornecedorLC_Integracao :

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

Chamada método ManterFornecedorLC_Integracao_Xml :

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

Chamada:

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

Retorno:

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

Atalhos

Árvore de páginas