TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Thiago Soares Arnoni

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Usuário desconhecido (raphael.cristino)

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
iconfalse

O método AtualizarVinculoCartaLGPDLC_Integracao do Live Connector tem a função de atualizar o consentimento (aceite - sim/não) de uma entidade com relação a uma carta consentimento LGPD.


Compatibilidade
Ambiente SAAS
  •     

Ambiente OnPremise

  •     
Nota
titlePré-requisitos
  •  Connector Habilitado.
Informações
iconfalse
titleExemplo de Utilização:

Neste método recebemos como Payload uma lista de 1 ou mais documentos ficando a critério do integrador a quantidade de documentos a serem atualizados por requisição.

O método possui um limite de no máximo 100 documentos por requisição.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:


Exemplo de consumo Via SoapUI:


Informações
titleParâmetros de Entrada
Aviso
titleImportante

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

exemplos de formatos:

  • 77777777777
  • 88888888888888
CampoTipoFormatoDescriçãoObrigatório?
ChaveGuid

exemplo de formato:

c827c0cb-df3b-4872-8153-755f9c57e903

Chave de acesso Obtida no método ObterChaveAcesso             SimSim
CodigoSistemaSateliteVarChar(10)
Cliente Solicita com time de Serviços LiveSim
DocumentosListLista de documentosVide tabela Documentos abaixoSim
TipoEntidadeIDVarChar(2)1

ID do tipo das entidades que serão atualizadas:

"1" - Cliente

             SimDocumentosListLista de documentosSimAceitebool

Aceite (sim/não) que deseja atualizar o vinculo com uma carta consentimento

0 - Não

1 - Sim

------------------------

false - não

true - Sim		       SimCpfCnpjVarChar(20)

Identificação da entidade.

Não deve conter nenhum tipo de máscara.

       SimDataAceiteVarChar(20)

Exemplos de formatação:

  • 16/07/2021 09:14:00
  • 16/07/2021

Data de aceite ou recusa do vinculo da entidade com a carta consentimento LGPD.

Caso esse campo não seja enviado, será considerado a data e hora do momento da requisição.

Caso seja enviado apenas a data (ddMMyyyy), sem a hora, será considerado às 00:00:00 hrs.

Documentos
ItensTipoDescrição/ FormatoObservaçãoObrigatório?
AceiteBoolean

Aceite (sim/não) que deseja atualizar o vinculo com uma carta consentimento

0 - Não

1 - Sim

------------------------

false - não Não

true - Sim

      

Identificação da entidade.

Não deve conter nenhum tipo de máscara.

Caso não seja enviado valor neste campo, o valor default será false.

       Sim Não
CpfCnpjVarChar(20)

exemplos de formatos:

  • 77777777777
  • 88888888888888

Identificação da entidade.

Não deve conter nenhum tipo de máscara.

       Sim

DataAceiteVarChar(20)

Exemplos de formatação (ddMMyyyy hhmmss):

  • 16/07/2021 09:14:00
  • 16/07/2021

Data de aceite ou recusa do vinculo da entidade com a carta consentimento LGPD.

Caso esse campo não seja enviado, será considerado a data e hora do momento da requisição.

Caso seja enviado apenas a data (ddMMyyyy), sem a hora, será considerado às 00:00:00 hrs.

      Não
warning
Informações
titleCampos de retorno
titleImportante

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

Tipo do ticket a ser alterado Conforme Tabela Abaixo:

Status que deseja alterar o ticket

1 = Disponível para envio

2 = Envio confirmado

Cliente (Campos)

Tipo

FormatoDescriçãoObrigatório?Observação
ListaTicketsDocumentosListLista de ticketsdocumentosVide tabela Lista de tickets abaixoNumeroVarChar(16)0AAMMDDHHMMSSMMMNúmero do Ticket de entrada, ver detalhes no item "DICA 01" acima              SimTipoTicketIntSimStatusIntSimDocumentos abaixo

Lista de tickets

Itens

Tipo

Descrição/ FormatoObrigatório?Observação
Numero
CpfCnpj
Varchar
VarChar(
16
20)
Número do ticket

Identificação da Entidade

Sim
Observacao

DescricaoErro
Varchar
VarChar(
4000
200)Descrição com o motivo do erro         
 SimStatusRetornoBIT
      SimSó retornará preenchido caso ocorra erro na atualização do vinculo da entidade.
SucessoBoolean

Status de retorno da atualização do ticket:

0

false - Erro

1

true - Sucesso


                Sim


Informações
titleExemplo de Chamada do Método


1 - Chamada do método AtualizarStatusTicketLCmétodo AtualizarVinculoCartaLGPDLC_Integracao


