ManterNotaEspelhoGenericaLC_Integracao

O método ManterNotaEspelhoGenericaLC_Integracao do Live Connector tem a função de Incluir/alterar Nota de entrada e Saída do sistema externo para o Live.

Existem dois métodos para incluir notas:

ManterNotaEspelhoGenericaLC_Integracao :

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

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

Importante: Esse método realiza a integração de uma pré-nota, caso ocorra algum problema no Life no processo de movimentação da pré-nota para Nota Fiscal, o método não retornará status de erro, pois a pré-nota foi realizada com sucesso.

Compatibilidade
Ambiente SAAS
Ambiente OnPremise

Pré-requisitos

Connector Habilitado.
Movimentação automática de nota (opcional) habilitar o parâmetro 9050 - Integra NF por Tipo de Documento Automático (1 - Sim | 0 = Nao)

Exemplo de Utilização:

Neste método recebemos como Payload uma lista de 1 ou mais clientes ficando a critério do integrador a quantidade de clientes por requisição, nossa recomendação é passar 1(um) 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 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:

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

Campos de retorno

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
ChaveNfe	VarChar(44)	Chave da nota fiscal eletrônica	Sim
CodigoExternoTipoDocumentoFiscal		Código Externo do tipo de documento fiscal	Sim
DataEmissao	Datetime	Data emissão da nota fiscal Ex: 2020-02-14T00:00:00	Não
Itens	Lista	Itens da Nota	Sim
MovimentacaoAutomatica	Boolean	Define se ira realizar a validação dos parâmetros de movimentação automática.	Não
NumeroNota	Varchar(9)	Numero da Nota fiscal	Sim
TotalProdutos	Double	Valor total dos produtos da nota fiscal
ValorLiquidoNota	Double	Valor líquido da nota fiscal
IdentificacaoOrigem	VarChar(20)	Identificação da origem da nota (CNPJ)	Sim
IdentificacaoDestino	VarChar(20)	Identificação do destino da nota(CNPJ)	Sim
XMLNotaFiscal	String	Xml da nota fiscal eletronica. O Xml da nota fiscal deve seguir o Layout da Nfe. Para mais detalhes consultar o site https://www.nfe.fazenda.gov.br/portal.	Sim

Itens	Tipo	Descrição/ Formato	Obrigatório?	Observação
CodigoItemNota	Varchar(20)	Código do Item (Produto)	Sim
PosicaoItemNota	VarChar(5)	Posição do Item na Nota	Sim

Exemplo de Chamada do Método

