Consulta de Documentos
Esta funcionalidade de consulta de documentos, permite buscar a situação de vários documentos em apenas uma requisição, além de suas principais informações, juntamente com o PDF e o XML do mesmo. É possível também consultar documentos que não foram efetivados ou que não foram emitidos pelo InvoiCy. Neste caso, é necessário informar a chave de acesso do documento no momento do consumo do Web Service.
Para realizar a consulta de documentos via SOAP, é necessário estabelecer uma comunicação com o Web Service apropriado. Primeiramente, visualize a estrutura WSDL do mesmo:
- Homologação: https://consultahomolog.invoicy.com.br/aconsultadocumentos.aspx?wsdl
- Produção: https://consulta.invoicy.com.br/aconsultadocumentos.aspx?wsdl
Em seguida, será preciso realizar o consumo do Web Service para efetuar a integração.
Tipos de Consulta
Com a integração realizada, é necessário determinar o método de consulta, tanto para documentos emitidos quanto para os recebidos. Sendo assim, selecione dentre as alternativas a seguir, qual será o tipo de consulta utilizada:
-
Faixa de numeração: Informe o número inicial e final, juntamente com a série do documento.
-
Chave de acesso: Informar apenas a chave de acesso do documento. Sendo obrigatório, caso ocorra a consulta de um documento que não esteja na base de dados do InvoiCy. Neste caso, o sistema irá consultar seu status junto a SEFAZ.
-
Datas de emissão: A data inicial e a data final de emissão deverão ser preenchidas, juntamente com o horário. Ao optar por essa forma de consulta, as tags de numeração e série deverão ser preenchidas com zero, ou removidas da estrutura do layout enviado.
-
Datas de inclusão: A data inicial e a data final de inclusão deverão ser preenchidas, juntamente com o horário. Ao optar por essa forma de consulta, as tags de numeração e série deverão ser preenchidas com zero, ou removidas da estrutura do layout enviado.
-
Status do documento: Para filtrar pelo status específico de um documento, informe na tag
StatusDocumentoo status do mesmo. Ressaltando que ao realizar uma consulta, a tagdhUFnão deve ser informada. Esta deverá ser usada somente quando se deseja consultar o status de serviço da SEFAZ.
Exemplos de Envio
Com o intuito de efetuar o envio da consulta para documentos emitidos ou recebidos, preencha as informações necessárias no XML de envio, de acordo com o tipo de consulta selecionada.
Em seguida, envie toda a estrutura XML e os parâmetros necessários para a consulta de documentos. Ambos devem ser convertidos para texto e inseridos, respectivamente, nas tags <inv:Documento> e <inv:Parametros>, conforme evidenciado a seguir:
<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
<soapenv:Header/>
<soapenv:Body>
<inv:recepcao.Execute>
<inv:Invoicyrecepcao>
<inv:Cabecalho>
<inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
<inv:EmpCK>91715df5ee0669f117b27b5cbb6ca16d</inv:EmpCK>
<inv:EmpCO></inv:EmpCO>
</inv:Cabecalho>
<inv:Informacoes>
<inv:Texto></inv:Texto>
</inv:Informacoes>
<inv:Dados>
<inv:DadosItem>
<inv:Documento><!-- (1) --></inv:Documento>
<inv:Parametros><!-- (2) --></inv:Parametros>
</inv:DadosItem>
</inv:Dados>
</inv:Invoicyrecepcao>
</inv:recepcao.Execute>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)" xmlns:inv="InvoiCy">
<soapenv:Header/>
<soapenv:Body>
<inv:recepcao.Execute>
<inv:Invoicyrecepcao>
<inv:Cabecalho>
<inv:EmpPK>ABCabcCBAcbaA+CabcCBAc==</inv:EmpPK>
<inv:EmpCK>1a89a526e1166ea6247d467afb0fe49e</inv:EmpCK>
<inv:EmpCO></inv:EmpCO>
</inv:Cabecalho>
<inv:Informacoes>
<inv:Texto></inv:Texto>
</inv:Informacoes>
<inv:Dados>
<inv:DadosItem>
<inv:Documento><!-- (1) --></inv:Documento>
<inv:Parametros><!-- (2) --></inv:Parametros>
</inv:DadosItem>
</inv:Dados>
</inv:Invoicyrecepcao>
</inv:recepcao.Execute>
</soapenv:Body>
</soapenv:Envelope>
É importante ressaltar, que os parâmetros enviados nesta estrutura precisam ser informados tanto para os documentos emitidos quanto para os recebidos, pois estes parâmetros definem quais as informações que serão retornadas no momento da consulta.
Disponibilizamos também um documento que especifica o layout dos XMLs que devem ser gerados.
Exemplos de Retorno
Com o envio da requisição, é necessário realizar a leitura de retorno do processamento. O retorno recebido será de acordo com as definições informadas na tag <inv:Parametros>, conforme demonstrado na estrutura SOAP a seguir:
Com o envio da requisição, é necessário realizar a leitura de retorno do processamento. O retorno recebido será de acordo com as definições informadas na tag <inv:Parametros>, conforme demonstrado na estrutura SOAP a seguir:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<consultadocumentos.ExecuteResponse xmlns="InvoiCy">
<Invoicyretorno>
<Mensagem>
<MensagemItem>
<Codigo>100</Codigo>
<Descricao>Documentos processados</Descricao>
<Documentos>
<DocumentosItem>
<Documento><![CDATA[<Documento><DocModelo>NFe</DocModelo><DocNumero>18</DocNumero><DocSerie>369</DocSerie><DocChaAcesso>43250699999999999999553690000000181000003007</DocChaAcesso><DocProtocolo>143250001444662</DocProtocolo><DocSitCodigo>100</DocSitCodigo><DocSitDescricao>Autorizado o uso da NF-e</DocSitDescricao><DocXML /><DocXMLLink /><DocPDF /><DocPDFLink /><dhRecbto>2025-06-10T13:33:24</dhRecbto><NTEmVigor /><VersaoQRCode /><ImprimirUmaViaContingencia /><DocImpPrefeitura /><DocStatus>2</DocStatus><CertHoraVencimento /><tpEmis>1</tpEmis><DocNumPedido>5480</DocNumPedido><Resumo><DocDataEmissao>2025-06-10T13:33:24</DocDataEmissao><DocFusoHorario>-03:00</DocFusoHorario><DocDigestValue>J123ABCAaIrIsFjMavgiicDoDqw=</DocDigestValue><DocDhAut>2025-06-10T13:33:24</DocDhAut><DocNomeEmitente>MIGRATE COMPANY SISTEMAS DE INFORMACAO</DocNomeEmitente><DocCNPJEmitente>99999999999999</DocCNPJEmitente><DocUFEmitente /><DocCNPJDestinatario>99999999000191</DocCNPJDestinatario><DocNomeDestinatario>NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL</DocNomeDestinatario><DocVlrTotal>10000.00</DocVlrTotal></Resumo><Eventos /><NFSe><NFSeNumero>0</NFSeNumero><NFSeCodVerificacao /></NFSe></Documento>]]></Documento>
</DocumentosItem>
</Documentos>
</MensagemItem>
</Mensagem>
</Invoicyretorno>
</consultadocumentos.ExecuteResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<consultadocumentos.ExecuteResponse xmlns="InvoiCy">
<Invoicyretorno>
<Mensagem>
<MensagemItem>
<Codigo>100</Codigo>
<Descricao>Documentos processados</Descricao>
<Documentos>
<DocumentosItem>
<Documento><![CDATA[<Documento><DocModelo>NFe</DocModelo><DocNumero>137</DocNumero><DocSerie>770</DocSerie><DocChaAcesso>31250911111111111111557700000001371001532033</DocChaAcesso><DocProtocolo>131250151050577</DocProtocolo><DocSitCodigo>100</DocSitCodigo><DocSitDescricao>Autorizado o uso da NF-e</DocSitDescricao><DocXML>PG5mZVByb2MgdmVyc2FvPSI0LjAwIiB4bWxucz0iaHR0cDovL3d3dy5wb3J0YWxmaXNjYWwuaW5mLmJyL25mZSI+PE5GZSB4bWxucz0iaHR0cDovL3d3dy5wb3J0YWxmaXNjYWwuaW5mLmJyL25mZSI+PGluZk5GZSB2ZXJzYW89IjQuMDAiIElkPSJORmUzMTI1MDkyMzY0MDI2MTAwMDE3MTU1NzcwMDAwMDAwMTM3MTAwMTUzMjAzMyI+PGlkZT48Y1VGPjMxPC9jVUY+PGNORj4wMDE1MzIwMzwvY05GPjxuYXRPcD5SRVRPUk5PIERFIE1FUkM8L25hdE9wPjxtb2Q+NTU8L21vZD48c2VyaWU+NzcwPC9zZXJpZT48bk5GPjEzNzwvbk5GPjxkaEVtaT4yMDI1LTA5LTE4VDExOjA1OjE0LTAzOjAwPC9kaEVtaT48dHBORj4xPC90cE5GPjxpZERlc3Q+MjwvaWREZXN0PjxjTXVuRkc+MzE1MTgwMDwvY011bkZHPjx0cEltcD4xPC90cEltcD48dHBFbWlzPjE8L3RwRW1pcz48Y0RWPjM8L2NEVj48dHBBbWI+MjwvdHBBbWI+PGZpbk5GZT4xPC9maW5ORmU+PGluZEZpbmFsPjA8L2luZEZpbmFsPjxpbmRQcmVzPjA8L2luZFByZXM+PHByb2NFbWk+MDwvcHJvY0VtaT48dmVyUHJvYz5NaWdyYXRlSW52b2lDeTwvdmVyUHJvYz48L2lkZT48ZW1pdD48Q05QSj4yMzY0MDI2MTAwMDE3MTwvQ05QSj48eE5vbWU+U09DSUVEQURFIElOVEVSRVNUQURVQUwgREUgVFJBTlNQLiBDQVJWQUxITyBMVERBPC94Tm9tZT48eEZhbnQ+U0lUQ0FSPC94RmFudD48ZW5kZXJFbWl0Pjx4TGdyPkFWRU5JREEgSk9BTyBQSU5IRUlSTzwveExncj48bnJvPjY2NTwvbnJvPjx4QmFpcnJvPkNFTlRSTzwveEJhaXJybz48Y011bj4zMTUxODAwPC9jTXVuPjx4TXVuPlBPQ09TIERFIENBTERBUzwveE11bj48VUY+TUc8L1VGPjxDRVA+Mzc3MDEzODc8L0NFUD48Y1BhaXM+MTA1ODwvY1BhaXM+PHhQYWlzPkJSQVNJTDwveFBhaXM+PGZvbmU+MzUzNjk3MTU0MzwvZm9uZT48L2VuZGVyRW1pdD48SUU+NTE4NjM0MjQ0MDAzOTwvSUU+PENSVD4zPC9DUlQ+PC9lbWl0PjxkZXN0PjxDTlBKPjA2MzU0OTc2MDAwMTQ5PC9DTlBKPjx4Tm9tZT5ORi1FIEVNSVRJREEgRU0gQU1CSUVOVEUgREUgSE9NT0xPR0FDQU8gLSBTRU0gVkFMT1IgRklTQ0FMPC94Tm9tZT48ZW5kZXJEZXN0Pjx4TGdyPlJVQSBQRSBDQUNJUVVFPC94TGdyPjxucm8+OTg1PC9ucm8+PHhCYWlycm8+Q0VOVFJPPC94QmFpcnJvPjxjTXVuPjQzMDUxMDg8L2NNdW4+PHhNdW4+Q0FYSUFTIERPIFNVTDwveE11bj48VUY+UlM8L1VGPjxDRVA+OTg5MTAwMDA8L0NFUD48Y1BhaXM+MTA1ODwvY1BhaXM+PHhQYWlzPkJyYXNpbDwveFBhaXM+PC9lbmRlckRlc3Q+PGluZElFRGVzdD4xPC9pbmRJRURlc3Q+PElFPjAwMTgwMDEzNjA8L0lFPjwvZGVzdD48YXV0WE1MPjxDTlBKPjIzNjQwMjYxMDAwMTcxPC9DTlBKPjwvYXV0WE1MPjxkZXQgbkl0ZW09IjEiPjxwcm9kPjxjUHJvZD4wMDAwOTwvY1Byb2Q+PGNFQU4+U0VNIEdUSU48L2NFQU4+PHhQcm9kPkJvdGlqYW8gZGUgZ2FzPC94UHJvZD48TkNNPjg3MTEzMDAwPC9OQ00+PEVYVElQST44NzwvRVhUSVBJPjxDRk9QPjYxMDI8L0NGT1A+PHVDb20+Qk9UPC91Q29tPjxxQ29tPjEuMDAwMDwvcUNvbT48dlVuQ29tPjEwMC4wMDAwMDAwMDAwPC92VW5Db20+PHZQcm9kPjEwMC4wMDwvdlByb2Q+PGNFQU5UcmliPlNFTSBHVElOPC9jRUFOVHJpYj48dVRyaWI+Qk9UPC91VHJpYj48cVRyaWI+MS4wMDAwPC9xVHJpYj48dlVuVHJpYj4xMDAuMDAwMDAwMDAwMDwvdlVuVHJpYj48aW5kVG90PjE8L2luZFRvdD48L3Byb2Q+PGltcG9zdG8+PElDTVM+PElDTVMwMD48b3JpZz4wPC9vcmlnPjxDU1Q+MDA8L0NTVD48bW9kQkM+MzwvbW9kQkM+PHZCQz4xMDAuMDA8L3ZCQz48cElDTVM+MTIuMDAwMDwvcElDTVM+PHZJQ01TPjEyLjAwPC92SUNNUz48L0lDTVMwMD48L0lDTVM+PFBJUz48UElTTlQ+PENTVD4wNzwvQ1NUPjwvUElTTlQ+PC9QSVM+PENPRklOUz48Q09GSU5TTlQ+PENTVD4wNzwvQ1NUPjwvQ09GSU5TTlQ+PC9DT0ZJTlM+PC9pbXBvc3RvPjwvZGV0Pjx0b3RhbD48SUNNU1RvdD48dkJDPjEwMC4wMDwvdkJDPjx2SUNNUz4xMi4wMDwvdklDTVM+PHZJQ01TRGVzb24+MC4wMDwvdklDTVNEZXNvbj48dkZDUD4wLjAwPC92RkNQPjx2QkNTVD4wLjAwPC92QkNTVD48dlNUPjAuMDA8L3ZTVD48dkZDUFNUPjAuMDA8L3ZGQ1BTVD48dkZDUFNUUmV0PjAuMDA8L3ZGQ1BTVFJldD48dlByb2Q+MTAwLjAwPC92UHJvZD48dkZyZXRlPjAuMDA8L3ZGcmV0ZT48dlNlZz4wLjAwPC92U2VnPjx2RGVzYz4wLjAwPC92RGVzYz48dklJPjAuMDA8L3ZJST48dklQST4wLjAwPC92SVBJPjx2SVBJRGV2b2w+MC4wMDwvdklQSURldm9sPjx2UElTPjAuMDA8L3ZQSVM+PHZDT0ZJTlM+MDwvdkNPRklOUz48dk91dHJvPjAuMDA8L3ZPdXRybz48dk5GPjEwMC4wMDwvdk5GPjwvSUNNU1RvdD48L3RvdGFsPjx0cmFuc3A+PG1vZEZyZXRlPjE8L21vZEZyZXRlPjwvdHJhbnNwPjxwYWc+PGRldFBhZz48dFBhZz4wMTwvdFBhZz48dlBhZz4xMDAuMDA8L3ZQYWc+PC9kZXRQYWc+PC9wYWc+PC9pbmZORmU+PFNpZ25hdHVyZSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PFNpZ25lZEluZm8+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnI3JzYS1zaGExIiAvPjxSZWZlcmVuY2UgVVJJPSIjTkZlMzEyNTA5MjM2NDAyNjEwMDAxNzE1NTc3MDAwMDAwMDEzNzEwMDE1MzIwMzMiPjxUcmFuc2Zvcm1zPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjZW52ZWxvcGVkLXNpZ25hdHVyZSIgLz48VHJhbnNmb3JtIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUiIC8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIgLz48RGlnZXN0VmFsdWU+M1hHUHlLK0FYQ2tQUElVREhwSUtDdlJkN1RrPTwvRGlnZXN0VmFsdWU+PC9SZWZlcmVuY2U+PC9TaWduZWRJbmZvPjxTaWduYXR1cmVWYWx1ZT5XcHpoNlhPTE1NVk5vb1R2NlBEVHpCZlRUM0xxWVMrK3Bic3lVWVhvNG4wcDMyM0dOVkVJYis1K0FIRGNQTWlBcWp2dUNsKzhGREdCNjErUHdQOEtpbFl0R20rR2J6aWk3NjA4Ukw2M2ZmVmNiZzNBeVVoRGVrdm5TQ3ZCenhiOTFpQ0s3Z3hpTDhxN3F1SmRIRUpWWkFyK2VqQS9BY25uazQwUnhOUWNkWjcxczg3N2l2ZC9NVmw1QmZQMUdLRG1jcUwrajE1ejY1R1dZS1VycHQ2TEdRa08zc2FNamVXK3A3UTFPRGcvQ3pVQ01FM1VCbTNJZXF6Rk5Vc215MEo5K0s3ZURBa0srRGZ3M2dMUU5FOU5BQUxVaDU1K2dIZkJoVlRTTHVITHgwaUNpSUZYaTlSUVc4OURBbVFwWThpSTlMWTdtTis3RmFGL0Vzdk50R0VTR0E9PTwvU2lnbmF0dXJlVmFsdWU+PEtleUluZm8+PFg1MDlEYXRhPjxYNTA5Q2VydGlmaWNhdGU+TUlJSGlEQ0NCWENnQXdJQkFnSU5BUE5qMURLK2dxZm9WMk5kOURBTkJna3Foa2lHOXcwQkFRc0ZBRENCaVRFTE1Ba0dBMVVFQmhNQ1FsSXhFekFSQmdOVkJBb01Da2xEVUMxQ2NtRnphV3d4TmpBMEJnTlZCQXNNTFZObFkzSmxkR0Z5YVdFZ1pHRWdVbVZqWldsMFlTQkdaV1JsY21Gc0lHUnZJRUp5WVhOcGJDQXRJRkpHUWpFdE1Dc0dBMVVFQXd3a1FYVjBiM0pwWkdGa1pTQkRaWEowYVdacFkyRmtiM0poSUZORlVsQlNUMUpHUW5ZMU1CNFhEVEkxTURZeE1qRTJNamsxT1ZvWERUSTJNRFl4TWpFMk1qazFPVm93Z2dFcE1Rc3dDUVlEVlFRR0V3SkNVakVMTUFrR0ExVUVDQXdDVFVjeEdEQVdCZ05WQkFjTUQxQlBRMDlUSUVSRklFTkJURVJCVXpFVE1CRUdBMVVFQ2d3S1NVTlFMVUp5WVhOcGJERVRNQkVHQTFVRUN3d0tjSEpsYzJWdVkybGhiREVYTUJVR0ExVUVDd3dPTVRFMk5qY3lOak13TURBeE56VXhOakEwQmdOVkJBc01MVk5sWTNKbGRHRnlhV0VnWkdFZ1VtVmpaV2wwWVNCR1pXUmxjbUZzSUdSdklFSnlZWE5wYkNBdElGSkdRakVWTUJNR0ExVUVDd3dNUVZKTVQxQkZVME5QVTFSQk1SWXdGQVlEVlFRTERBMVNSa0lnWlMxRFRsQktJRUV4TVVrd1J3WURWUVFEREVCVFQwTkpSVVJCUkVVZ1NVNVVSVkpGVTFSQlJGVkJUQ0JFUlNCVVVrRk9VMUJQVWxSRlV5QkRRVkpXUVV4SVR5Qk1Pakl6TmpRd01qWXhNREF3TVRjeE1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBZzhYQmU3aThoazd2Y0hPY3V0Wml3ZDNhUzRQZzNoZDUzVTRGL3N0NGQ0Q1I0Mi85ZlJETzJUVFQrK3c5dDkwMWZsWUd6NXV3bHFOL3o3ZHZObWxON1BmVVBnd0pPMytWbzdzbnJXU2h3TU9pSjNQNWxHeFhSZ2NkVVNOOU5Da3Ruc3ZTbzFyWUNIRzJxWkVCN0xvOFQvMGFZNURCcVZCaTF2T29GRTFHMENTdFZkNERqMG1MNFdKWHpOaHN5bi9jdzgwZis2ak1FSjRLZzVIN1ludm5JS3RUdmRQS0JhS2FpNjhicVJlb1J1Kzk4TXJMMG92Y0dpWEJ1bFNqbEVNcTluRm52Sk1Nb2UwSklMM2ZnT291QjN1blFtR05ha3FDY0ZUcWJOZ1pEdk93VWhMakZQdmRqS29jaFNrNGtIYlU0MEc0M3BVcVo0dEtvQk05VGV2QzlRSURBUUFCbzRJQ1NqQ0NBa1l3SHdZRFZSMGpCQmd3Rm9BVUZJQXRuWDZhUmNEeFd6OFoxVUN3Ynk5bDRPa3dEZ1lEVlIwUEFRSC9CQVFEQWdYZ01Gc0dBMVVkSUFSVU1GSXdVQVlHWUV3QkFnRUtNRVl3UkFZSUt3WUJCUVVIQWdFV09HaDBkSEE2THk5eVpYQnZjMmwwYjNKcGJ5NXpaWEp3Y204dVoyOTJMbUp5TDJSdlkzTXZaSEJqWVdOelpYSndjbTl5Wm1JdWNHUm1NSUd6QmdOVkhSRUVnYXN3Z2FpZ1BRWUZZRXdCQXdTZ05BUXlNRFF3TXpFNU5Ua3lPRFk1T1RVM01qWXlNREF3TURBd01EQXdNREF3TURBd01EQXdNREUzT0RFNE5ERXdVMU5RVFVlZ0hnWUZZRXdCQXdLZ0ZRUVRTazlUUlNCU1NVTkJVa1JQSUVkVlJWSlNRYUFaQmdWZ1RBRURBNkFRQkE0eU16WTBNREkyTVRBd01ERTNNYUFYQmdWZ1RBRURCNkFPQkF3d01EQXdNREF3TURBd01EQ0JFM0pwWTJGeVpHOUFaMjFoWmk1amIyMHVZbkl3SFFZRFZSMGxCQll3RkFZSUt3WUJCUVVIQXdJR0NDc0dBUVVGQndNRU1JR0lCZ05WSFI4RWdZQXdmakE4b0RxZ09JWTJhSFIwY0RvdkwzSmxjRzl6YVhSdmNtbHZMbk5sY25CeWJ5NW5iM1l1WW5JdmJHTnlMMkZqYzJWeWNISnZjbVppZGpVdVkzSnNNRDZnUEtBNmhqaG9kSFJ3T2k4dlkyVnlkR2xtYVdOaFpHOXpNaTV6WlhKd2NtOHVaMjkyTG1KeUwyeGpjaTloWTNObGNuQnliM0ptWW5ZMUxtTnliREJXQmdnckJnRUZCUWNCQVFSS01FZ3dSZ1lJS3dZQkJRVUhNQUtHT21oMGRIQTZMeTl5WlhCdmMybDBiM0pwYnk1elpYSndjbTh1WjI5MkxtSnlMMk5oWkdWcFlYTXZZV056WlhKd2NtOXlabUoyTlM1d04ySXdEUVlKS29aSWh2Y05BUUVMQlFBRGdnSUJBSElpS0d6L1ZtbmpOSHV4ckI5VXgzR1kwd0RUTXlQV3g5VFZWNC9NRjcydWtOS3ZscGJvM1ZKZGw2TlgxaFlBcXZ6TnRxMzdKWW5uaVhBdjA2SVpVVE1CdlFkYnhuY09GTVpBakk4T1ZYbVozK1c5bkx2WXNiRXZURkJueEs1RkZXVTFKMEt5OG8xalIzNWJWelJHaWJLTWsvQVRlaEM4aTNKTG9ETHJ2TkJ3S1JGSFNKZlZ0TzE2ZWJjc1BseGIyejZuaEFvV2s0UDkrWm5ESDFaQkIwQ09mMmdXZUVTc0x5eFpMSlFWWXhEZzZ3QzcyUmE1RVRhZzh1aVU0TkRkRFZuZ2YwdTJ6NDZJelh6TlNrclRzNHA1RXZIdE9DSm9oSlAwbUhjY0t2UUU1bHc3NElSYzl0RDdJZ0p4QklGRE13anVUajFZZDdoVG5FY0V3VXJMb1lZZGNUVFluMmZOUVBpK3F3ZWZiamdYNDBzTytvenVveDdDWlIvWm1GdjNZWDkyUitKOTU5SHFKVHpLRW5pNlljYTJVUFArM05EcE9iVk11dGhBUThHVTJ3c2NHUkNDeS81RGJ3S2lEbnhhL2UvTlFRWDY5NHdJZ2U1S280ZGpXa3N0NnQvb1JtakpTVWpnK3ZCd1BPYmZFbWJJY1dGRVFlOVVzMTRrSnJJc3BKN1VTakhROUZkZEhtZVFBa3hpYTVyR05sdmxDSDcyRFErQjRjdFJyUmpQWDA3bG1ad1diT3Nsb2xKM0ZVQVpmMWpSbWpaMDFXMUF1VCtyb0tqTHZrQ3ViS1A1S3ZkeDVvSDN2cy80emo4U3JpQ3BDeUdIa3pVMXQ4VjBtODljS0gvbTZqck9Tc1dsYXp6cDNXSmJGa2NBYVh6amhUeElYRlQ4c3VHU29QOEg8L1g1MDlDZXJ0aWZpY2F0ZT48L1g1MDlEYXRhPjwvS2V5SW5mbz48L1NpZ25hdHVyZT48L05GZT48cHJvdE5GZSB2ZXJzYW89IjQuMDAiPjxpbmZQcm90Pjx0cEFtYj4yPC90cEFtYj48dmVyQXBsaWM+Vy0zLjMuOTwvdmVyQXBsaWM+PGNoTkZlPjMxMjUwOTIzNjQwMjYxMDAwMTcxNTU3NzAwMDAwMDAxMzcxMDAxNTMyMDMzPC9jaE5GZT48ZGhSZWNidG8+MjAyNS0wOS0xOFQxMTowNToxNC0wMzowMDwvZGhSZWNidG8+PG5Qcm90PjEzMTI1MDE1MTA1MDU3NzwvblByb3Q+PGRpZ1ZhbD4zWEdQeUsrQVhDa1BQSVVESHBJS0N2UmQ3VGs9PC9kaWdWYWw+PGNTdGF0PjEwMDwvY1N0YXQ+PHhNb3Rpdm8+QXV0b3JpemFkbyBvIHVzbyBkYSBORi1lPC94TW90aXZvPjwvaW5mUHJvdD48L3Byb3RORmU+PC9uZmVQcm9jPg==</DocXML><DocXMLLink /><DocPDF /><DocPDFLink /><dhRecbto>2025-09-18T11:05:14</dhRecbto><NTEmVigor /><VersaoQRCode /><ImprimirUmaViaContingencia /><DocImpPrefeitura /><DocStatus>2</DocStatus><CertHoraVencimento /><tpEmis>1</tpEmis><Resumo><DocDataEmissao>2025-09-18T11:05:14</DocDataEmissao><DocFusoHorario>-03:00</DocFusoHorario><DocDigestValue>3XGPyK+AXCkPPIUDHpIKCvRd7Tk=</DocDigestValue><DocDhAut>2025-09-18T11:05:14</DocDhAut><DocNomeEmitente>Teste</DocNomeEmitente><DocCNPJEmitente>11111111111111</DocCNPJEmitente><DocUFEmitente /><DocCNPJDestinatario>99999999999999</DocCNPJDestinatario><DocNomeDestinatario>NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL</DocNomeDestinatario><DocVlrTotal>100.00</DocVlrTotal></Resumo><Eventos><EventosItem><DocEvenSeq>1</DocEvenSeq><DocEveTp>110110</DocEveTp><DocEveXML>PHByb2NFdmVudG9ORmUgdmVyc2FvPSIxLjAwIiB4bWxucz0iaHR0cDovL3d3dy5wb3J0YWxmaXNjYWwuaW5mLmJyL25mZSI+PGV2ZW50byB2ZXJzYW89IjEuMDAiIHhtbG5zPSJodHRwOi8vd3d3LnBvcnRhbGZpc2NhbC5pbmYuYnIvbmZlIj48aW5mRXZlbnRvIElkPSJJRDExMDExMDMxMjUwOTIzNjQwMjYxMDAwMTcxNTU3NzAwMDAwMDAxMzcxMDAxNTMyMDMzMDEiPjxjT3JnYW8+MzE8L2NPcmdhbz48dHBBbWI+MjwvdHBBbWI+PENOUEo+MjM2NDAyNjEwMDAxNzE8L0NOUEo+PGNoTkZlPjMxMjUwOTIzNjQwMjYxMDAwMTcxNTU3NzAwMDAwMDAxMzcxMDAxNTMyMDMzPC9jaE5GZT48ZGhFdmVudG8+MjAyNS0wOS0xOFQxNjoxMjowMC0wMzowMDwvZGhFdmVudG8+PHRwRXZlbnRvPjExMDExMDwvdHBFdmVudG8+PG5TZXFFdmVudG8+MTwvblNlcUV2ZW50bz48dmVyRXZlbnRvPjEuMDA8L3ZlckV2ZW50bz48ZGV0RXZlbnRvIHZlcnNhbz0iMS4wMCI+PGRlc2NFdmVudG8+Q2FydGEgZGUgQ29ycmVjYW88L2Rlc2NFdmVudG8+PHhDb3JyZWNhbz5mZHNmZ2ZnZiBmaGdqaGdqZ2hqaGZqayBmamhmamtma2s8L3hDb3JyZWNhbz48eENvbmRVc28+QSBDYXJ0YSBkZSBDb3JyZWNhbyBlIGRpc2NpcGxpbmFkYSBwZWxvIHBhcmFncmFmbyAxby1BIGRvIGFydC4gN28gZG8gQ29udmVuaW8gUy9OLCBkZSAxNSBkZSBkZXplbWJybyBkZSAxOTcwIGUgcG9kZSBzZXIgdXRpbGl6YWRhIHBhcmEgcmVndWxhcml6YWNhbyBkZSBlcnJvIG9jb3JyaWRvIG5hIGVtaXNzYW8gZGUgZG9jdW1lbnRvIGZpc2NhbCwgZGVzZGUgcXVlIG8gZXJybyBuYW8gZXN0ZWphIHJlbGFjaW9uYWRvIGNvbTogSSAtIGFzIHZhcmlhdmVpcyBxdWUgZGV0ZXJtaW5hbSBvIHZhbG9yIGRvIGltcG9zdG8gdGFpcyBjb21vOiBiYXNlIGRlIGNhbGN1bG8sIGFsaXF1b3RhLCBkaWZlcmVuY2EgZGUgcHJlY28sIHF1YW50aWRhZGUsIHZhbG9yIGRhIG9wZXJhY2FvIG91IGRhIHByZXN0YWNhbzsgSUkgLSBhIGNvcnJlY2FvIGRlIGRhZG9zIGNhZGFzdHJhaXMgcXVlIGltcGxpcXVlIG11ZGFuY2EgZG8gcmVtZXRlbnRlIG91IGRvIGRlc3RpbmF0YXJpbzsgSUlJIC0gYSBkYXRhIGRlIGVtaXNzYW8gb3UgZGUgc2FpZGEuPC94Q29uZFVzbz48L2RldEV2ZW50bz48L2luZkV2ZW50bz48U2lnbmF0dXJlIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1IiAvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiIC8+PFJlZmVyZW5jZSBVUkk9IiNJRDExMDExMDMxMjUwOTIzNjQwMjYxMDAwMTcxNTU3NzAwMDAwMDAxMzcxMDAxNTMyMDMzMDEiPjxUcmFuc2Zvcm1zPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjZW52ZWxvcGVkLXNpZ25hdHVyZSIgLz48VHJhbnNmb3JtIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUiIC8+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjc2hhMSIgLz48RGlnZXN0VmFsdWU+VkhlWTlpT0xtdTkyNG9PT28yVjNoclNRU2g0PTwvRGlnZXN0VmFsdWU+PC9SZWZlcmVuY2U+PC9TaWduZWRJbmZvPjxTaWduYXR1cmVWYWx1ZT5kVTZTdmRYVEc5WUxPUHltR3VWTGcvUFIzMkI5UVVaekJEOEJPWDFXR013UExIVTBDZnlWNEpPdnhtUGNQdkxxdjBUQWJmUXVobEFzcnc2RFZ4WDFaQzVJaTU0TjZhWU94WVMza2xnTEFFcVkvREwyYk9WVnJOK3pRZHpUWlRRL1o5UndmdWVQeXlvam9mOU1QU1VtUDRtbVZXV3ZHRjI3bVp0VU4rSHVWVEVVcm9MMHdTQ2ZKV1d0RkQ3alVqOUQvYUM2RTVLZk50ekZHNFY1UGFSOHZUcmR0RTZTRXNsdGpCL25DVXYrM2dIVnowbmZwK0JCT21CUUNFalMxMGwwWExTZjV0dnk0RmpkbkxJbHVoWnFNWW5XQlVmQnRrTE9mRFR2MDVMOUdVMTg0Y1FvWW83bWVrVW8zbHdqN0FpWnlzdTdRQlFWd012d1VmNzNlMGRpaUE9PTwvU2lnbmF0dXJlVmFsdWU+PEtleUluZm8+PFg1MDlEYXRhPjxYNTA5Q2VydGlmaWNhdGU+TUlJSGlEQ0NCWENnQXdJQkFnSU5BUE5qMURLK2dxZm9WMk5kOURBTkJna3Foa2lHOXcwQkFRc0ZBRENCaVRFTE1Ba0dBMVVFQmhNQ1FsSXhFekFSQmdOVkJBb01Da2xEVUMxQ2NtRnphV3d4TmpBMEJnTlZCQXNNTFZObFkzSmxkR0Z5YVdFZ1pHRWdVbVZqWldsMFlTQkdaV1JsY21Gc0lHUnZJRUp5WVhOcGJDQXRJRkpHUWpFdE1Dc0dBMVVFQXd3a1FYVjBiM0pwWkdGa1pTQkRaWEowYVdacFkyRmtiM0poSUZORlVsQlNUMUpHUW5ZMU1CNFhEVEkxTURZeE1qRTJNamsxT1ZvWERUSTJNRFl4TWpFMk1qazFPVm93Z2dFcE1Rc3dDUVlEVlFRR0V3SkNVakVMTUFrR0ExVUVDQXdDVFVjeEdEQVdCZ05WQkFjTUQxQlBRMDlUSUVSRklFTkJURVJCVXpFVE1CRUdBMVVFQ2d3S1NVTlFMVUp5WVhOcGJERVRNQkVHQTFVRUN3d0tjSEpsYzJWdVkybGhiREVYTUJVR0ExVUVDd3dPTVRFMk5qY3lOak13TURBeE56VXhOakEwQmdOVkJBc01MVk5sWTNKbGRHRnlhV0VnWkdFZ1VtVmpaV2wwWVNCR1pXUmxjbUZzSUdSdklFSnlZWE5wYkNBdElGSkdRakVWTUJNR0ExVUVDd3dNUVZKTVQxQkZVME5QVTFSQk1SWXdGQVlEVlFRTERBMVNSa0lnWlMxRFRsQktJRUV4TVVrd1J3WURWUVFEREVCVFQwTkpSVVJCUkVVZ1NVNVVSVkpGVTFSQlJGVkJUQ0JFUlNCVVVrRk9VMUJQVWxSRlV5QkRRVkpXUVV4SVR5Qk1Pakl6TmpRd01qWXhNREF3TVRjeE1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBZzhYQmU3aThoazd2Y0hPY3V0Wml3ZDNhUzRQZzNoZDUzVTRGL3N0NGQ0Q1I0Mi85ZlJETzJUVFQrK3c5dDkwMWZsWUd6NXV3bHFOL3o3ZHZObWxON1BmVVBnd0pPMytWbzdzbnJXU2h3TU9pSjNQNWxHeFhSZ2NkVVNOOU5Da3Ruc3ZTbzFyWUNIRzJxWkVCN0xvOFQvMGFZNURCcVZCaTF2T29GRTFHMENTdFZkNERqMG1MNFdKWHpOaHN5bi9jdzgwZis2ak1FSjRLZzVIN1ludm5JS3RUdmRQS0JhS2FpNjhicVJlb1J1Kzk4TXJMMG92Y0dpWEJ1bFNqbEVNcTluRm52Sk1Nb2UwSklMM2ZnT291QjN1blFtR05ha3FDY0ZUcWJOZ1pEdk93VWhMakZQdmRqS29jaFNrNGtIYlU0MEc0M3BVcVo0dEtvQk05VGV2QzlRSURBUUFCbzRJQ1NqQ0NBa1l3SHdZRFZSMGpCQmd3Rm9BVUZJQXRuWDZhUmNEeFd6OFoxVUN3Ynk5bDRPa3dEZ1lEVlIwUEFRSC9CQVFEQWdYZ01Gc0dBMVVkSUFSVU1GSXdVQVlHWUV3QkFnRUtNRVl3UkFZSUt3WUJCUVVIQWdFV09HaDBkSEE2THk5eVpYQnZjMmwwYjNKcGJ5NXpaWEp3Y204dVoyOTJMbUp5TDJSdlkzTXZaSEJqWVdOelpYSndjbTl5Wm1JdWNHUm1NSUd6QmdOVkhSRUVnYXN3Z2FpZ1BRWUZZRXdCQXdTZ05BUXlNRFF3TXpFNU5Ua3lPRFk1T1RVM01qWXlNREF3TURBd01EQXdNREF3TURBd01EQXdNREUzT0RFNE5ERXdVMU5RVFVlZ0hnWUZZRXdCQXdLZ0ZRUVRTazlUUlNCU1NVTkJVa1JQSUVkVlJWSlNRYUFaQmdWZ1RBRURBNkFRQkE0eU16WTBNREkyTVRBd01ERTNNYUFYQmdWZ1RBRURCNkFPQkF3d01EQXdNREF3TURBd01EQ0JFM0pwWTJGeVpHOUFaMjFoWmk1amIyMHVZbkl3SFFZRFZSMGxCQll3RkFZSUt3WUJCUVVIQXdJR0NDc0dBUVVGQndNRU1JR0lCZ05WSFI4RWdZQXdmakE4b0RxZ09JWTJhSFIwY0RvdkwzSmxjRzl6YVhSdmNtbHZMbk5sY25CeWJ5NW5iM1l1WW5JdmJHTnlMMkZqYzJWeWNISnZjbVppZGpVdVkzSnNNRDZnUEtBNmhqaG9kSFJ3T2k4dlkyVnlkR2xtYVdOaFpHOXpNaTV6WlhKd2NtOHVaMjkyTG1KeUwyeGpjaTloWTNObGNuQnliM0ptWW5ZMUxtTnliREJXQmdnckJnRUZCUWNCQVFSS01FZ3dSZ1lJS3dZQkJRVUhNQUtHT21oMGRIQTZMeTl5WlhCdmMybDBiM0pwYnk1elpYSndjbTh1WjI5MkxtSnlMMk5oWkdWcFlYTXZZV056WlhKd2NtOXlabUoyTlM1d04ySXdEUVlKS29aSWh2Y05BUUVMQlFBRGdnSUJBSElpS0d6L1ZtbmpOSHV4ckI5VXgzR1kwd0RUTXlQV3g5VFZWNC9NRjcydWtOS3ZscGJvM1ZKZGw2TlgxaFlBcXZ6TnRxMzdKWW5uaVhBdjA2SVpVVE1CdlFkYnhuY09GTVpBakk4T1ZYbVozK1c5bkx2WXNiRXZURkJueEs1RkZXVTFKMEt5OG8xalIzNWJWelJHaWJLTWsvQVRlaEM4aTNKTG9ETHJ2TkJ3S1JGSFNKZlZ0TzE2ZWJjc1BseGIyejZuaEFvV2s0UDkrWm5ESDFaQkIwQ09mMmdXZUVTc0x5eFpMSlFWWXhEZzZ3QzcyUmE1RVRhZzh1aVU0TkRkRFZuZ2YwdTJ6NDZJelh6TlNrclRzNHA1RXZIdE9DSm9oSlAwbUhjY0t2UUU1bHc3NElSYzl0RDdJZ0p4QklGRE13anVUajFZZDdoVG5FY0V3VXJMb1lZZGNUVFluMmZOUVBpK3F3ZWZiamdYNDBzTytvenVveDdDWlIvWm1GdjNZWDkyUitKOTU5SHFKVHpLRW5pNlljYTJVUFArM05EcE9iVk11dGhBUThHVTJ3c2NHUkNDeS81RGJ3S2lEbnhhL2UvTlFRWDY5NHdJZ2U1S280ZGpXa3N0NnQvb1JtakpTVWpnK3ZCd1BPYmZFbWJJY1dGRVFlOVVzMTRrSnJJc3BKN1VTakhROUZkZEhtZVFBa3hpYTVyR05sdmxDSDcyRFErQjRjdFJyUmpQWDA3bG1ad1diT3Nsb2xKM0ZVQVpmMWpSbWpaMDFXMUF1VCtyb0tqTHZrQ3ViS1A1S3ZkeDVvSDN2cy80emo4U3JpQ3BDeUdIa3pVMXQ4VjBtODljS0gvbTZqck9Tc1dsYXp6cDNXSmJGa2NBYVh6amhUeElYRlQ4c3VHU29QOEg8L1g1MDlDZXJ0aWZpY2F0ZT48L1g1MDlEYXRhPjwvS2V5SW5mbz48L1NpZ25hdHVyZT48L2V2ZW50bz48cmV0RXZlbnRvIHZlcnNhbz0iMS4wMCI+PGluZkV2ZW50byBJZD0iSUQxMzEyNTAxNTEwNTE4NDIiPjx0cEFtYj4yPC90cEFtYj48dmVyQXBsaWM+Vy0zLjMuOTwvdmVyQXBsaWM+PGNPcmdhbz4zMTwvY09yZ2FvPjxjU3RhdD4xMzU8L2NTdGF0Pjx4TW90aXZvPkV2ZW50byByZWdpc3RyYWRvIGUgdmluY3VsYWRvIGEgTkYtZS48L3hNb3Rpdm8+PGNoTkZlPjMxMjUwOTIzNjQwMjYxMDAwMTcxNTU3NzAwMDAwMDAxMzcxMDAxNTMyMDMzPC9jaE5GZT48dHBFdmVudG8+MTEwMTEwPC90cEV2ZW50bz48blNlcUV2ZW50bz4xPC9uU2VxRXZlbnRvPjxDTlBKRGVzdD4wNjM1NDk3NjAwMDE0OTwvQ05QSkRlc3Q+PGRoUmVnRXZlbnRvPjIwMjUtMDktMThUMTY6MTM6MDEtMDM6MDA8L2RoUmVnRXZlbnRvPjxuUHJvdD4xMzEyNTAxNTEwNTE4NDI8L25Qcm90PjwvaW5mRXZlbnRvPjwvcmV0RXZlbnRvPjwvcHJvY0V2ZW50b05GZT4=</DocEveXML><DocEveXMLLink /><cStat>135</cStat><DocEveDescricao>Evento registrado e vinculado a NF-e.</DocEveDescricao><DocEveId>110110312509111111111111115577000000013710015320331</DocEveId><DocEvePDF /><DocEvePDFLink /><DocEveProtocolo>131250151051842</DocEveProtocolo><DocEveDhReg>2025-09-18T16:13:01</DocEveDhReg></EventosItem></Eventos><NFSe><NFSeNumero>0</NFSeNumero><NFSeCodVerificacao /></NFSe></Documento>]]></Documento>
</DocumentosItem>
</Documentos>
</MensagemItem>
</Mensagem>
</Invoicyretorno>
</consultadocumentos.ExecuteResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
O InvoiCy conta com um controle das requisições recebidas, onde ao receber várias vezes a mesma requisição de consulta, dentro de um determinado período de tempo, irá bloquear essa requisição para prevenir que o ERP do cliente não entre em loop e cause lentidão no sistema.
Para evitar o bloqueio do Web Service, recomenda-se que em caso de consulta de documento, deve-se adicionar um "sleep" entre uma e outra conexão, de 15 segundos, por exemplo, e também limitar o número total de consultas.
Além disso, o limite de documentos retornados na consulta é de 100, mas este valor pode ser alterado para menos, em escala de 50 em 50, sendo 50 a menor quantidade retornada. Caso a quantidade consultada for maior que 100, a consulta não será executada e nenhum documento será retornado.
Caso seja executada uma consulta de um documento que não existe na base de dados do InvoiCy, o usuário receberá o retorno: 117 – "Documento não localizado. Verifique as informações enviadas e tente novamente em alguns segundos.".