Submeter evento de manifestação do destinatário (rota recomendada)
POST/productinvoices/by-access-key/:access_key/manifestation-events
Rota recomendada para a manifestação do destinatário de NF-e
(substitui o legado POST /{access_key}/manifest). Aceita também os
eventos da NT 2025.002-RTC, de sucessora e o cancelamento de evento.
Códigos aceitos em eventCode: 4 de manifestação do destinatário
(210200, 210210, 210220, 210240), 6 do destinatário na NT 2025.002-RTC
(211110, 211124, 211128, 211130, 211140, 211150), 2 de sucessora
(212110 IBS, 212120 CBS) e 1 de cancelamento de evento (110001).
Qualquer outro código responde 400, inclusive o 211120 (consumo
pessoal), removido pela NT 2025.002-RTC v1.40, e os eventos do Fisco
(412120 e 412130), que são somente leitura.
Validação síncrona: chave com 44 dígitos, nSequencia >= 1, código
aceito, detail compatível com o código e inbound de NF-e ativo para a
empresa. O 210240 exige detail.justification com 15 a 255 caracteres:
sem ela a submissão responde 400 (antes era aceita e o evento terminava
Rejected). Falhas respondem 400 e nada é enfileirado.
A submissão é assíncrona: a resposta é 202 com o evento em
status: Pending e o header Location apontando para o detalhe. O
envio à SEFAZ acontece em segundo plano. Não há webhook de
conclusão: acompanhe por polling no GET do detalhe até o status virar
Accepted, Rejected ou Failed.
Idempotência: existe no máximo um evento Pending ou Accepted por
(access_key, eventCode, nSequencia). Repetir a submissão nesse caso
responde 409, sem nova ida à SEFAZ. Eventos Rejected ou Failed
podem ser reenviados.
Request
Responses
- 202
- 400
- 401
- 409
Aceito para processamento assíncrono (status Pending); o header Location aponta para o detalhe do evento
Response Headers
URL do GET /productinvoices/manifestation-events/{id}
Chave sem 44 dígitos, nSequencia menor que 1, eventCode não aceito (inclusive 211120 e eventos do Fisco), detail ausente ou inválido para o código (ex.: 210240 sem justification de 15 a 255 caracteres) ou inbound de NF-e não ativo para a empresa
Response Headers
Unauthorized
Response Headers
Já existe um evento Pending ou Accepted para a mesma (access_key, eventCode, nSequencia)