TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 3

changes.mady.by.user Raphael Gomes Cristino

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Raphael Gomes 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:
Informações
iconfalse
titleExemplo de Utilização:

Neste método recebemos como Payload payload uma lista de 1 ou mais Produtostributos. Por onde a loja pode ajustar os tribustos as alíquotas de PIS e COFINS dos produtos que estejam relacionados requisição, nossa 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 alteração de tributo. Caso querira queira fazer mais de um cadastro de tributo 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:


Alíquotas de PIS e COFINS. 

Caminho para acessar as alíquotas 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"


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

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


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
AliquotaImpostoFloat(8)
Apelido do Cliente

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

Boolean


Sim
CSTVarchar(7)
Data denascimento 

Sim
CSTEntradaVarchar(3)

Indica se o Cliente e


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

CodigoNCM

Varchar(20)

Aceite da Carta 


Não
CodigoProdutoVarchar(20)
Data do aceita da
NãoNão

Sim
TipoConfiguracao
Identificação única 


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

  • ICMS
2 -
  • PIS
3 -
  • COFINS
Não
Sim



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>