# Nominar una factura innominada (/docs/guias/nominar-factura)



La nominación identifica al cliente de una FE que originalmente se emitió como innominada. Es un evento sobre la factura existente, agregado a SIFEN por la Nota Técnica 14 del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica): conserva el CDC, XML firmado y KuDE originales.

## 1. Verificá la factura [#1-verificá-la-factura]

Usá una API key del mismo contribuyente y ambiente de emisión. La nominación está disponible en DEV y PROD; SANDBOX responde `422`.

[Consultá el estado](/docs/guias/consultar-estado) y continuá sólo si la FE está `APROBADO` o `APROBADO_OBSERVACION`. El receptor original debe ser no contribuyente, `INNOMINADO`, con número `"0"`. Una factura ya identificada no es elegible.

## 2. Prepará el receptor y guardá la intención [#2-prepará-el-receptor-y-guardá-la-intención]

Guardá el CDC, cuerpo de la solicitud y una `Idempotency-Key` antes de enviar. Reutilizá estos datos si perdés la respuesta.

Para identificar a un consumidor con cédula, guardá este contenido en `nominacion.json`, reemplazando los datos por los del cliente:

```json
{
  "motivo": "Identificación del cliente a su solicitud",
  "receptor": {
    "naturaleza": "NO_CONTRIBUYENTE",
    "tipoOperacion": "B2C",
    "pais": "PRY",
    "tipoDocumento": "CEDULA_PARAGUAYA",
    "numeroDocumento": "1234567",
    "nombreRazonSocial": "Juan Pérez"
  }
}
```

Para B2B, usá `naturaleza: "CONTRIBUYENTE"`, `tipoOperacion: "B2B"`, `pais: "PRY"`, `tipoContribuyente`, `ruc` y `digitoVerificador`; omití `tipoDocumento` y `numeroDocumento`. También se admite B2F, con domicilio extranjero. La [referencia de nominación](/docs/referencia/documentos-electronicos/nominar#receptor-de-la-nominación) detalla todos los campos y reglas; el objeto de receptor de emisión no sirve sin adaptar sus nombres.

## 3. Enviá la nominación [#3-enviá-la-nominación]

Definí `SIFENDE_API_KEY`, `CDC` e `IDEMPOTENCY_KEY` con la clave de acceso, el CDC de la factura y la clave de intención que guardaste:

```bash
curl --include -X POST \
  "https://api.sifende.com.py/api/v1/documento-electronico/$CDC/nominar" \
  --header "Authorization: Bearer $SIFENDE_API_KEY" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header 'Content-Type: application/json' \
  --data-binary @nominacion.json
```

## 4. Interpretá el resultado [#4-interpretá-el-resultado]

| Respuesta                        | Acción                                                                                                               |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `200`, `estadoEvento: APROBADO`  | Guardá el evento y protocolo. La nominación quedó confirmada                                                         |
| `200`, `estadoEvento: RECHAZADO` | Revisá `codigoRespuesta` y `mensajeRespuesta`; el HTTP por sí solo no confirma la nominación                         |
| `503 evento-nominacion-error`    | Esperá `Retry-After: 2` y repetí exactamente la misma solicitud y clave                                              |
| `400`                            | Corregí los campos o condiciones que indique el error; verificá si ya existe un evento antes de crear otra intención |
| `409 evento-nominacion-error`    | Revisá la nominación existente en el panel; no intentes sustituir una aprobada con otra solicitud                    |

Un resultado incierto conserva el evento `ENVIADO` y requiere un reintento: no hay recuperación en segundo plano. El reintento consulta la confirmación antes de reenviar. Si enviaste una clave, los demás errores y plazos de replay siguen las [reglas de idempotencia](/docs/guias/idempotencia).

La nominación no consume numeración ni cupo de emisión. Sólo el evento aprobado aporta el receptor efectivo al preparar NCE/NDE desde el panel; el KuDE original conserva sus datos.

## Referencias [#referencias]

* [Endpoint y contrato completo](/docs/referencia/documentos-electronicos/nominar)
* [Errores de nominación](/docs/solucion-problemas/evento-nominacion-error)
