NFS-e
Manifestar sobre NFS-e recibida
Registra la manifestación oficial de confirmación o rechazo en una NFS-e recibida; asíncrono, 200 con recibo de aceptación.
/openapi/v2/empresas/{empresaId}/nfse/recebidas/{chaveAcesso}/manifestartoken, timestamp y sign, vea Autenticación.Esta empresa actúa como tomadora o intermediaria y se manifiesta formalmente sobre una NFS-e recibida: tipo elige entre Confirmacao y Rejeicao, y en el rechazo el cuerpo lleva además el código oficial del motivo. La aceptación es asíncrona, y el resultado llega por los webhooks nfse.inbound.manifested / nfse.inbound.manifest_failed, que exigen suscripción explícita, o se lee en el bloque manifestacao del detalle de la NFS-e recibida. Cada parte manifiesta una sola vez por nota: una llamada tras confirmación, rechazo o confirmación tácita devuelve 10018042.
Parámetros de ruta
empresaId* | string | Identificador de la empresa |
chaveAcesso* | string | Clave de acceso |
* Campo obligatorio
Cuerpo de la petición
tipo* | string | Tipo de la manifestación |
codigoMotivo*obligatorio en el rechazo | string | Código del motivo del rechazo |
motivo | string | Descripción del rechazo |
* Campo obligatorio
nfse.inbound.manifested / nfse.inbound.manifest_failed, o en el bloque manifestacao del detalle de la NFS-e recibida.nfseTaskId | int | Id de la tarea en la plataforma |
status | int | Estado de la tarea |
reused | bool | Tarea reutilizada |
createTime | string | Momento de la aceptación |
La plataforma elige el código del evento por el papel de esta empresa en la nota, quien llama no envía ningún código: el tomador confirma con 203202 y rechaza con 203206; el intermediario confirma con 204203 y rechaza con 204207. El evento se registra en el emisor nacional y vuelve a todas las partes de la nota por la distribución nacional.
Confirmar
Solo tipo. Enviar codigoMotivo o motivo junto se rechaza con 10018001.
{ "tipo": "Confirmacao" }
tipo* | string | Tipo de la manifestación |
* Campo obligatorio
Rechazar
tipo más el código oficial del motivo; la descripción es opcional.
{"tipo": "Rejeicao","codigoMotivo": "3","motivo": "Servico nao prestado ao tomador"}
tipo* | string | Tipo de la manifestación |
codigoMotivo* | string | Código del motivo |
motivo | string | Descripción |
* Campo obligatorio
El HTTP 200 es solo el recibo de aceptación; reenviar la misma nota mientras la tarea original está en curso devuelve reused=true. El resultado llega por los webhooks nfse.inbound.manifested / nfse.inbound.manifest_failed, que exigen suscripción explícita en Registrar webhook, o se lee en el bloque manifestacao del detalle de la NFS-e recibida. El fallo importa: sin manifestación en el plazo, el municipio registra confirmación tácita, así que repita la manifestación antes del plazo.
Registrada: nfse.inbound.manifested
Sobre de evento; data mostrado abajo. Confirmación y rechazo llegan por el mismo evento, distinguidos por tipo.
{"version": "1.0","event_id": "1950000000000004","event_type": "nfse.inbound.manifested","occurred_at": "2026-09-21T14:00:05Z","data": {"inbound_id": "1950000000000777","chave": "35503082406730610001340000000000000000000000000077","tipo": "Rejeicao","evento": "203206","codigo_motivo": "3","motivo": "Servico nao prestado ao tomador","protocolo": "3550308000000000000000000000000000000000000000000001"}}
inbound_id* | string | Id de la nota recibida en la plataforma |
chave* | string | Clave de acceso |
tipo* | string | Tipo de la manifestación registrada |
evento* | string | Código oficial del evento registrado |
codigo_motivo | string | Código del motivo |
motivo | string | Descripción del motivo |
protocolo* | string | Protocolo de la autoridad |
* Campo obligatorio
Falló: nfse.inbound.manifest_failed
La autoridad rechazó el evento o el mensaje no pasó la validación del formato oficial (10018064). El bloque manifestacao sigue null; repita la manifestación antes del plazo.
{"version": "1.0","event_id": "1950000000000006","event_type": "nfse.inbound.manifest_failed","occurred_at": "2026-09-21T14:00:05Z","data": {"chave": "35503082406730610001340000000000000000000000000077","tipo": "Rejeicao","codigo": "E0231","motivo": "Evento nao permitido para o tipo de autor"}}
chave* | string | Clave de acceso |
tipo* | string | Tipo de la manifestación intentada |
codigo | string | Código del fallo |
motivo* | string | Motivo del fallo |
* Campo obligatorio
Bloque manifestacao en el detalle
Mismo formato en el detalle y en los ítems de la lista; null mientras no haya manifestación.
{"manifestacao": {"status": "Confirmada","codigoEvento": "203202","codigoMotivo": null,"motivo": null,"protocolo": "3550308000000000000000000000000000000000000000000001","data": "2026-09-21T14:00:00-03:00","linkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9102?token=..."}}
status* | string | Estado de la manifestación |
codigoEvento | string | Código oficial del evento |
codigoMotivo | string | Código del motivo del rechazo |
motivo | string | Descripción del motivo |
protocolo | string | Protocolo de la autoridad |
data | string | Momento del registro |
linkXml | string | Enlace del mensaje del evento |
* Campo obligatorio
El status de la nota recibida sigue siendo Autorizada / Cancelada / Substituida; la manifestación de esta empresa se guarda aparte en el bloque manifestacao, y cada parte manifiesta una sola vez por nota. La confirmación tácita 205204 y la anulación de rechazo 205208 del municipio llegan por la distribución nacional y actualizan el bloque igual. Una empresa de São Paulo también puede manifestar sobre notas del estándar nacional: la manifestación pasa por el emisor nacional, con independencia del canal de emisión de la propia empresa.
Pendente ──┬──► Confirmada│├──► Rejeitada ──► RejeicaoAnulada│└──► ConfirmacaoTacita
tipoTipo de la manifestación
| Valores | Significado |
|---|---|
| Confirmacao | Confirma la nota; evento 203202 (tomador) o 204203 (intermediario) |
| Rejeicao | Rechaza la nota con un código de motivo; evento 203206 (tomador) o 204207 (intermediario) |
codigoMotivoCódigo del motivo del rechazo
Obligatorio con tipo=Rejeicao; con tipo=Confirmacao no puede enviarse.
| Valores | Significado |
|---|---|
| 1 | Nota duplicada |
| 2 | El tomador ya emitió la nota por su cuenta |
| 3 | El hecho imponible no ocurrió, el servicio no fue prestado |
| 4 | Parte responsable equivocada |
| 5 | Importe o datos incorrectos |
| 9 | Otros; explique en motivo |
statusEstado de la tarea
| Valores | Significado |
|---|---|
| 0 | Pendiente, a la espera de procesamiento |
| 1 | En procesamiento |
| 2 | Éxito |
| 3 | Fallo |
manifestacao.statusEstado de la manifestación
null en el campo significa sin manifestación; en el filtro de la lista ese caso es Pendente.
| Valores | Significado |
|---|---|
| Confirmada | Confirmada por esta empresa (203202 / 204203); terminal |
| Rejeitada | Rechazada por esta empresa (203206 / 204207); el municipio todavía puede anularla |
| ConfirmacaoTacita | Confirmación tácita del municipio por falta de manifestación en el plazo (205204); terminal |
| RejeicaoAnulada | El municipio anuló el rechazo de esta empresa (205208); terminal |
manifestacao.codigoEventoCódigo del evento de manifestación
| Valores | Significado |
|---|---|
| 203202 | Confirmación por el tomador |
| 204203 | Confirmación por el intermediario |
| 203206 | Rechazo por el tomador |
| 204207 | Rechazo por el intermediario |
| 205204 | Confirmación tácita por el municipio |
| 205208 | Rechazo anulado por el municipio |
| Código | HTTP | |
|---|---|---|
| 10018001 | 400 | Parámetros rechazados en la aceptación: tipo fuera de Confirmacao / Rejeicao, codigoMotivo ausente o fuera de la enumeración en un rechazo, codigoMotivo / motivo enviados con una confirmación, o motivo fuera de 15 a 255 caracteres. El mensaje indica el motivo exacto. |
| 10018003 | 404 | Documento no encontrado: la clave de acceso no está entre las NFS-e recibidas de esta empresa. Verifique chaveAcesso y empresaId. |
| 10018042 | 400 | La manifestación no se permite en el estado actual: la nota está cancelada o sustituida, esta empresa ya manifestó (confirmada, rechazada o confirmación tácita), o esta empresa no es el tomador ni el intermediario de la nota. |