TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 2

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

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.

TipoEnderecoTipoEnderecoTipoDocumentoCliente

Informações
iconfalse

O método ManterTributoProdutoLC_Integracao do Live Connector tem a função de Incluir/alterar clientes alíquotas de PIS, Cofins e ICMS de produtos direto do sistema externo para o Live.


Existem dois métodos para incluir clientesAlíquotas:

  • ManterTributoProdutoLC_Integracao:

Recebe Objeto Xml no formato Rentech.PracticoLive.Connector.Objects este é o método Padrão e usado pela maioria dos usuáriosusuário

Ao enviar uma requisição devemos nos atentar no campo "AliquotaImposto" a separação do valor deve ser com "Ponto"

Exemplo:  <a:AliquotaImposto>21.01</a:AliquotaImposto>


  • ManterTrubutoProdutoLC_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.

Ao enviar uma requisição devemos nos atentar no campo "AliquotaImposto" a separação do valor deve ser com "Virgula"

Exemplo:  <AliquotaImposto>13,6</AliquotaImposto>


Compatibilidade
Ambiente SAAS
  •     

Ambiente OnPremise

  •     
Nota
titlePré-requisitos
  •  Connector Habilitado: Classificador de cliente pré cadastrado para enviar na requisição:
Informações
iconfalse
titleExemplo de Utilização:

Neste método recebemos como Payload payload uma lista de 1 ou mais clientestributos. Fica a critério do integrador a quantidade de clientes por requisição, nossa Por onde a loja pode ajustar as alíquotas de PIS e COFINS que se referem as informações de cupons e o CST relacionado ao ICMS Nfe, 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 alteração de tributo. Caso queira fazer mais de um cadastro de alíquota em uma requisição, 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
titleDICA 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:

Image Modified


Alíquotas de PIS e COFINS. 

Caminho para acessar no Live → Fiscal → Cadastros → Tributação de Pis e Cofins por Produto / N.C.M :


Tributo Entidade
COFINSCupom Fiscal
PISCupom Fiscal
ICMSNFe


Obs:  Os tributos para NFCe não são tratados nesse método e sim no no método "ManterSituacaoVendaProdutoLC_Integracao"


Image Added

Após acessar o caminho o sistemas apresenta a seguinte tela "Consulta Tributação de Pis e Cofins por Produto / N.C.M"

Image Added

Para validar se as alíquotas que foram cadastrados devemos realizar uma pesquisa informando o produto que estava na requisição e clicando em "Filtrar":

Image Added


Alíquotas de ICMS. 

Caminho para acessar no Live → Fiscal → Cadastros → Tributação de I.C.M.S por Produto / N.C.M :

Image Added


Após acessar o caminho o sistemas apresenta a seguinte tela "Consulta Tributação de I.C.M.S por Produto / N.C.M"

Image Added

Para validar se as alíquotas que foram cadastrados devemos realizar uma pesquisa informando o produto que estava na requisição e clicando em "Filtrar":

Image Added


Informações
titleParâmetros de Entrada
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
Informações
titleDocumentos - Campos de Entrada
Aviso
titleImportante

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

Cliente (Campos)

Tipo

Descrição/ FormatoObrigatório?Observação
NumeroSequenciaVarchar(6)

Numero sequencia do documento implementar a cada documento.

Ex: 1

Sim
AliquotaImposto
Varchar
Float(
100
8)
Apelido do ClienteNãoAtivo

Varchar(20)


NãoQuando o campos "TipoTributo = ICMS" essa campo não precisa ser informado.
Ativo

Boolean

Numero do documento do Cliente


Sim
CST
DatetimeData de nascimento do cliente  ex:
Varchar(7)
Sim
CSTEntrada
Boolean

Indica se o Cliente está inativo.

Valor padrão =  Falso

Não
Varchar(3)


SimValor para atualizar o campo CST de PIS ou COFINS.
CodigoLojaVarchar(
120
14)
Indicação do cliente.
CNPJ da LojaSim
Não

