Exibir origem

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.

Compatibilidade
Ambiente SAAS
Ambiente OnPremise

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

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:

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:

TOTVS Varejo Franquias e Redes > ManterNotaEspelhoLC_Integracao > image2020-4-7_13-4-40.png

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)

TOTVS Varejo Franquias e Redes > ManterNotaEspelhoLC_Integracao > image2020-4-7_9-13-25.png

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

TOTVS Varejo Franquias e Redes > ManterNotaEspelhoLC_Integracao > image2020-4-7_9-19-52.png

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

TOTVS Varejo Franquias e Redes > ManterNotaEspelhoLC_Integracao > image2020-4-7_12-17-6.png

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 .

TOTVS Varejo Franquias e Redes > ManterNotaEspelhoLC_Integracao > image2020-4-7_12-24-45.png

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

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

Nota(Campos)	Tipo	Descrição/ Formato	Obrigatório?	Observação
NumeroSequencia	Varchar(6)	Numero sequencia do documento implementar a cada documento. Ex: 1	Sim
CNPJFornecedor	Varchar(20)	CNPJ do Fornecedor dos produtos da Nota	Sim
CNPJUnidadeNegocio	Varchar(20)	CNPJ da unidade de negócio(Loja) onde os produtos serão recebidos.
CPFFuncionario	Varchar(20)
CategoriaFiscalUnidadeNegocio	Varchar(5)
ChaveNfe	Varchar(44)	Chave na Nota fiscal	Sim
CodigoSetorIndustrial	Varchar(8000)
DataEmissao	DateTime
DescricaoSetorIndustrial	Varchar(50)
DescricaoSetorIndustrial	Varchar(50)
Excluir	Boolean
Itens	Lista	Lista de Itens da nota	Sim
Modelo	Varchar(2)
NomeEntidade	Varchar(100)
NomeUnidadeNegocio	Varchar(50)
NumeroDocumentoFornecedor	Varchar(10)
NumeroLogNfe	Varchar(15)
NumeroNota	Int
NumeroNotaFiscalE	Varchar(16)
NumeroOrdemVenda	Varchar(10)
QuantidadeItens	Long
StatusNota	Varchar(1)
TipoNota	Varchar(4)
TotalCOFINS	Double
TotalDescontos	Double
TotalICMS	Double
TotalIPI	Double
TotalPIS	Double
TotalProdutos	Double
ValorLiquidoNota	Double
ValorNota	Double

Itens	Tipo	Descrição/ Formato	Obrigatório?	Observação
BaseFCP	?
BaseFCPRet	?
BaseFCPST	?
CFOP	Varchar(10)	CFOP( Código Fiscal de Operações e Prestação) para o Item CFOP deve estar previamente cadastrado no Live. Ver item pré-requisitos para mais detalhes.	Sim
ClassificacaoTributariaICMS	?
ClassificacaoTributariaICMSSubstituicao	?
CodigoDescricaoFiscalICMS	Varchar(4)
CodigoItemNota	Varchar(20)	Código do Produto da nota	Sim
CodigoLoja	Varchar(20)
DescontoUnitarioItemNota	Double
DescricaoOperacaoFiscal	Varchar(50)
DescricaoProduto	Varchar(200)
IDItemPedido	Guid
IcmsItemNota	Double
IpiItemNota	Double
ItemPedido	Int
ItemPedidoFornecedor	Int
ItemPedidoPractico	Int
Linha1DescricaoFiscalICMS	Varchar(200)
Linha2DescricaoFiscalICMS	Varchar(200)
Linha3DescricaoFiscalICMS	Varchar(200)
Linha4DescricaoFiscalICMS	Varchar(200)
LoteItemNota	Varchar(3)
NumeroNota	Varchar(6)
NumeroOrdemVenda	Varchar(10)
NumeroPedidoFornecedor	Varchar(20)
NumeroPedidoPractico	Varchar(6)
Observacao	Varchar(500)
OrigemPedido	Double
PercFCP	Double
PercFCPRet	Double
PercFCPST	Double
PercentualCOFINS	Double
PercentualICMS	Double
PercentualICMSSubstituicao	Double
PercentualIPI	Double
PercentualISS	Double
PercentualIVA	Double
PercentualPIS	Double
PercentualReducaoICMS	Double
PercentualReducaoIPI	Double
PosicaoItemNota	Varchar(5)	Posição do item na Nota. Ex: 1 para o primeiro item 2 para o segundo item	Sim
PrecoUnitarioItemNota	Double
QuantidadeDevolvidaItemNota	Double
QuantidadeRecebidaItemNota	Double
TipoItemNota	Char(1)
TotalDespesas	Double
TotalICMSItemNota	Double
ValorBaseCOFINS	Double
ValorBaseICMS	Double
ValorBaseICMSSubstituicao	Double
ValorBaseIPI	Double
ValorBaseISS	Double
ValorBasePIS	Double
ValorBruto	Double
ValorCOFINS	Double
ValorFCP	Double
ValorFCPRet	Double
ValorFCPST	Double
ValorICMS	Double
ValorICMSSubstituicao	Double
ValorIPI	Double
ValorISS	Double
ValorLiquido	Double
ValorPIS	Double
ValorTaxaServico	Double
ValorTributos	Double

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

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

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