Chamada:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Body>
		<ManterNotaEspelhoGenericaLC_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>9876541c-024d-46c9-8e36-73ceab8df615</a:Chave>
				<a:CodigoSistemaSatelite>2200007899</a:CodigoSistemaSatelite>
				<a:Data>24022020</a:Data>
				<a:Hora>144047</a:Hora>
				<a:Numero>202004241515</a:Numero>	
				<a:Documentos xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
					<b:anyType i:type="a:LC_NotaEspelhoGenerica">
						<a:NumeroSequencia>0</a:NumeroSequencia>
						<a:ChaveNfe>2751230600468555001000004816108514297</a:ChaveNfe>
						<a:CodigoExternoTipoDocumentoFiscal>BS01</a:CodigoExternoTipoDocumentoFiscal>
						<a:CodigoPedidoExterno>6100004365</a:CodigoPedidoExterno>
						<a:DataEmissao>2020-02-14T00:00:00</a:DataEmissao>
						<a:IdentificacaoDestino>27512306001236</a:IdentificacaoDestino>
						<a:IdentificacaoOrigem>27512306004685</a:IdentificacaoOrigem>
						<a:Itens>
							<b:anyType i:type="a:LC_ItemNotaEspelhoGenerica">
								<a:CodigoItemNota>4501907551418</a:CodigoItemNota>
								<a:PosicaoItemNota>1</a:PosicaoItemNota>
							</b:anyType>
						</a:Itens>
						<a:NumeroNota>000004816</a:NumeroNota>
						<a:NumeroOrdemVenda/>
						<a:TotalProdutos>0</a:TotalProdutos>
						<a:ValorLiquidoNota>0</a:ValorLiquidoNota>
						<a:XMLNotaFiscal><![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="yes"?><nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe"><NFe xmlns="http://www.portalfiscal.inf.br/nfe"><infNFe Id="NFe35200227512306004685550010000048161085142973" versao="4.00"><ide><cUF>35</cUF><cNF>08514297</cNF><natOp>Transferencia merc.adq.recebida de terceiros / Transf.merc.</natOp><mod>55</mod><serie>1</serie><nNF>4816</nNF><dhEmi>2020-02-14T10:29:21-03:00</dhEmi><dhSaiEnt>2020-02-14T10:29:21-03:00</dhSaiEnt><tpNF>1</tpNF><idDest>1</idDest><cMunFG>3998405</cMunFG><tpImp>1</tpImp><tpEmis>1</tpEmis><cDV>3</cDV><tpAmb>1</tpAmb><finNFe>1</finNFe><indFinal>0</indFinal><indPres>9</indPres><procEmi>0</procEmi><verProc>2.9.2.1</verProc></ide><emit><CNPJ>27512306004685</CNPJ><xNome>TESTE COMERCIO VAREJISTA LTDA</xNome><xFant>TESTE COMERCIO VAREJI</xFant><enderEmit><xLgr>RODOVIA PAULINO TESTE TESTE, S/N</xLgr><nro>S/N</nro><xBairro>GUARULHOS</xBairro><cMun>3508405</cMun><xMun>SAO PAULO</xMun><UF>SP</UF><CEP>15675000</CEP><cPais>1058</cPais><xPais>BRASIL</xPais></enderEmit><IE>233077852119</IE><CRT>3</CRT></emit><dest><CNPJ>27512306001236</CNPJ><xNome>TESTE COMERCIO VAREJISTA LTDA</xNome><enderDest><xLgr>RUA CORONEL TESTE, 23</xLgr><nro>9900</nro><xBairro>Centro</xBairro><cMun>3550308</cMun><xMun>Sao Paulo</xMun><UF>SP</UF><CEP>12345678</CEP><cPais>1058</cPais><xPais>Brasil</xPais></enderDest><indIEDest>1</indIEDest><IE>118446093113</IE></dest><entrega><CNPJ>98712306001236</CNPJ><xLgr>RUA TESTE TEODORO,99</xLgr><nro>9900</nro><xBairro>Centro</xBairro><cMun>3550308</cMun><xMun>Sao Paulo</xMun><UF>SP</UF></entrega><det nItem="1"><prod><cProd>0500020811</cProd><cEAN>4508844208110</cEAN><xProd>FONE DE OUVIDO</xProd><NCM>85183000</NCM><CEST>2806100</CEST><CFOP>5409</CFOP><uCom>PC</uCom><qCom>12.0000</qCom><vUnCom>10.6583333333</vUnCom><vProd>127.90</vProd><cEANTrib>4509055208110</cEANTrib><uTrib>PC</uTrib><qTrib>12.0000</qTrib><vUnTrib>10.6583333333</vUnTrib><indTot>1</indTot><xPed>4302121058</xPed><nItemPed>2350</nItemPed></prod><imposto><vTotTrib>0</vTotTrib><ICMS><ICMS10><orig>2</orig><CST>10</CST><modBC>0</modBC><vBC>127.90</vBC><pICMS>18.0000</pICMS><vICMS>23.02</vICMS><modBCST>4</modBCST><pMVAST>0.5700</pMVAST><vBCST>200.80</vBCST><pICMSST>18.0000</pICMSST><vICMSST>13.12</vICMSST></ICMS10></ICMS><IPI><cEnq>999</cEnq><IPINT><CST>53</CST></IPINT></IPI><PIS><PISOutr><CST>49</CST><vBC>0.00</vBC><pPIS>0.0000</pPIS><vPIS>0.00</vPIS></PISOutr></PIS><COFINS><COFINSOutr><CST>49</CST><vBC>0.00</vBC><pCOFINS>0.0000</pCOFINS><vCOFINS>0.00</vCOFINS></COFINSOutr></COFINS></imposto></det><total><ICMSTot><vBC>18209.26</vBC><vICMS>3277.68</vICMS><vICMSDeson>0.00</vICMSDeson><vFCP>0.00</vFCP><vBCST>9478.88</vBCST><vST>629.00</vST><vFCPST>0.00</vFCPST><vFCPSTRet>0.00</vFCPSTRet><vProd>18330.33</vProd><vFrete>0.00</vFrete><vSeg>0.00</vSeg><vDesc>0.00</vDesc><vII>0.00</vII><vIPI>864.09</vIPI><vIPIDevol>0.00</vIPIDevol><vPIS>0.00</vPIS><vCOFINS>0.00</vCOFINS><vOutro>0.00</vOutro><vNF>19823.42</vNF><vTotTrib>0.00</vTotTrib></ICMSTot></total><transp><modFrete>0</modFrete><transporta><CNPJ>11383946000109</CNPJ><xNome>TESTE TRANSPORTADORA LTDA</xNome><IE>398137545110</IE><xEnder>VIA DE ACESSO JOAO DE GOES 2305</xEnder><xMun>JUNDIAI</xMun><UF>SP</UF></transporta><veicTransp><placa>AAA2222</placa><UF>SP</UF></veicTransp><vol><qVol>25</qVol><esp>CAIXA</esp><pesoL>275.667</pesoL><pesoB>321.608</pesoB></vol></transp><cobr><fat><nFat>000004816</nFat><vOrig>19823.42</vOrig><vDesc>0.00</vDesc><vLiq>19823.42</vLiq></fat></cobr><pag><detPag><tPag>90</tPag><vPag>0.00</vPag></detPag></pag><infAdic><infCpl>. ICMS.Sub. Trib... ......Sub. Trib. 200212000024</infCpl></infAdic></infNFe><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><Reference URI="#NFe35200227512306004685550010000048161085142973"><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>Cszxstg17ZtkPzu3WiF2LuyYZc0=</DigestValue></Reference></SignedInfo><SignatureValue>G0abPTXYiRPEyc96lfOPwZ3HH8TkkabYVTrhrRBWdDrBuIZwlxR5+e/ecAiZbVoiN4qrxk1pNGqJ fEmO/+ls1wPH/OaRXGn7idVnCIH3ZeLSN27Ggt+T3gyeFVzly6pny/ks4wYFPMvGQ9wKbK0FZaBX 1WhQoiGIs3ExRWpiagIPkz1o5M9MBsA13mGcsqsv2bYTXyjbW24JAzucUThDBprxLyAsQz4oowiM TEPHlGB+i69xbNtrbqGAU+AxerStP1xu+CTAlRLsd20GPCa0zZfKMhC5SBz8PhR0G8NhCfXPw6ec puoUES+dK8b6IOLyPyQzZrlj9cC6G0w4ZJAM9w==</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIH8jCCBdqgAwIBAgIQb6BPZOowoNV+JLo9Z43ffDANBgkqhkiG9w0BAQsFADB4MQswCQYDVQQG EwJCUjETMBEGA1UEChMKSUNQLUJyYXNpbDE2MDQGA1UECxMtU2VjcmV0YXJpYSBkYSBSZWNlaXRh IEZlZGVyYWwgZG8gQnJhc2lsIC0gUkZCMRwwGgYDVQQDExNBQyBDZXJ0aXNpZ24gUkZCIEc1MB4X DTE5MDMxMzE5MzMzOFoXDTIwMDMxMjE5MzMzOFowgfIxCzAJBgNVBAYTAkJSMRMwEQYDVQQKDApJ Q1AtQnJhc2lsMQswCQYDVQQIDAJTQzEQMA4GA1UEBwwHUGFsaG9jYTE2MDQGA1UECwwtU2VjcmV0 YXJpYSBkYSBSZWNlaXRhIEZlZGVyYWwgZG8gQnJhc2lsIC0gUkZCMRYwFAYDVQQLDA1SRkIgZS1D TlBKIEExMSAwHgYDVQQLDBdBdXRlbnRpY2FkbyBwb3IgQVIgUEtTNzE9MDsGA1UEAww0TUlOSVNP IEJSQVNJTCBDT01FUkNJTyBWQVJFSklTVEEgTFREQToyNzUxMjMwNjAwMDE4MzCCASIwDQYJKoZI hvcNAQEBBQADggEPADCCAQoCggEBAMI1+MJt48xLIDI7Srzs720yJ5C6qsVf24effExCfhLN42Zi MKwEuOV7BWNHYa7lGO4SWXBlUQ5qF/AEb9kl6eDU/GbZ1NGzAJozOHkL8wSAlmyOTpuvVmjHMBN/ B3ZSa28m58Hh63lsXE0hShOyQVN3ehikQAoxPqCnGLvcPSUKdIkkV2f+bPJ1/aB8sleARgD2Xgsa tDlm3Ts4gfkZjBZF2f9AadgW0ee5fYClfLk/LlY1leA5AEQIRv0MzJAuCNcaIt9LnETYh2/4MJYy VTA7vzfsDE9JNqLajkMSAXRQWPGv5R3sE1EMJdHq90lGJsnWAlF+GMX+SrnjzESVCTECAwEAAaOC AvswggL3MIGqBgNVHREEgaIwgZ+gOAYFYEwBAwSgLwQtMDIwNDE5OTAyNDE2MDA2MjgyMjAwMDAw MDAwMDAwMDAwMDAwMDAwMDAwMDAwoBIGBWBMAQMCoAkEB1lJIFlBTkegGQYFYEwBAwOgEAQOMjc1 MTIzMDYwMDAxODOgFwYFYEwBAwegDgQMMDAwMDAwMDAwMDAwgRthY29uY2VpY2FvQG1pbmlzb2Jy YXNpbC5jb20wCQYDVR0TBAIwADAfBgNVHSMEGDAWgBRTfX+dvtFh0CC62p/jiacTc1jNQjB/BgNV HSAEeDB2MHQGBmBMAQIBDDBqMGgGCCsGAQUFBwIBFlxodHRwOi8vaWNwLWJyYXNpbC5jZXJ0aXNp Z24uY29tLmJyL3JlcG9zaXRvcmlvL2RwYy9BQ19DZXJ0aXNpZ25fUkZCL0RQQ19BQ19DZXJ0aXNp Z25fUkZCLnBkZjCBvAYDVR0fBIG0MIGxMFegVaBThlFodHRwOi8vaWNwLWJyYXNpbC5jZXJ0aXNp Z24uY29tLmJyL3JlcG9zaXRvcmlvL2xjci9BQ0NlcnRpc2lnblJGQkc1L0xhdGVzdENSTC5jcmww VqBUoFKGUGh0dHA6Ly9pY3AtYnJhc2lsLm91dHJhbGNyLmNvbS5ici9yZXBvc2l0b3Jpby9sY3Iv QUNDZXJ0aXNpZ25SRkJHNS9MYXRlc3RDUkwuY3JsMA4GA1UdDwEB/wQEAwIF4DAdBgNVHSUEFjAU BggrBgEFBQcDAgYIKwYBBQUHAwQwgawGCCsGAQUFBwEBBIGfMIGcMF8GCCsGAQUFBzAChlNodHRw Oi8vaWNwLWJyYXNpbC5jZXJ0aXNpZ24uY29tLmJyL3JlcG9zaXRvcmlvL2NlcnRpZmljYWRvcy9B Q19DZXJ0aXNpZ25fUkZCX0c1LnA3YzA5BggrBgEFBQcwAYYtaHR0cDovL29jc3AtYWMtY2VydGlz aWduLXJmYi5jZXJ0aXNpZ24uY29tLmJyMA0GCSqGSIb3DQEBCwUAA4ICAQC5MHwHzrN09XyuFzqb iv/zncVsjWm38cdSlixXHSFcabMM4sZhcwjVf9BQOnMxnpbjLHyF4AUC1TsttgOqez7Lq/SuzDdw +f+a2YOH07vclSYgR56OBUozQ6vSgn4Ktv3Np7EaDkQpcN0UwvKzXArmaHkwJEef5X9rCt+TpFus OceFwavFyctcXVuRosGI7dZve5r3aqUwO+AuwaicpWM+Vou1qkcTiGf7Apsaq3TFzc+ZvYjPP8VZ +QI+oIaC2ldHqKa297MyF4IqN+KOQWlaC/TmJiDk2im8pCfG7T0wkVNbdOUgND5+2g66okCO6bFm M87G6iLPIye6G22ESgjrerC6y+kj/qzwIuKWtlAY2uK5mTBFHCQRasxnE+vMP/gU1qShqTVG0dl9 rqhtSgIwfZw+9fpw7YZANDHxSHc0IRAZdsvPHMDUe2/R8nKWKBsepcpB4HQDUO1d2Kq1lQw3JHNt WhV/4oaAK6uvW8kWd0jnJcrseL4pIH7Mr3DuhFHjCBbEyO4UkzPVGIGNoqim7YJqjmUhVPBNJa6D ZHH+TJdVM0ErJOXgpzTmqAoZhFVetD19+fia45Dn+hscSGxf7BUxN5ThGZz2A5leq78bfGD5r1rB oNcuvdAaBwwUR0oT95Tm8+Ri26YFOKkdhVSOaAhfe3M1SSCI8cI6+GF8cA==</X509Certificate></X509Data></KeyInfo></Signature></NFe><protNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00"><infProt><tpAmb>1</tpAmb><verAplic>SP_NFE_PL009_V4</verAplic><chNFe>35200227512306004685550010000048161085142973</chNFe><dhRecbto>2020-02-14T10:31:46-03:00</dhRecbto><nProt>135200127106980</nProt><digVal>Cszxstg17ZtkPzu3WiF2LuyYZc0=</digVal><cStat>100</cStat><xMotivo>Autorizado o uso da NF-e</xMotivo></infProt></protNFe></nfeProc>]]>
						</a:XMLNotaFiscal>
					</b:anyType>
				</a:Documentos>
			</notaEspelho>
		</ManterNotaEspelhoGenericaLC_Integracao>
	</s:Body>
</s:Envelope>

Retorno:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ManterNotaEspelhoGenericaLC_IntegracaoResponse xmlns="http://LiveConnector/">
         <ManterNotaEspelhoGenericaLC_IntegracaoResult xmlns:a="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </ManterNotaEspelhoGenericaLC_IntegracaoResponse>
   </s:Body>
</s:Envelope>

Atalhos

Árvore de páginas