ConsultaStatusGoverno

Descrição: Retorna o status do DF-e do portal da Sefaz.

URL do WSDL: https://dfe.systax.com.br/WSDFe/DFe_Geral.svc?wsdl

Atenção: A Sefaz permite a consulta do Status Governo por até 6 meses a partir da data de emissão do documento, caso passe dos 6 meses não retornará mais atualização desse status. Nessa rotina fazemos a consulta 1 vez a cada hora nas primeiras 24 horas, passado 1 dia até o 7º dia a consulta é realizada 1 vez por dia e do 8º até o 35º a consulta é realizada a cada 2 dias. Caso esse limite seja excedido, o usuário é bloqueado. Por isso, caso queira retornar o status de um DF-e sem limitações, orientamos utilizar o método "ConsultaStatus" descrito nesse documento. 

Descrição dos campos de chamada

Campo 

Tipo

Descrição

Obrigatório

usuario

stirng

Usuário do DFE

Sim

senha

string

Senha do usuário 

Sim

chave

string

Chave do documento fiscal

Sim

modDoc

inter

Modelo do Documento

NF-e = 55

NFC-e = 65

CT-e = 57

CT-eOS = 67

Não

Descrição dos campos de retorno

Campo

Descrição

codigo

Código de status de requisição

mensagem

Mensagem de status de requisição

xmlRetorno

XML de retorno do DF-e consultado na Sefaz

mensagemRetorno

Mensagem de retorno da Sefaz

status

Código de retorno da Sefaz

Tabela de código (campos "código" e "mensagem" do retorno)

Código

Mensagem

0

Consulta de status realizada com sucesso

1

Chamada incompleta

2

Usuário e/ou senha inválidos

 Login falhou, usuário com mais de 1 cliente cadastrado. Contate os administradores

3

Erro na consulta de status

Documento " + chamada.chave + " não encontrado na DFe

999

A operação não pode ser concluída. Contate os administradores

Exemplos de chamada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wsd="http://schemas.datacontract.org/2004/07/WSDFe.chamada">

   <soapenv:Header/>

   <soapenv:Body>

      <tem:ConsultaStatusGoverno>

         <tem:chamadaConsultaStatus>

            <wsd:usuario>usuário</wsd:usuario>

            <wsd:senha>senha</wsd:senha>

          <wsd:chave>35201208736011000227550010005459701018541123</wsd:chave>

            <wsd:modDoc>XX</wsd:modDoc>

         </tem:chamadaConsultaStatus>

      </tem:ConsultaStatusGoverno>

   </soapenv:Body>

</soapenv:Envelope>

 

 

Exemplo de retorno

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <ConsultaStatusGovernoResponse xmlns="http://tempuri.org/">
         <ConsultaStatusGovernoResult xmlns:a="http://schemas.datacontract.org/2004/07/WSDFe.retorno" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:statusGeral>
               <a:codigo>0</a:codigo>
               <a:mensagem>Consulta de Status realizada com sucesso.</a:mensagem>
            </a:statusGeral>
            <a:xmlRetorno><![CDATA[<retConsSitNFe versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe"><tpAmb>1</tpAmb><verAplic>SP_NFE_PL009_V4</verAplic><cStat>100</cStat><xMotivo>Autorizado o uso da NF-e</xMotivo><cUF>35</cUF><dhRecbto>2020-12-14T13:50:36-03:00</dhRecbto><chNFe>35201208736011000227550010005459701018541072</chNFe><protNFe versao="4.00"><infProt><tpAmb>1</tpAmb><verAplic>SP_NFE_PL009_V4</verAplic><chNFe>35201208736011000227550010005459701018541072</chNFe><dhRecbto>2020-12-01T17:23:21-03:00</dhRecbto><nProt>135201122922050</nProt><digVal>iwtGKkKhkXgFN4FdW1HIKKMqo4k=</digVal><cStat>100</cStat><xMotivo>Autorizado o uso da NF-e</xMotivo></infProt></protNFe></retConsSitNFe>]]></a:xmlRetorno>
            <a:mensagemRetorno>100 - Autorizado o uso da NF-e</a:mensagemRetorno>
            <a:status>100</a:status>
         </ConsultaStatusGovernoResult>
      </ConsultaStatusGovernoResponse>
   </s:Body>
</s:Envelope>