Consultar MDF-e Emitido - Por Protocolo

GET /api/MDFeEmissao/buscarPorProtocolo

Após enviar um manifesto para emissão, é possível realizar a consulta do status do processamento do mesmo, através do protocolo que foi gerado na emissão.

Para realizar a consulta, basta passar o parâmetro “protocolo”.

Exemplo de Requisição:

CODE

api/MDFeEmissao/buscarPorProtocolo?protocolo=7f2752a2-2da7-43b2

Exemplo de Retorno:

CODE

{ 

    "tipoRetorno": 1, 

    "envio": { 

        "numeroProtocolo": "2680900b-123a-4d0e-a623-307cc57236b9", 

        "documento": "string do conteúdo do documento", 

        "chaveDocumento": "35230499999999999999571000000000161440586453", 

        "numero": 16, 

        "serie": "100", 

        "dataEmissao": "2023-08-10T11:15:33.527-03:00", 

        "protocoloSefaz": "2680900b-123a-4d0e-a623-307cc57236b9", 

        "cStat": "100", 

        "motivo": "Autorizado Uso do MDF-e." 

    }, 

    "processamento": { 

        "message": "Sucesso", 

        "protocolo": "2680900b-123a-4d0e-a623-307cc57236b9" 

    } 

}

Observação

A estrutura de retorno a API V1 possui particularidades de parâmetros no retorno conforme natureza do tipo de documentos.

Exemplo

Com os tipos de documentos NF-e/CT-e/MDF-e/CTeOS (SEFAZ), usando os modelos de consulta GET, você terá o retorno com os documentos apresentando os seguintes campos:

tipoRetorno: Código que indica o tipo de documento retornado (Envio = 1, Evento = 2, Inutilização = 3, Outro = 10, EmProcessamento = 11, Erro = 99).
NumeroProtocolo: GUID gerado aleatoriamente, que realiza o vínculo do processo com a nota de envio, sendo único para cada envio 1 - 1, não importando se é autorizado/cancelado/rejeitado/invalido é gerado um novo para cada processamento.
Documento: XML Retornado do Processamento.
chaveDocumento: Código único utilizado para identificar o documento fiscal. Geralmente é composto por informações como CNPJ do emitente, data de emissão, tipo de documento, entre outros.
Número: Número sequencial que identifica o documento fiscal de forma única. Este número é atribuído pelo emissor do documento.
Serie: Indica a série do documento fiscal, que é uma sequência numérica ou alfanumérica utilizada para controlar a emissão de documentos fiscais.
Dataemissão: Data em que o documento fiscal foi emitido.
ProtocoloSefaz: Número de protocolo gerado pela SEFAZ, que identifica a comunicação ou transação realizada com o órgão.
Cstat: Código que indica o status da comunicação ou transação com a SEFAZ, como "autorizado", "rejeitado", "pendente", etc.
Motivo: Informação adicional que indica o motivo de um determinado status, como motivo da rejeição de um documento.
Evento: Indica o tipo de evento relacionado ao documento fiscal, como "autorização de uso", "cancelamento", etc.
Outros: Se refere a informações adicionais que não se enquadram em nenhum dos campos padrão de um documento fiscal.

Em caso de dúvidas sobre algum termo utilizado, acesse o nosso Glossário.