Skip to content
Emitia

Error: not_found

Qué significa

Section titled “Qué significa”

El recurso solicitado (factura, cliente, certificado, etc.) no existe en el sistema, o existe pero pertenece a otro tenant y no tienes acceso.

Por diseño, Emitia devuelve not_found en ambos casos para no confirmar la existencia de recursos de otros tenants (seguridad multi-tenant).

Envelope de ejemplo

Section titled “Envelope de ejemplo”
{
  "error": {
    "type": "not_found",
    "code": "not_found",
    "message": "El recurso solicitado no fue encontrado.",
    "doc_url": "https://docs.emitia.co/errors/not_found",
    "request_id": "req_01HX…"
  }
}

HTTP status: 404 Not Found

Causas frecuentes

Section titled “Causas frecuentes”
CausaDescripción
ID incorrectoEl id fue copiado con un carácter extra o faltante
ID de otro tenantEl recurso existe pero no es tuyo
Recurso aún no creadoEl proceso es asincrónico; el recurso se crea en segundo plano
Recurso eliminado (soft delete)El recurso fue dado de baja

Cómo resolverlo

Section titled “Cómo resolverlo”
  1. Verifica que el ID tiene el prefijo correcto (inv_, cust_, cert_, etc.).
  2. Verifica que estás usando la clave API del tenant que creó el recurso.
  3. Si el recurso debería existir, espera unos segundos (el procesamiento es async) y reintenta.

Recursos con códigos específicos

Section titled “Recursos con códigos específicos”

Para recursos específicos (como invoice_not_found, customer_not_found), la API puede devolver un code más específico. Consulta la documentación de cada endpoint en la Referencia API.

Ver también

Section titled “Ver también”