Manejo de Errores

Todas las respuestas de la API son JSON. Esta página describe la estructura común de esas respuestas y cómo distinguir un error, ya que la mayoría de los errores de negocio no se devuelven como error HTTP, sino como un status: false dentro de una respuesta 200.

Estructura común de respuesta

Campo	Tipo	Presente en	Descripción
status	boolean	Todas	En emisión y eventos: si la operación fue exitosa. En consultas: si la consulta se ejecutó correctamente (no indica si el dato existe - para eso ver found)
requestId	string (uuid)	Todas	Identificador único de la operación. Incluilo siempre que pidas soporte sobre un caso puntual
message	string	Todas	Descripción legible del resultado o del error
details	array	Emisión (cuando aplica)	Detalle de errores de validación campo por campo
found	boolean	Consultas de existencia (RUC, CDC, URL, estado)	Si el dato buscado existe. Podés tener status: true y found: false a la vez - la consulta funcionó, simplemente no hay nada que devolver
data	object / string	Consultas que devuelven contenido	Presente únicamente cuando found: true

Códigos HTTP

Código	Cuándo aparece
200	La operación fue procesada. Incluye tanto éxitos como fallos de negocio (anulación rechazada, documento no encontrado, certificado expirado, etc.) - siempre revisá status/found en el body, un 200 no garantiza éxito
400	Error de validación en los datos enviados al emitir un documento (crear/factura, crear/autofactura, crear/notacredito, crear/notadebito, crear/notaremision, crear/recibo). Es el único caso donde un fallo de negocio se refleja como error HTTP real
401	Token ausente o inválido. Aplica a todos los endpoints por igual

Los eventos síncronos (anulación, inutilización, eliminación, nominación) no usan 400 - cualquier rechazo se informa siempre con 200 y status: false.

Catálogo de mensajes conocidos

Validación de emisión (400)

• Valor de la Fecha '...' en data.fecha no válido. Formato: yyyy-MM-ddTHH:mm:ss
• Para más detalle de qué campo falló, revisá el array details de la respuesta (cuando la validación lo completa).

Certificado

• No se puede emitir el documento porque el certificado para la firma ha expirado - ver Certificados para el proceso de renovación.

Consultas - RUC / CDC (status: true, found: false)

• [0500] RUC no existe
• [0500] Documento No Existe en SIFEN o ha sido Rechazado

Recibo de dinero (digital)

• El número de recibo 001-001-0001234 no se encuentra registrado
• El número de recibo 001-001-0001234 ya fue anulado con anterioridad

Estado de un documento

El catálogo completo de estados (A, I, C, R, P, X) está documentado en Consultas → Consultar estado de documento.

Sobre los códigos [NNNN]: son códigos de rechazo definidos por la propia SIFEN, no por ReKU - se repiten tal cual la SIFEN los devuelve. No existe un catálogo público unificado de estos códigos en esta documentación; si necesitás interpretar uno en particular, contactá a soporte indicando el requestId.