Manifestação de Documentos

Este serviço permite que o destinatário da Nota Fiscal eletrônica confirme a sua participação na operação acobertada pela Nota Fiscal Eletrônica emitida para o seu CNPJ, através do envio da mensagem de:

• Confirmação da Operação – confirmando a ocorrência da operação e o recebimento da mercadoria (para as operações com circulação de mercadoria); 
• Desconhecimento da Operação – declarando o desconhecimento da operação; 
• Operação Não Realizada – declarando que a operação não foi realizada (com recusa do Recebimento da mercadoria e outros) e a justificativa do porquê a operação não se realizou; 
• Ciência da Emissão (ou Ciência da Operação) – declarando ter ciência da operação destinada ao CNPJ, mas ainda não possuir elementos suficientes para apresentar uma manifestação conclusiva, como as acima citadas.

O autor do evento é o destinatário da NF-e. A ciência da emissão é um evento opcional que pode ser utilizado pelo destinatário para declarar que tem ciência da existência da operação, mas ainda não tem elementos suficientes para apresentar uma manifestação conclusiva. 

A Sefaz disponibiliza o download do XML completo de uma NF-e para o destinatário apenas após a realização da Ciência da Emissão. Antes de realizar a ciência é possível obter apenas o resumo do XML.

Veja página de Download de documentos na NS DDF-e API para saber como efetuar o download os documentos utilizando a NS DDF-e API.

Fluxo de processamento

URL 

https://ddfe.ns.eti.br/events/manif

ou

https://ddfe.ns.eti.br/nfe/manifestacao

Dados de entrada

Exemplo de requisição

Exemplo de JSON de manifestação

{
    "X-AUTH-TOKEN": "SEU_TOKEN",
    "CNPJInteressado": "99999999999999",
    "chave": "99999999999999999999999999999999999999999999",
    "manifestacao": {
        "tpEvento": "210200"
    }
}

Exemplo de requisição de manifestação

curl -i -X POST \
-H "Content-Type: application/json" \
-d '{
     "X-AUTH-TOKEN": "SEU_TOKEN", 
     "CNPJInteressado": "99999999999999", 
     "chave": "99999999999999999999999999999999999999999999", 
     "manifestacao": { 
          "tpEvento": "210200"
     }
}' \
https://ddfe.ns.eti.br/events/manif

Dados retornados

Exemplo de retorno 

Retorno com manifestação autorizada

{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "retEvento": {
        "cStat": 135,
        "xMotivo": "Evento registrado e vinculado a NF-e",
        "dhRegEvento": "2017-03-14T19:12:54-03:00",
        "nProt": "891170000523804",
        "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoNFe>...</procEventoNFe>"
    }
}

Retorno com erro

{
    "status": -3,
    "motivo": "Nao foi possivel manifestar o documento",
    "erro": {
        "cStat": 999,
        "xMotivo": "Erro Posicao 158 linha 1 The 'Id' attribute has an invalid value according to its data type.Erro Posicao 380 linha 1 The 'http://www.portalfiscal.inf.br/nfe:tpEvento' element has an invalid value according to its data type.Erro Posicao 445 linha 1 The element 'detEvento' in namespace 'http://www.portalfiscal.inf.br/nfe' has incomplete content. List of possible elements expected: 'http://www.portalfiscal.inf.br/nfe:descEvento'."
    }
}

Códigos de retorno