Skip to main content
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.

​
Tipos de manifestação

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.

​
Como manifestar

POST /v1/inbound-product-invoices/{id}/manifest
Exemplo com justificativa obrigatória:
POST /v1/inbound-product-invoices/{id}/manifest
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

1

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.
2

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.
3

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.
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.