TOTVS Varejo Franquias e Redes

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 15

changes.mady.by.user Rafael Pessoa Rodrigues

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Thiago Soares Arnoni

Gravado em

Chave

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

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

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


Aviso
titleConsulta status processamento

Após o processamento com sucesso do método ManterNotaEspelhoGenericaLC_Integracao ou ManterNotaEspelhoGenericaLC_Integracao_Xml, deve-se consultar o status do processamento da Nota  a partir do método ConsultarStatusTicketLC_Integracao

Informações
iconfalse
titleExemplo 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
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:



...

Informações
titleCampos de retorno



Aviso
titleImportante

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

ChaveNfe

Cliente (Campos)

Tipo

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

Numero sequencia do documento implementar a cada documento.

Ex: 1

Sim
CategoriaFiscalUnidadeNegocioCategoria fiscal da unidade de negócio

ChaveNfeVarChar(44)
Chave da nota fiscal eletrônica
CodigoLoja
Sim
CodigoExternoTipoDocumentoFiscal
Código
da lojaCodigoSetorIndustrialcódigo do setor industrial
Externo do tipo de documento fiscalSim
DataEmissaoDatetime
CPFFuncionarioCPf do funcionárioDataEmissao

Data emissão da nota fiscal

DescricaoSetorIndustrialDescrição do setor industrialDescricaoTipoDocumentoDescrição do tipo do documentoExcluirExcluir a notaModeloModelo da notaNomeEntidadeNome da entidade

Ex:

2020-02-14T00:00:00

Não
ItensListaItens da NotaSim
MovimentacaoAutomaticaBooleanDefine se ira realizar a validação dos parâmetros de movimentação automática.Não
NumeroNotaVarchar(9)
NomeUnidadeNegocioNome da unidade de negócioNumeroDocumentoFornecedorNumero do documento do fornecedorNumeroLogNfeNumero do Log NFeNumeroNota
Numero da Nota fiscal
NumeroNotaFiscalE 
Sim
Numero nota fiscal NumeroOrdemVendaNumero ordem venda

TotalProdutosDoubleValor total
QuantidadeItensQuantidade de itens da nota fiscalStatusNotaStatus da nota fiscalTipoNotaTipo da nota fiscalTotalDescontosValor total de de desconto na nota fiscalTotalICMSValor total de ICMS na nota fiscalTotalIPIValor total de IPI na nota fiscalTotalProdutosValor total
dos produtos da nota fiscal

ValorLiquidoNotaDoubleValor líquido da
nota fiscalValorNotaValor total de
nota fiscal
IDTipoDocumentoOperacaoId do tipo de operação da nota fiscal


IdentificacaoOrigem VarChar(20)Identificação da origem da nota (CNPJ)Sim
IdentificacaoDestinoVarChar(20)Identificação do destino da nota(CNPJ)Sim
CodigoPedidoExternoCódigo externo do pedido

XMLNotaFiscalString

Xml da nota fiscal eletronica.

O

IDUnidadeNegocioId da unidade de negócioXMLNotaFiscal

Xml da nota fiscal

Pivot Table
id1581521954499_556941873

Ide

Tipo

cUF

deve seguir o Layout da Nfe.

Para mais detalhes consultar o site https://www.nfe.fazenda.gov.br/portal.

Sim

Itens

Tipo

Descrição/ FormatoObrigatório?Observação
CodigoItemNotaVarchar(20)

Código do Item (Produto)

Sim
PosicaoItemNotaVarChar(5)Posição do Item na NotaSim
cNFnatOpmodserienNFdhEmidhSaiEnttpNFidDestcMunFGtpImptpEmiscDVtpAmbfinNFeindFinalindPresprocEmiverProc

emit

Tipo

CNPJxNomexFantenderEmitIECRT

enderEmit

Tipo

xLgrnroxBairrocMunxMunUFCEPcPaisxPais

dest

Tipo

CNPJxNomeenderDestindIEDestIE

enderDest

Tipo

xLgrnroxBairrocMunxMunUFCEPcPaisxPais

entrega

Tipo

CNPJxLgrnroxBairrocMunxMunUF

prod

Tipo

cProdcEANxProdNCMCESTCFOPuComqComvUnComvProdcEANTribuTribqTribvUnTribindTotxPednItemPed

ICMS

Tipo

origCSTmodBCvBCpICMSvICMSmodBCSTpMVASTvBCSTpICMSSTvICMSST

IPI

Tipo

cEnqIPINT

PIS

Tipo

PISOutrCSTvBCpPISvPIS

COFINS

Tipo

COFINSOutrCSTvBCpCOFINSvCOFINS

COFINS

Tipo

CST

PIS

Tipo

CST



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>
		<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>
Bloco de código
titleRetorno:
<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>