Árvore de páginas

Versões comparadas

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 do alíquotas de PIS, Cofins e ICMS de produtos onde podem ser consultadas direto no sistema externo para o Live.


Existem dois métodos para incluir clientesAlíquotas:

  • ManterTributoProdutoLC_Integracao:

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


  • ManterTrubutoProdutoLC_Integracao_Xml:

Recebe as informações de entrada no formato XML.

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>Este método é utilizado pelos usuários que por alguma limitação técnica não conseguem manipular o formato padrão.



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

Neste método recebemos como Payload uma lista de 1 ou mais Produtos. Por onde a loja pode ajustar as  Alíquotas de PIS e COFINS dos produtos que estejam relacionados requisição, nossa 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
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 :


ManterTributoProdutoLC_Integracao
COFINS - Cupom Fiscal
PIS - Cupom Fiscal
ICMS


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 ClienteNão
Ativo

Boolean


Sim
CSTVarchar(7)
Sim
CSTEntradaVarchar(3)


Sim
CodigoLojaVarchar(14)
Sim
CodigoNCM

Varchar(20)


Não
CodigoProdutoVarchar(20)
Sim
TipoConfiguracao

Sim
TipoTributoVarchar(10)

Tipos de tributos que podem ser utilizados:

1 - ICM
2 - PIS
3 - COFINS

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-2b52-493c-8125-80863e818bbb</ren1:Chave>
            <ren1:CodigoSistemaSatelite>XXXXXXXX</ren1:CodigoSistemaSatelite>
            <ren1:Data>20210318</ren1:Data>
            <ren1:Hora>111500</ren1:Hora>
            <ren1:Numero>0201209115555679</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</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a:CodigoProduto>30930</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</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>01849558000885</a:CodigoLoja>
                  <a:CodigoNCM/>
                  <a:CodigoProduto>30930</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</liv:codigoSistemaSatelite>
<liv:xmlTicketTributoProduto><![CDATA[<?xml version='1.0' encoding='utf-8'?>
<LC_TicketTributoProduto>
	<Chave>2ca8fb9a-3d8d-4740-a87a-138f5dac47b1</Chave>
	<CodigoSistemaSatelite>05140003</CodigoSistemaSatelite>
	<Data>20210312</Data>
	<Hora>181652</Hora>
	<Numero>2021031214375</Numero>
	<Documentos>
		<LC_TributoProduto>
			<NumeroSequencia>1</NumeroSequencia>
			<Ativo>true</Ativo>
			<CodigoLoja>01849558000885</CodigoLoja>
			<CodigoProduto>30930</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>
			<CodigoProduto>30930</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>01849558000885</CodigoLoja>
			<CodigoProduto>30930</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-2b52-493c-8125-80863e818bbb</Chave><CodigoErro>0</CodigoErro><CodigoSistemaSatelite>05140003</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>