Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
iconfalse

O método ManterNotaEspelhoLC_Integracao do Live Connector tem a função de Incluir/alterar Nota de Entrada do sistema externo para o Live.


Existem dois métodos para incluir Nota de entrada:

  • ManterNotaEspelhoLC_Integracao :

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


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


Nota
titlePré-requisitos
  •  
    •  Habilitar parâmetros do Connector para Manter Nota Espelho:

                Parâmetro = 116 | LiveConnector - NotaEspelhoSaida (1 = SIM | 0 = NAO)

                Parâmetro Unidade de Negócio = 102| LiveConnector - NotaEspelhoSaida (1 = SIM | 0 = NAO)

    •  Habilitar parâmetros do Fiscal  para Manter Nota Espelho:

                Parâmetro = 2002 | Tipo de Documento para Espelho (EDI)


    Realizar o cadastro de o CFOP caso seja necessário através do seguinte caminho Fiscal > Cadastro > Operações Fiscais:


    Realizar o cadastro de Tipo de Documento através do seguinte caminho Fiscal > Cadastro > Tipo de Documento Fiscal > Novo:


...

1 - No Live Alterar forma de pagamento. (Live\Fiscal\NotasFiscais)

Image Removed

2 - Clicar na setinha ao lado da opção "Novo" e selecionar a opção "Nota fiscal baseada em uma nota espelho"

Image Removed

3 - Em seguida selecionar o tipo "NFCE - ESPELHO (EDI)"  e a data que foi informada no método de "ManterNotaEspelhoLC_Integracao" e clicar no "Pesquisar".

Image Removed

4 - Em seguida clicar na seta ao lado da opção "Selecionar" e selecionar qualquer umas das opções que apresentadas de acordo com a sua necessidade .

Image Removed

Exemplo de consumo Via SoapUI:

Image Removed

Informações
iconfalse
titleExemplo de Utilização:

Neste método recebemos como Payload uma lista de 1 ou mais notas ficando a critério do integrador a quantidade de notas por requisição, nossa recomendação é passar 1(uma) por requisição para maior controle de cada lado da integração e facilitar a abertura de chamados para o Suporte dos sistemas. 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 Added


Após a inclusão via Live Connector pose-se realizar o procedimento abaixo para gerar nota espelho com base na Nota de Entrada:

1 - No Live Alterar forma de pagamento. (Live\Fiscal\NotasFiscais)

Image Added


2 - Clicar na setinha ao lado da opção "Novo" e selecionar a opção "Nota fiscal baseada em uma nota espelho"

Image Added

3 - Em seguida selecionar o tipo "NFCE - ESPELHO (EDI)"  e a data que foi informada no método de "ManterNotaEspelhoLC_Integracao" e clicar no "Pesquisar".

Image Added

4 - Em seguida clicar na seta ao lado da opção "Selecionar" e selecionar qualquer umas das opções que apresentadas de acordo com a sua necessidade .

Image Added




NumeroSequencia
Informações
titleCampos 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



Aviso
titleImportante

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

Nota(Campos)

Tipo

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

Numero sequencia do documento implementar a cada documento.

Ex: 1

Sim
Informações
titleCampos de retorno
Pivot Table
id1581521954499_556941873

Dodumentos

Tipo


CNPJFornecedor

Varchar(20)




CNPJUnidadeNegocio

Varchar(20)




CPFFuncionario

Varchar(20)




CategoriaFiscalUnidadeNegocio

Varchar(5)




ChaveNfe

Varchar(44)




CodigoSetorIndustrial

Varchar(8000)




DataEmissaoDateTime


DescricaoSetorIndustrial

Varchar(50)




DescricaoSetorIndustrialVarchar(50)


ExcluirBoolean


ModeloVarchar(2)


NomeEntidade

Varchar(100)




NomeUnidadeNegocio

Varchar(50)




NumeroDocumentoFornecedor

Varchar(10)




NumeroLogNfe

Varchar(15)




NumeroNotaInt


NumeroNotaFiscalE

Varchar(16)




NumeroOrdemVenda

Varchar(10)




QuantidadeItens

Long




StatusNota

Varchar(1)




TipoNota

Varchar(4)




TotalCOFINSDouble


TotalDescontosDouble


TotalICMSDouble


TotalIPIDouble


TotalPISDouble


TotalProdutosDouble


