Histórico da Página

Informações

icon	false

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

Existem dois métodos para incluir Alíquotas:

ManterTributoProdutoLC_Integracao:

Recebe Objeto Xml no formato Rentech.PracticoLive.Connector.Objects este é o método Padrão e usado pela maioria dos usuá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

title	Pré-requisitos

Connector Habilitado:

Informações

icon	false
title	Exemplo de Utilização:

Neste método recebemos como payload uma lista de 1 ou mais produtostributos. 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 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

title	DICA 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 no Live → Fiscal → Cadastros → Tributação de Pis e Cofins por Produto / N.C.M :

Tributo	Entidade
COFINS	Cupom Fiscal
PIS	Cupom Fiscal
ICMS	NFe

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 :

Após acessar o caminho o sistemas apresenta a seguinte tela "Consulta Tributação de I.C.M.S 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":

...

Informações

title	Documentos - Campos de Entrada

Aviso

title	Importante

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

Cliente (Campos)	Tipo	Descrição/ Formato	Obrigatório?	Observação
NumeroSequencia	Varchar(6)	Numero sequencia do documento implementar a cada documento. Ex: 1	Sim
AliquotaImposto	Float(8)		Não	Quando o campos "TipoTributo = ICMS" essa campo não precisa ser informado.
Ativo	Boolean		Sim
CST	Varchar(7)		Sim
CSTEntrada	Varchar(3)		Sim	Valor para atualizar o campo CST de PIS ou COFINS.
CodigoLoja	Varchar(14)	CNPJ da Loja	Sim
CodigoNCM	Varchar(20)		Não
CodigoProduto	Varchar(20)		Sim
TipoConfiguracao			Sim
TipoTributo	Varchar(10)	Tipos de tributos que podem ser utilizados: ICM ICMS PIS COFINS	Sim

Informações

title	Exemplo de chamada e retorno do método ManterTributoProdutoLC_Integracao

Bloco de código

theme	Confluence
title	Chamada método:
linenumbers	true

<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-0000-493c-0000-80863e818bbb</ren1:Chave>
            <ren1:CodigoSistemaSatelite>XXXXXXXX</ren1:CodigoSistemaSatelite>
            <ren1:Data>20210318</ren1:Data>
            <ren1:Hora>111500</ren1:Hora>
            <ren1: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>00000000000000</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a: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>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

theme	Confluence
title	Retorno método ManterTributoProdutoLC_Integracao :
linenumbers	true

<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

theme	Confluence
title	Chamada método: ManterTributoProdutoLC_Integracao_Xml
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
<soapenv:Header/>
<soapenv:Body>
<liv:ManterTributoProdutoLC_Integracao_Xml>
<liv:codigoSistemaSatelite>00000000</liv:codigoSistemaSatelite>
<liv:xmlTicketTributoProduto><![CDATA[<?xml version='1.0' encoding='utf-8'?>
<LC_TicketTributoProduto>
	<Chave>2ca8fb9a-0000-0000-0000-138f5dac47b1</Chave>
	<CodigoSistemaSatelite>00000000</CodigoSistemaSatelite>
	<Data>20210312</Data>
	<Hora>181652</Hora>
	<Numero>00000000000000</Numero>
	<Documentos>
		<LC_TributoProduto>
			<NumeroSequencia>1</NumeroSequencia>
			<Ativo>true</Ativo>
			<CodigoLoja>00000000000000</CodigoLoja>
			<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>00000000000000</CodigoLoja>
			<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

theme	Confluence
title	Retorno método ManterTributoProdutoLC_Integracao_Xml :
linenumbers	true

<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-0000-0000-8125-80863e818bbb</Chave><CodigoErro>0</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>

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 11

Nova versão Atual

Chave