CodigoNCM

Boolean

Aceite da Carta LGPD

Varchar(20)


Não
CodigoProduto
Datetime
Data do aceita da carta LGPD ex:
aaaa/mm/dd
NãoTipoConfiguracaoGuidIdentificação única interna LGPDNão
Varchar(20)
Sim
TipoConfiguracao

Sim
TipoTributoVarchar(10)
  • Tipos de tributos que podem ser utilizados:

    ICMS
    PIS
    COFINS
Sim
TipoTributoarray list

Lista de classificação do cliente.

Não



Informações
titleExemplo de chamada e retorno do método ManterTributoProdutoLC_Integracao
Bloco de código
themeConfluence
titleChamada método:
linenumberstrue
<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" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   <soapenv:Header/>
   <soapenv:Body>
      <liv:ManterTributoProdutoLC_Integracao>
         <liv:tributoProduto xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <ren1:Chave>58986166-2b520000-493c-81250000-80863e818bbb</ren1:Chave>
            <ren1:CodigoSistemaSatelite>XXXXXXXX</ren1:CodigoSistemaSatelite>
            <ren1:Data>20210318</ren1:Data>
            <ren1:Hora>111500</ren1:Hora>
            <ren1:Numero>0201209115555679<Numero>00000000000000</ren1:Numero>
            <ren1:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
               <b:anyType i:type="a:LC_TributoProduto">
                  <a:NumeroSequencia>001</a:NumeroSequencia>
                  <a:AliquotaImposto>13.56</a:AliquotaImposto>
                  <a:Ativo>true</a:Ativo>
                  <a:CST>7</a:CST>
                  <a:CSTEntrada>0</a:CSTEntrada>
                  <a:CodigoLoja>01849558000885<CodigoLoja>00000000000000</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a:CodigoProduto>30930<CodigoProduto>00000</a:CodigoProduto>
                  <a:TipoConfiguracao>PRODUTO</a:TipoConfiguracao>
                  <a:TipoTributo>COFINS</a:TipoTributo>
               </b:anyType>
               <b:anyType i:type="a:LC_TributoProduto">
                  <a:NumeroSequencia>001</a:NumeroSequencia>
                  <a:AliquotaImposto>8.77</a:AliquotaImposto>
                  <a:Ativo>true</a:Ativo>
                  <a:CST>7</a:CST>
                  <a:CSTEntrada>0</a:CSTEntrada>
                  <a:CodigoLoja>01849558000885<CodigoLoja>00000000000000</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a:CodigoProduto>30930</a:CodigoProduto>
                  <a:TipoConfiguracao>PRODUTO</a:TipoConfiguracao>
                  <a:TipoTributo>PIS</a:TipoTributo>
               </b:anyType>
			   <b:anyType i:type="a:LC_TributoProduto">
                  <a:NumeroSequencia>001</a:NumeroSequencia>
                  <a:AliquotaImposto>13.56</a:AliquotaImposto>
                  <a:Ativo>true</a:Ativo>
                  <a:CST>7</a:CST>
                  <a:CSTEntrada>0</a:CSTEntrada>
                  <a:CodigoLoja>00000000000000</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a:CodigoProduto>00000</a:CodigoProduto>
                  <a:TipoConfiguracao>PRODUTO</a:TipoConfiguracao>
                  <a:TipoTributo>ICMS</a:TipoTributo>
               </b:anyType>
            </ren1:Documentos>
         </liv:tributoProduto>
      </liv:ManterTributoProdutoLC_Integracao>
   </soapenv:Body>
