> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Manifestação do destinatário

> Dar ciência, confirmar ou recusar uma nota recebida e liberar o XML completo.

A **manifestação do destinatário** é como você responde à SEFAZ sobre uma nota
emitida contra o seu CNPJ: se reconhece a operação, se confirma, se desconhece.
Ela tem dois papéis:

* **Registra a sua posição** sobre a nota na SEFAZ (obrigatório em alguns casos,
  como notas de valor elevado).
* **Libera o XML autorizado completo.** Enquanto você não manifesta, a nota fica
  só como resumo (`isComplete: false`). Após a manifestação, a SEFAZ
  disponibiliza o XML integral e o DANFE passa a poder ser gerado — **não de
  forma imediata**, depende da SEFAZ redistribuir o documento. Veja
  [Visão geral](/guides/notas-recebidas/nfe/visao-geral).

## Tipos de manifestação

| `status`       | Nome                        | Quando usar                                                                                                              | Justificativa | Definitiva?                       |
| -------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------- | --------------------------------- |
| `acknowledged` | Ciência da operação         | Você tomou conhecimento da nota, mas ainda não vai confirmar nem recusar. É a forma mais leve de liberar o XML completo. | Não           | Não — pode ser substituída depois |
| `confirmed`    | Confirmação da operação     | Você reconhece e **confirma** que a operação ocorreu.                                                                    | Não           | Sim                               |
| `unknown`      | Desconhecimento da operação | Você **não reconhece** a operação (ex.: nota indevida ou possível fraude).                                               | **Sim**       | Sim                               |
| `notPerformed` | Operação não realizada      | A operação era destinada a você, mas **não se concretizou** (ex.: recusa da mercadoria).                                 | **Sim**       | Sim                               |

<Note>
  A **justificativa** é obrigatória para `unknown` e `notPerformed`, com **15 a
  255 caracteres**. A **Ciência** é o único tipo que pode ser **substituído**
  mais tarde por uma manifestação definitiva; `confirmed`, `unknown` e
  `notPerformed` são **definitivas** e não podem ser desfeitas.
</Note>

## Como manifestar

```json POST /v1/inbound-product-invoices/{id}/manifest theme={null}
{
  "status": "acknowledged",
  "justification": null
}
```

Exemplo com justificativa obrigatória:

```json POST /v1/inbound-product-invoices/{id}/manifest theme={null}
{
  "status": "unknown",
  "justification": "Não reconhecemos esta operação; não houve compra deste fornecedor."
}
```

A resposta é **imediata e síncrona**: a Spedy envia a manifestação à SEFAZ e
aguarda o retorno. Se a SEFAZ **recusar** (por exemplo, uma manifestação
definitiva já registrada), a requisição retorna **erro com o motivo** e **nada é
gravado** — diferente da emissão, aqui não há processamento assíncrono.

## Fluxo recomendado

<Steps>
  <Step title="A nota chega como resumo">
    Você recebe o webhook `inbound_invoice.detected` (ou encontra a nota na
    listagem) com `isComplete: false`. Confira emissor, valor e chave.
  </Step>

  <Step title="Você manifesta">
    Na maioria dos casos, **Ciência** (`acknowledged`) basta para prosseguir e
    liberar o XML. Use `confirmed` quando quiser confirmar formalmente a
    operação, ou `unknown`/`notPerformed` (com justificativa) para recusá-la.
  </Step>

  <Step title="O XML completo é liberado (não é imediato)">
    A manifestação é registrada na hora, mas a liberação do XML completo
    **depende da SEFAZ** redistribuir o documento — não é instantâneo, pode
    levar de alguns minutos a mais. Quando acontece, a nota passa a
    `isComplete: true`, você recebe o webhook `inbound_invoice.completed` e o
    XML autorizado completo e o DANFE ficam disponíveis para download e
    escrituração. Por isso, prefira **reagir ao webhook** em vez de ficar
    consultando logo após manifestar.
  </Step>
</Steps>

<Warning>
  Se o seu objetivo é apenas **obter o XML para escrituração**, prefira a
  **Ciência** — ela libera o documento sem assumir uma posição definitiva sobre
  a operação. Reserve `confirmed`, `unknown` e `notPerformed` para quando você
  realmente quiser registrar essa posição, porque não há volta.
</Warning>