Dúvida
Como ocorre o fluxo de comunicação entre o eDocs e o Motor Senior para o monitoramento de NFS-e dos município homologados?
 
Solução
 
Importante
Os exemplos a seguir estão indentados para facilitar a visualização, recomenda-se fazer esse processo durante a análise.
 
O fluxo de comunicação entre o eDocs e o Motor Senior ocorre conforme descrito abaixo:
 

Exemplo de consulta:

2023-05-08 13:56:37,875 [12] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.Consultar - XML: <?xml version="1.0" encoding="utf-8"?>
<InvoiCy xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
 <Cabecalho xmlns="InvoiCy">
     <EmpPK>XXXXXXXXXXX==</EmpPK>
     <EmpCK>YYYYYYYYYYYY</EmpCK>
 </Cabecalho>
 <Dados xmlns="InvoiCy">
     <DadosItem>
         <Documento>
             <EnvioLote>
                 <ModeloDocumento>NFSe</ModeloDocumento>
                 <tpAmb>2</tpAmb>
                 <CnpjEmpresa>00000000000000</CnpjEmpresa>
                 <DataInclusaoInicial>2023-04-08T13:56:37</DataInclusaoInicial>
                 <DataInclusaoFinal>2023-05-08T13:56:37</DataInclusaoFinal>
                 <EmitidoRecebido>R</EmitidoRecebido>
             </EnvioLote>
         </Documento>
         <Parametros>
             <ParametrosConsulta>
                 <XMLCompleto>S</XMLCompleto>
                 <PDFBase64>S</PDFBase64>
             </ParametrosConsulta>
         </Parametros>
     </DadosItem>
 </Dados>
</InvoiCy>

2. Retorno Protocolo: Neste momento o Motor Senior retorna ao eDocs o Protocolo do lote agendando do processamento;
 
Exemplo de retorno:

2023-05-08 13:56:38,247 [12] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.Consultar - XML: <?xml version="1.0" encoding="utf-8"?>
<Invoicyretorno xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
 <Mensagem xmlns="InvoiCy">
     <MensagemItem>
         <Codigo>100</Codigo>
         <Descricao>Lote agendado com sucesso. Realize a consulta dos protocolos posteriormente</Descricao>
         <Documentos>
             <DocumentosItem>
                 <Documento>
                     <Protocolo>
                         <ProtNumero>000000000000000</ProtNumero>
                         <ProxConsultaProtocolo>2023-05-08T14:06:38</ProxConsultaProtocolo>
                     </Protocolo>
                 </Documento>
             </DocumentosItem>
         </Documentos>
     </MensagemItem>
 </Mensagem>
</Invoicyretorno>
 

3. Consulta Protocolo: Neste momento o eDocs enviará a consulta do protocolo ao Motor Senior;
 
Exemplo de consulta:

2023-05-08 13:57:40,829 [284] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.ConsultarProtocolo - XML: <?xml version="1.0" encoding="utf-8"?>
<InvoiCy xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
 <Cabecalho xmlns="InvoiCy">
     <EmpPK>XXXXXXXXXXXXXXX</EmpPK>
     <EmpCK>YYYYYYYYYYYYYYYY</EmpCK>
 </Cabecalho>
 <Dados xmlns="InvoiCy">
     <DadosItem>
         <Documento>
             <ConsultaLote>
                 <CnpjEmpresa>00000000000000</CnpjEmpresa>
                 <ProtNumero>000000000000</ProtNumero>
             </ConsultaLote>
         </Documento>
     </DadosItem>
 </Dados>
</InvoiCy>
 

4. Retorno Protocolo/Documentos: Neste momento o Motor Senior retornará uma das seguintes situações:
4.1. Informando que o protocolo não está liberado. Baseado neste retorno, o eDocs fará a consulta do protocolo até que haja um retorno positivo;

 
Exemplo de retorno:

2023-05-08 14:00:41,729 [278] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.ConsultarProtocolo - XML: <?xml version="1.0" encoding="utf-8"?>
<Invoicyretorno xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
 <Mensagem xmlns="InvoiCy">
     <MensagemItem>
         <Codigo>102</Codigo>
         <Descricao>Protocolo não liberado</Descricao>
         <Documentos>
             <DocumentosItem>
                 <Documento>
                     <ConsultaProtocolo>
                         <ProxProtocolo/>
                         <ProxConsultaProtocolo>2023-05-08T14:10:41</ProxConsultaProtocolo>
                         <DocBase64/>
                     </ConsultaProtocolo>
                 </Documento>
             </DocumentosItem>
         </Documentos>
     </MensagemItem>
 </Mensagem>
</Invoicyretorno>
 

4.2. Informando que o protocolo foi processado;

 
Observação
Haverá o retorno contendo a tag <DocBase64> e abaixo deste retorno haverão outros registros de log, neles poderão ser vistas as informações do documentos trafegados.
 
Exemplo de retorno:

2023-05-08 14:07:48,970 [284] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.ConsultarProtocolo - XML:
<?xml version="1.0" encoding="utf-8"?>
<Invoicyretorno xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
 <Mensagem xmlns="InvoiCy">
     <MensagemItem>
         <Codigo>100</Codigo>
         <Descricao>Protocolo processado</Descricao>
         <Documentos>
             <DocumentosItem>
                 <Documento>
                     <ConsultaProtocolo>
                         <ProxProtocolo/>
                         <ProxConsultaProtocolo p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance"/>
                         <DocBase64>UEsDBBSDSDwiJPHHI...AAUUkhtfptTiTfpGtf0phAAA==</DocBase64>
                     </ConsultaProtocolo>
                 </Documento>
             </DocumentosItem>
         </Documentos>
     </MensagemItem>
 </Mensagem>
</Invoicyretorno>
 
Exemplo de documento trafegado:

2023-05-08 14:07:49,026 [284] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.ConsultarProtocolo - XML:
<nfse>
 ....
 Tradução da NFS-e no leiaute Senior
 ....
 <anexos>
     <base64Content>JVBERi0xLjMKJdP...cnR4cmVmCjcxOTYKJSVF</base64Content>
     <docType>.pdf</docType>
     <name>DANFSE-NFSe-0000000000000000000000000000000</name>
 </anexos>
</nfse>
 
Observação
Em casos onde o retorno ocorrer corretamente, o documento deverá estar integrado na respectiva aba, caso não seja integrado, uma crítica de integração será apresentada.
 

4.3. Informando que nenhum documento foi localizado na base;

 
Exemplo de retorno:

2023-05-09 17:04:07,186 [284] WARN  NB020560 - Senior.SapiensNfe.Processos.Service.Documento.Recebimento.Invoicy.ClienteInvoicy.ConsultarProtocolo - XML: <?xml version="1.0" encoding="utf-8"?>
<Invoicyretorno xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
  <Mensagem xmlns="InvoiCy">
      <MensagemItem>
          <Codigo>101</Codigo>
          <Descricao>Nenhum documento localizado na base de dados</Descricao>
          <Documentos>
              <DocumentosItem>
                  <Documento>
                      <ConsultaProtocolo>
                          <ProxProtocolo/>
                          <ProxConsultaProtocolo p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance"/>
                          <DocBase64/>
                      </ConsultaProtocolo>
                  </Documento>
              </DocumentosItem>
          </Documentos>
      </MensagemItem>
  </Mensagem>
</Invoicyretorno>
 

Observação

• Para mais informações sobre o processo de recebimento de NFS-e, consulte o artigo ERP – eDocs NFS-e Recebimento – Onde encontrar informações sobre o recebimento de NFS-e (índice).