ValorLiquidoNotaDouble


ValorNotaDouble


Itens

Tipo

Descrição/ FormatoObrigatório?Observação
BaseFCP?


BaseFCPRet?


BaseFCPST?


CFOP

Varchar(10)




ClassificacaoTributariaICMS?


ClassificacaoTributariaICMSSubstituicao?


CodigoDescricaoFiscalICMSVarchar(4)


CodigoItemNota

Varchar(20)




CodigoLoja

Varchar(20)




DescontoUnitarioItemNotaDouble


DescricaoOperacaoFiscalVarchar(50)


DescricaoProdutoVarchar(200)


IDItemPedido

Guid




IcmsItemNotaDouble


IpiItemNotaDouble


ItemPedidoInt


ItemPedidoFornecedorInt


ItemPedidoPracticoInt


Linha1DescricaoFiscalICMS

Varchar(200)




Linha2DescricaoFiscalICMS

Varchar(200)




Linha3DescricaoFiscalICMS

Varchar(200)




Linha4DescricaoFiscalICMS

Varchar(200)




LoteItemNota

Varchar(3)




NumeroNota

Varchar(6)




NumeroOrdemVendaVarchar(10)


NumeroPedidoFornecedorVarchar(20)


NumeroPedidoPractico

Varchar(6)




Observacao

Varchar(500)




OrigemPedidoDouble


PercFCPDouble


PercFCPRet

Double




PercFCPSTDouble


PercentualCOFINSDouble


PercentualICMSDouble


PercentualICMSSubstituicaoDouble


PercentualIPIDouble


PercentualISSDouble


PercentualIVADouble


PercentualPISDouble


PercentualReducaoICMSDouble


PercentualReducaoIPIDouble


PosicaoItemNota

Varchar(5)




PrecoUnitarioItemNotaDouble


QuantidadeDevolvidaItemNotaDouble


QuantidadeRecebidaItemNotaDouble


TipoItemNota

Char(1)




TotalDespesasDouble


TotalICMSItemNotaDouble


ValorBaseCOFINSDouble


ValorBaseICMSDouble


ValorBaseICMSSubstituicaoDouble


ValorBaseIPIDouble


ValorBaseISSDouble


ValorBasePISDouble


ValorBrutoDouble


ValorCOFINSDouble


ValorFCPDouble


ValorFCPRetDouble


ValorFCPSTDouble


ValorICMSDouble


ValorICMSSubstituicaoDouble


ValorIPIDouble


ValorISSDouble


ValorLiquidoDouble


ValorPISDouble


ValorTaxaServicoDouble


ValorTributosDouble




