1. Inicio
  2. Documentos
  3. NS DDFe
  4. Consumo da API NS DDFe
  5. Manifestação de Documentos

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
CampoDescriçãoTipoObrigatórioComentários
X-AUTH-TOKENToken de acesso da SHStringNãoPode ser enviado também no cabeçalho da requisição ou na URL via Query String
CNPJInteressadoCNPJ do interessado em receber o documentoStringSimEx.: CNPJ da transportadora, destinatário, terceiro referenciado no XML, etc...
nsuNúmero sequencial únicoIntegerNãoSe não for informado o campo chave deverá ser obrigatoriamente informado
chaveChave de acesso da NF-eStringNãoSe não for informado o campo nsu deverá ser obrigatoriamente informado
tpAmbAmbiente onde foi emitido o documento a ser manifestadoStringNâo
manifestacaoObjeto contendo dados específicos do eventoObjectSim
manifestacao.tpEventoCódigo do tipo do evento de manifestaçãoIntegerSimCódigos Possiveis do Tipo do Evento:
210200 – Confirmação da Operação
210210 – Ciência da Operação
210220 – Desconhecimento da Operação
210240 – Operação não Realizada
manifestacao.xJustInformar a justificativa porque a operação não foi realizada StringNãoEste campo deve ser informado somente no evento de Operação não Realizada
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
CampoDescriçãoTipoComentários
statusCódigo de status da requisição.Integer
motivoDescrição literal do statusString
retEventoObjeto contendo dados específicos do evento retornados pela SefazObjectApenas se o status igual à 200
retEvento.cStatCódigo de situação do eventoInteger
retEvento.xMotivoDescrição literal do cStatString
retEvento.dhRegEventoData e hora de autorização do eventoStringPadrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00
retEvento.nProtNúmero de protocolo de autorização do eventoString
retEvento.xmlXML do eventoString
erroObjeto contendo os dados específicos do erro ocorridoObjectApenas em status diferente de 200
erro.cStatCódigo de status do erroInteger
erro.xMotivoDescrição literal do erroString
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
CódigoDescrição
200NF-e manifestada com sucesso
-1Chave de acesso inválida
-2O campo xJust deve ser informado para o evento 210240 - Operação não Realizada
-3Não foi possível manifestar o documento Verifique o objeto erro para maiores informações

Como podemos ajudar?