Bloco de código
titleChamada:
<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:AtualizarStatusTicketLCAtualizarVinculoCartaLGPDLC_Integracao>
         <liv:identificacao>
            <ren1:Chave>c827c0cbChave>6b2ecc84-df3b04c8-48724f67-81538795-755f9c57e903<0f5edfd8fc66</ren1:Chave>
            <ren1:CodigoSistemaSatelite>2200002000<CodigoSistemaSatelite>xxxxxxxxxx</ren1:CodigoSistemaSatelite>            
            <ren1:ListaTickets>Documentos>
               <ren1:LC_Ticket>                  VinculoCartaLGPD>
                  <ren1:Numero>1200101005944801<Aceite>1</ren1:Numero>Aceite>
               </ren1:LC_Ticket>
               <ren1:LC_Ticket><ren1:CpfCnpj>77777777777</ren1:CpfCnpj>
                  <ren1:Numero>1200101005944800<:DataAceite>16/07/2021 09:14:00</ren1:Numero>DataAceite>
               </ren1:LC_Ticket>
               VinculoCartaLGPD>
			  <ren1:LC_Ticket>VinculoCartaLGPD>
                  <ren1:Aceite>1</ren1:Aceite>
                  <ren1:Numero>1200101010054600<CpfCnpj>99999999999</ren1:Numero>CpfCnpj>
               <   <ren1:DataAceite>20/05/2021</ren1:LC_Ticket>          DataAceite>
     
            </ren1:ListaTickets>
            <ren1:Status>1<LC_VinculoCartaLGPD>
			</ren1:Status>Documentos>
            <ren1:TipoTicket>3<TipoEntidadeID>1</ren1:TipoTicket>TipoEntidadeID>
         </liv:identificacao>
      </liv:AtualizarStatusTicketLCAtualizarVinculoCartaLGPDLC_Integracao>
   </soapenv:Body>
</soapenv:Envelope>
Bloco de código
titleRetorno :
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Body>
		<AtualizarStatusTicketLC      <AtualizarVinculoCartaLGPDLC_IntegracaoResponse xmlns="http://LiveConnector/">
			<AtualizarStatusTicketLC         <AtualizarVinculoCartaLGPDLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				            <a:LC_StatusTicket>
					<ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_StatusTicket</ClassID>
					<Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-03:00</Creation>
					<LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-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 i:nil="true"/>
					<a:Numero>1200101005944801</a:Numero>
					<a:Observacao/>
					<a:StatusRetorno>1</a:StatusRetorno>
				</a:LC_StatusTicket>
				<a:LC_StatusTicket>
					<ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_StatusTicket</ClassID>
					<Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-03:00</Creation>
					<LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-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 i:nil="true"/>
					<a:Numero>1200101005944800</a:Numero>
					<a:Observacao/>
					<a:StatusRetorno>1</a:StatusRetorno>
				</a:LC_StatusTicket>
				<a:LC_StatusTicket>
					<ClassID xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">LC_StatusTicket</ClassID>
					<Creation xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-03:00</Creation>
					<LastUpdate xmlns="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data">2020-12-02T13:32:17.3320704-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 i:nil="true"/>
					<a:Numero>1200101010054600</a:Numero>
					<a:Observacao/>
					<a:StatusRetorno>1</a:StatusRetorno>
				</a:LC_StatusTicket>
			</AtualizarStatusTicketLC_IntegracaoResult>
		</AtualizarStatusTicketLC_IntegracaoResponse>
	</s:Body>
</s:Envelope>

2 - Chamada do método AtualizarStatusTicketLC_Integracao_Xml

Bloco de código
titleChamada:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
	<soapenv:Header/>
	<soapenv:Body>
		<liv:AtualizarStatusTicketLC_Integracao_Xml>
			<liv:codigoSistemaSatelite>2200002811</liv:codigoSistemaSatelite>
			<liv:identificacao><![CDATA[<?xml version="1.0"?><LC_AtualicaoTicket>
				<Chave>c827c0cb-df3b-4872-8153-755f9c57e903</Chave>
				<CodigoSistemaSatelite>2200002000</CodigoSistemaSatelite>
				<TipoTicket>3</TipoTicket>
				<Status>1</Status>
				<ListaTickets>
				<LC_Ticket>
				<Numero>1200101005944800</Numero>
				</LC_Ticket>
				</ListaTickets>
				</LC_AtualicaoTicket>
				]]>
			</liv:identificacao>
		</liv:AtualizarStatusTicketLC_Integracao_Xml>
	</soapenv:Body>
</soapenv:Envelope>
Bloco de código
titleRetorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <AtualizarStatusTicketLC_Integracao_XmlResponse xmlns="http://LiveConnector/">
StatusVinculoCartaLGPD>
               <a:CpfCnpj>77777777777</a:CpfCnpj>
               <a:DescricaoErro/>
               <a:Sucesso>true</a:Sucesso>
            </a:LC_StatusVinculoCartaLGPD>
            <a:LC_StatusVinculoCartaLGPD>
               <a:CpfCnpj>99999999999</a:CpfCnpj>
               <a:DescricaoErro/>
               <a:Sucesso>true</a:Sucesso>
          <AtualizarStatusTicketLC_Integracao_XmlResult>
			<![CDATA[<?xml version="1.0" encoding="utf-8"?>
				<Documentos>
					<LC_StatusTicket>
						<Numero>1200101005835017</Numero>
						<Observacao></Observacao>
						<Status>1</Status>
					</LC_StatusTicket>
				</Documentos>]]>
		</AtualizarStatusTicketLC_Integracao_XmlResult></a:LC_StatusVinculoCartaLGPD>
         </AtualizarVinculoCartaLGPDLC_IntegracaoResult>
      </AtualizarStatusTicketLCAtualizarVinculoCartaLGPDLC_Integracao_XmlResponse>IntegracaoResponse>
   </s:Body>
</s:Envelope>