Informações
titleExemplo de Chamada do Método
Bloco de código
titleChamada:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <ManterNotaEspelhoLC_Integracao xmlns="http://LiveConnector/">
      <publicDomain>00000000-0000-0000-0000-000000000000</publicDomain>
      <protectedDomain>00000000-0000-0000-0000-000000000000</protectedDomain>
      <notaEspelho xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</a:Chave>
        <a:CodigoSistemaSatelite>05140003</a:CodigoSistemaSatelite>
        <a:Data>20200330</a:Data>
        <a:Hora>084000</a:Hora>
        <a:Numero>XXXXXXXXXXXX</a:Numero>
        <a:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <b:anyType i:type="a:LC_NotaEspelho">
            <a:NumeroSequencia>1</a:NumeroSequencia>
            <a:CNPJFornecedor>XXXXXXXXXXXXXX</a:CNPJFornecedor>
            <a:CNPJUnidadeNegocio>XXXXXXXXXXXXXX</a:CNPJUnidadeNegocio>
            <a:CPFFuncionario i:nil="true"/>
            <a:CategoriaFiscalUnidadeNegocio i:nil="true"/>
            <a:ChaveNfe>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</a:ChaveNfe>
            <a:CodigoSetorIndustrial i:nil="true"/>
            <a:DataEmissao>2020-03-30T08:00:00</a:DataEmissao>
            <a:DescricaoSetorIndustrial i:nil="true"/>
            <a:DescricaoSetorIndustrial i:nil="true"/>
            <a:Excluir>false</a:Excluir>
            <a:Itens>
              <b:anyType i:type="a:LC_ItemNotaEspelho">
			    <a:BaseFCP>28.20</a:BaseFCP>
				<a:BaseFCPRet>28.20</a:BaseFCPRet>
				<a:BaseFCPST>28.20</a:BaseFCPST>
                <a:CFOP>1403</a:CFOP>
				<a:ClassificacaoTributariaICMS></a:ClassificacaoTributariaICMS>
				<a:ClassificacaoTributariaICMSSubstituicao></a:ClassificacaoTributariaICMSSubstituicao>
                <a:CodigoDescricaoFiscalICMS i:nil="true"/>
                <a:CodigoItemNota>13131</a:CodigoItemNota>
                <a:CodigoLoja i:nil="true"/>
                <a:DescontoUnitarioItemNota>0</a:DescontoUnitarioItemNota>
                <a:DescricaoOperacaoFiscal i:nil="true"/>
                <a:DescricaoProduto i:nil="true"/>
                <a:IDItemPedido>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</a:IDItemPedido>
                <a:IcmsItemNota>0</a:IcmsItemNota>
                <a:IpiItemNota>0</a:IpiItemNota>
                <a:ItemPedido>0</a:ItemPedido>
                <a:ItemPedidoFornecedor>0</a:ItemPedidoFornecedor>
                <a:ItemPedidoPractico>0</a:ItemPedidoPractico>
                <a:Linha1DescricaoFiscalICMS i:nil="true"/>
                <a:Linha2DescricaoFiscalICMS i:nil="true"/>
                <a:Linha3DescricaoFiscalICMS i:nil="true"/>
                <a:Linha4DescricaoFiscalICMS i:nil="true"/>
                <a:LoteItemNota i:nil="true"/>
                <a:NumeroNota i:nil="true"/>
                <a:NumeroOrdemVenda i:nil="true"/>
                <a:NumeroPedidoFornecedor i:nil="true"/>
                <a:NumeroPedidoPractico i:nil="true"/>
                <a:Observacao i:nil="true"/>
                <a:OrigemPedido>0</a:OrigemPedido>
				<a:PercFCP>2</a:PercFCP>
				<a:PercFCPRet>2</a:PercFCPRet>
				<a:PercFCPST>2</a:PercFCPST>
                <a:PercentualCOFINS>3</a:PercentualCOFINS>
                <a:PercentualICMS>0</a:PercentualICMS>
                <a:PercentualICMSSubstituicao>12</a:PercentualICMSSubstituicao>
                <a:PercentualIPI>0</a:PercentualIPI>
                <a:PercentualISS>0</a:PercentualISS>
                <a:PercentualIVA>0</a:PercentualIVA>
                <a:PercentualPIS>0.65</a:PercentualPIS>
                <a:PercentualReducaoICMS>0</a:PercentualReducaoICMS>
                <a:PercentualReducaoIPI>0</a:PercentualReducaoIPI>
                <a:PosicaoItemNota>1</a:PosicaoItemNota>
                <a:PrecoUnitarioItemNota>53.389</a:PrecoUnitarioItemNota>
                <a:QuantidadeDevolvidaItemNota>0</a:QuantidadeDevolvidaItemNota>
                <a:QuantidadeRecebidaItemNota>20</a:QuantidadeRecebidaItemNota>
                <a:TipoItemNota i:nil="true"/>
                <a:TotalDespesas>0</a:TotalDespesas>
                <a:TotalICMSItemNota>5.08</a:TotalICMSItemNota>
                <a:ValorBaseCOFINS>28.20</a:ValorBaseCOFINS>
                <a:ValorBaseICMS>0</a:ValorBaseICMS>
                <a:ValorBaseICMSSubstituicao>28.20</a:ValorBaseICMSSubstituicao>
                <a:ValorBaseIPI>28.20</a:ValorBaseIPI>
                <a:ValorBaseISS>0</a:ValorBaseISS>
                <a:ValorBasePIS>28.20</a:ValorBasePIS>
                <a:ValorBruto>33.289</a:ValorBruto>
                <a:ValorCOFINS>3</a:ValorCOFINS>
				<a:ValorFCP>0.56</a:ValorFCP>
				<a:ValorFCPRet>0.56</a:ValorFCPRet>
				<a:ValorFCPST>0.56</a:ValorFCPST>
                <a:ValorICMS>0</a:ValorICMS>
                <a:ValorICMSSubstituicao>5.08</a:ValorICMSSubstituicao>
                <a:ValorIPI>0</a:ValorIPI>
                <a:ValorISS>0</a:ValorISS>
                <a:ValorLiquido>318.459</a:ValorLiquido>
                <a:ValorPIS>525</a:ValorPIS>
                <a:ValorTaxaServico>0</a:ValorTaxaServico>
                <a:ValorTributos>0</a:ValorTributos>
              </b:anyType>
            </a:Itens>
            <a:Modelo i:nil="true"/>
            <a:NomeEntidade i:nil="true"/>
            <a:NomeUnidadeNegocio i:nil="true"/>
            <a:NumeroDocumentoFornecedor i:nil="true"/>
            <a:NumeroLogNfe i:nil="true"/>
            <a:NumeroNota>XXXXXXXXX</a:NumeroNota>
            <a:NumeroNotaFiscalE></a:NumeroNotaFiscalE>
            <a:NumeroOrdemVenda/>
            <a:QuantidadeItens>0</a:QuantidadeItens>
            <a:StatusNota i:nil="true"/>
            <a:TipoNota i:nil="true"/>
            <a:TotalCOFINS>0</a:TotalCOFINS>
            <a:TotalDescontos>0</a:TotalDescontos>
            <a:TotalICMS>5.08</a:TotalICMS>
            <a:TotalIPI>0</a:TotalIPI>
            <a:TotalPIS>0.18</a:TotalPIS>
            <a:TotalProdutos>28.20</a:TotalProdutos>
            <a:ValorLiquidoNota>28.20</a:ValorLiquidoNota>
            <a:ValorNota>28.20</a:ValorNota>
          </b:anyType>
        </a:Documentos>
      </notaEspelho>
    </ManterNotaEspelhoLC_Integracao>
  </s:Body>
