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>
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas