No se pudo completar la nominación
Error evento-nominacion-error (HTTP 400 / 409 / 503): la nominación del receptor de una factura no se pudo completar. Causas y cómo resolverlo.
Actualizado el
HTTP: 400 / 409 / 503. La operación POST /api/v1/documento-electronico/{cdc}/nominar no pudo completar la identificación del receptor. 400 indica datos o condiciones inválidos; 409, un conflicto con otra nominación; 503, que SIFEN no confirmó el resultado.
Efecto de la solicitud
Puede existir un evento creado o enviado. La nominación no crea otro documento ni reemplaza su CDC, XML o KuDE; no consume numeración ni cupo de emisión.
Qué hacer y cuándo reintentar
Ante 400, revisá el detail y el evento antes de corregir datos. Ante 409, consultá la nominación existente. Ante 503, esperá Retry-After: 2 y repetí la misma solicitud conservando la clave original, si la enviaste. No supongas que el envío falló sin efectos.
Campos adicionales
Puede incluir traceId. El 503 incluye Retry-After: 2.
Respuesta de ejemplo
Retry-After: 2{
"type": "https://sifende.com.py/docs/solucion-problemas/evento-nominacion-error",
"title": "Service Unavailable",
"status": 503,
"detail": "No se pudo confirmar el resultado de la nominación en SIFEN; reintentá después del intervalo indicado",
"traceId": "8f1c2b3a4d5e6f70"
}Consultá la referencia de errores y las reglas de idempotencia para manejar la respuesta en tu integración.
Consultá el contrato de nominación y la guía paso a paso.
No se pudo inutilizar el rango
Error evento-inutilizacion-error (HTTP 400 / 409): el rango, el tipo de documento o el timbrado no son válidos, o ya hay otra inutilización activa.
Valor de enumeración inválido
Error invalid-enum-value (HTTP 400): Un campo recibió un valor que no pertenece a su enumeración. Qué efecto tiene en tu solicitud y cómo resolverlo.