Skip to content
Emitia

Error: internal_server_error

Qué significa

Section titled “Qué significa”

Ocurrió un error en el lado de Emitia que no es causado por tu request. No es un error de validación ni un rechazo DIAN — es un fallo interno.

Envelope de ejemplo

Section titled “Envelope de ejemplo”
{
  "error": {
    "type": "api_error",
    "code": "internal_server_error",
    "message": "Ocurrió un error interno. El equipo fue notificado. Incluye el request_id al reportar.",
    "doc_url": "https://docs.emitia.co/errors/internal_server_error",
    "request_id": "req_01HX…"
  }
}

HTTP status: 500 Internal Server Error

Qué hacer

Section titled “Qué hacer”

  1. Guarda el request_id — es el identificador único de tu request en los sistemas de Emitia. Sin él, el soporte no puede investigar.

  2. Reintenta con la misma Idempotency-Key — si tienes la clave de idempotencia (la generaste antes de la llamada), el reintento es seguro. Emitia procesará la operación una sola vez.

  3. Espera y reintenta con backoff — algunos 500 son transitorios (deploy en curso, spike de carga). Espera 5-10 segundos antes del primer reintento.

  4. Si persiste, contacta soporte en soporte@emitia.co con el request_id y la descripción del request.

Errores 500 son raros

Section titled “Errores 500 son raros”

Emitia monitorea los 500 activamente. Si experimentas una tasa elevada de 500, revisa la página de estado — puede haber un incidente en curso.

Ver también

Section titled “Ver también”