ManterTributoProdutoLC_Integracao

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

Pré-requisitos

Connector Habilitado:

Exemplo de Utilização:

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

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

Documentos - Campos de Entrada

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: ICMS PIS COFINS	Sim

Exemplo de chamada e retorno do método ManterTributoProdutoLC_Integracao

Chamada método:

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

Retorno método ManterTributoProdutoLC_Integracao :

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

Chamada método: ManterTributoProdutoLC_Integracao_Xml

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

Retorno método ManterTributoProdutoLC_Integracao_Xml :

<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