</s:Envelope>

Bloco de código
titleChamada: XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <liv:ManterNotaEspelhoLC_Integracao_Xml>
         <liv:codigoSistemaSatelite>XXXXXXXX</liv:codigoSistemaSatelite>
         <liv:xmlTicketNotaEspelho><![CDATA[<?xml version="1.0" encoding="utf-8"?>
		<LC_TicketNotaEspelho xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  			<Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</Chave>
  			<CodigoSistemaSatelite>XXXXXXXX</CodigoSistemaSatelite>
  			<Data>20180206</Data>
  			<Hora>120000</Hora>
  			<Numero>XXXXXXXXXXXX</Numero>
  			  <Documentos>
			<LC_NotaEspelho>
				<NumeroSequencia>1</NumeroSequencia>
				<CNPJFornecedor>XXXXXXXXXXXXXX</CNPJFornecedor>
				<CNPJUnidadeNegocio>XXXXXXXXXXXXXX</CNPJUnidadeNegocio>
				<CPFFuncionario/>
				<CategoriaFiscalUnidadeNegocio/>
				<ChaveNfe>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</ChaveNfe>
				<CodigoSetorIndustrial/>
				<DataEmissao>2018-08-23T00:00:00</DataEmissao>
				<DescricaoSetorIndustrial/>
				<DescricaoTipoDocumento/>
				<Excluir>false</Excluir>
				<Modelo/>
				<NomeEntidade/>
				<NomeUnidadeNegocio/>
				<NumeroDocumentoFornecedor/>
				<NumeroLogNfe/>
				<NumeroNota>109097</NumeroNota>
				<NumeroNotaFiscalE>XXXXXXXXX</NumeroNotaFiscalE>
				<NumeroOrdemVenda/>
				<QuantidadeItens>0</QuantidadeItens>
				<StatusNota/>
				<TipoNota/>
				<TotalCOFINS>2420</TotalCOFINS>
				<TotalDescontos>0</TotalDescontos>
				<TotalICMS>38.21</TotalICMS>
				<TotalIPI>0</TotalIPI>
				<TotalPIS>525</TotalPIS>
				<TotalProdutos>318.45</TotalProdutos>
				<ValorLiquidoNota>318.45</ValorLiquidoNota>
				<ValorNota>318.45</ValorNota>
		        <Itens>
					<LC_ItemNotaEspelho>
		                <CFOP></CFOP>
		                <CodigoDescricaoFiscalICMS/>
		                <CodigoItemNota>27953</CodigoItemNota>
		                <CodigoLoja/>
		                <DescontoUnitarioItemNota>0</DescontoUnitarioItemNota>
		                <DescricaoOperacaoFiscal/>
		                <DescricaoProduto/>
		                <IDItemPedido>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</IDItemPedido>
		                <IcmsItemNota>0</IcmsItemNota>
		                <IpiItemNota>0</IpiItemNota>
		                <ItemPedido>0</ItemPedido>
		                <ItemPedidoFornecedor>0</ItemPedidoFornecedor>
		                <ItemPedidoPractico>0</ItemPedidoPractico>
		                <Linha1DescricaoFiscalICMS/>
		                <Linha2DescricaoFiscalICMS/>
		                <Linha3DescricaoFiscalICMS/>
		                <Linha4DescricaoFiscalICMS/>
		                <LoteItemNota/>
		                <NumeroNota/>
		                <NumeroOrdemVenda/>
		                <NumeroPedidoFornecedor/>
		                <NumeroPedidoPractico/>
		                <Observacao/>
		                <OrigemPedido>0</OrigemPedido>
		                <PercentualCOFINS>1.65</PercentualCOFINS>
		                <PercentualICMS>12</PercentualICMS>
		                <PercentualICMSSubstituicao>0</PercentualICMSSubstituicao>
		                <PercentualIPI>0</PercentualIPI>
		                <PercentualISS>0</PercentualISS>
		                <PercentualIVA>0</PercentualIVA>
		                <PercentualPIS>1.65</PercentualPIS>
		                <PercentualReducaoICMS>0</PercentualReducaoICMS>
		                <PercentualReducaoIPI>0</PercentualReducaoIPI>
		                <PosicaoItemNota>1</PosicaoItemNota>
		                <PrecoUnitarioItemNota>21.23</PrecoUnitarioItemNota>
		                <QuantidadeDevolvidaItemNota>0</QuantidadeDevolvidaItemNota>
		                <QuantidadeRecebidaItemNota>15</QuantidadeRecebidaItemNota>
		                <TipoItemNota/>
		                <TotalDespesas>0</TotalDespesas>
		                <TotalICMSItemNota>38.21</TotalICMSItemNota>
		                <ValorBaseCOFINS>318.45</ValorBaseCOFINS>
		                <ValorBaseICMS>318.45</ValorBaseICMS>
		                <ValorBaseICMSSubstituicao>0</ValorBaseICMSSubstituicao>
		                <ValorBaseIPI>318.45</ValorBaseIPI>
		                <ValorBaseISS>0</ValorBaseISS>
		                <ValorBasePIS>31845</ValorBasePIS>
		                <ValorBruto>318.45</ValorBruto>
		                <ValorCOFINS>5.25</ValorCOFINS>
		                <ValorICMS>38.21</ValorICMS>
		                <ValorICMSSubstituicao>0</ValorICMSSubstituicao>
		                <ValorIPI>0</ValorIPI>
		                <ValorISS>0</ValorISS>
		                <ValorLiquido>318.45</ValorLiquido>
		                <ValorPIS>525</ValorPIS>
		                <ValorTaxaServico>0</ValorTaxaServico>
		                <ValorTributos>0</ValorTributos>
						<ValorFCP>0.56</ValorFCP>
		                <BaseFCP>28.20</BaseFCP>
		                <PercFCP>2</PercFCP>
						<ValorFCPST>0.56</ValorFCPST>
		                <BaseFCPST>28.20</BaseFCPST>
		                <PercFCPST>2</PercFCPST>
						<ValorFCPRet>0.56</ValorFCPRet>
		                <BaseFCPRet>28.20</BaseFCPRet>
		                <PercFCPRet>2</PercFCPRet>
		                <ValorTaxaServico>0</ValorTaxaServico>
		                <ValorTributos>0</ValorTributos>
						<ClassificacaoTributariaICMSSubstituicao></ClassificacaoTributariaICMSSubstituicao>
						<ClassificacaoTributariaICMS></ClassificacaoTributariaICMS>
		            </LC_ItemNotaEspelho>
		        </Itens>
			</LC_NotaEspelho>
		  </Documentos>
  		 </LC_TicketNotaEspelho>]]>
         </liv:xmlTicketNotaEspelho>
	 </liv:ManterNotaEspelhoLC_Integracao_Xml>
   </soapenv:Body>
</soapenv:Envelope>

Bloco de código
titleRetorno:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterNotaEspelhoLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterNotaEspelhoLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterNotaEspelhoLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>