</soapenv:Envelope>
Bloco de código
themeConfluence
titleRetorno método ManterTributoProdutoLC_Integracao :
linenumberstrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterTributoProdutoLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterTributoProdutoLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterTributoProdutoLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>
Bloco de código
themeConfluence
titleChamada método: ManterTributoProdutoLC_Integracao_Xml
linenumberstrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
<soapenv:Header/>
<soapenv:Body>
<liv:ManterTributoProdutoLC_Integracao_Xml>
<liv:codigoSistemaSatelite>05140003<codigoSistemaSatelite>00000000</liv:codigoSistemaSatelite>
<liv:xmlTicketTributoProduto><![CDATA[<?xml version='1.0' encoding='utf-8'?>
<LC_TicketTributoProduto>
	<Chave>2ca8fb9a-3d8d0000-47400000-a87a0000-138f5dac47b1</Chave>
	<CodigoSistemaSatelite>05140003<<CodigoSistemaSatelite>00000000</CodigoSistemaSatelite>
	<Data>20210312</Data>
	<Hora>181652</Hora>
	<Numero>2021031214375<<Numero>00000000000000</Numero>
	<Documentos>
		<LC_TributoProduto>
			<NumeroSequencia>1</NumeroSequencia>
			<Ativo>true</Ativo>
			<CodigoLoja>01849558000885<<CodigoLoja>00000000000000</CodigoLoja>
			<CodigoProduto>30930<<CodigoProduto>00000</CodigoProduto>
			<CST>07</CST>
			<CSTEntrada>0</CSTEntrada>
			<TipoConfiguracao>PRODUTO</TipoConfiguracao>
			<TipoTributo>COFINS</TipoTributo>
			<AliquotaImposto>13,6</AliquotaImposto>
			<CodigoNCM/>
		</LC_TributoProduto>
		<LC_TributoProduto>
			<NumeroSequencia>2</NumeroSequencia>
			<Ativo>true</Ativo>
			<CodigoLoja>01849558000885<<CodigoLoja>00000000000000</CodigoLoja>
			<CodigoProduto>30930<<CodigoProduto>00000</CodigoProduto>
			<CST>07</CST>
			<CSTEntrada>0</CSTEntrada>
			<TipoConfiguracao>PRODUTO</TipoConfiguracao>
			<TipoTributo>PIS</TipoTributo>
			<AliquotaImposto>5,99</AliquotaImposto>
			<CodigoNCM/>
		</LC_TributoProduto>
		<LC_TributoProduto>
			<NumeroSequencia>2</NumeroSequencia>
			<Ativo>true</Ativo>
			<CodigoLoja>00000000000000</CodigoLoja>
			<CodigoProduto>00000</CodigoProduto>
			<CST>07</CST>
			<CSTEntrada>0</CSTEntrada>
			<TipoConfiguracao>PRODUTO</TipoConfiguracao>
			<TipoTributo>ICMS</TipoTributo>
			<AliquotaImposto>5,99</AliquotaImposto>
			<CodigoNCM/>
		</LC_TributoProduto>
	</Documentos>
</LC_TicketTributoProduto>]]></liv:xmlTicketTributoProduto>
</liv:ManterTributoProdutoLC_Integracao_Xml>
</soapenv:Body>
</soapenv:Envelope>
Bloco de código
themeConfluence
titleRetorno método ManterTributoProdutoLC_Integracao_Xml :
linenumberstrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterTributoProdutoLC_Integracao_XmlResponse xmlns="http://LiveConnector/">
         <ManterTributoProdutoLC_Integracao_XmlResult><![CDATA[<?xml version="1.0" encoding="utf-8"?><Resultado><LC_Retorno><Chave>58986166-2b520000-493c0000-8125-80863e818bbb</Chave><CodigoErro>0</CodigoErro><CodigoSistemaSatelite>05140003<CodigoErro><CodigoSistemaSatelite>00000000</CodigoSistemaSatelite><Data>22/03/2021</Data><DescricaoErro>Processamento realizado com sucesso</DescricaoErro><Hora>12:33</Hora><NumeroSequencia>0</NumeroSequencia><NumeroTicket>0</NumeroTicket></LC_Retorno></Resultado>]]></ManterTributoProdutoLC_Integracao_XmlResult>
      </ManterTributoProdutoLC_Integracao_XmlResponse>
   </s:Body>
</s:Envelope>