En esta página
Estado del servicio GET
Consulta sin API Key si la API está operativa, su disponibilidad de los últimos 90 días y los incidentes publicados, en JSON o en la página de estado.
Cuando tu integración empieza a recibir errores 5xx o tiempos de espera, lo primero que conviene saber es si el problema está en tu sistema o en el servicio. Para eso publicamos el estado de la API de forma abierta: no necesitas una API Key y puedes leerlo en la página de estado o con una petición GET /estado desde tus propias alertas.
Esta guía explica qué devuelve la consulta, cómo interpretar cada estado, con qué frecuencia puedes consultarla y qué hacer en tu integración cuando el servicio está degradado o caído.
Endpoint#
GET https://api.mynexusapi.com/estado
La ruta no lleva el prefijo /v1, no requiere la cabecera X-Api-Key y no recibe parámetros.
Cuándo usarlo#
- Para mostrar el estado de la facturación en el panel de soporte de tu sistema.
- Para decidir si pausas un proceso masivo cuando la API no está operativa y reanudarlo cuando vuelva a estarlo.
- Para alimentar tus propias alertas sin gastar el límite de solicitudes de tu integración, porque esta consulta no usa tu API Key.
Si quieres comprobar solamente que el servicio responde, GET /salud responde 200 con el estado activo. Para conocer el detalle de la disponibilidad y los incidentes, usa GET /estado.
Ejemplo#
curl -s "https://api.mynexusapi.com/estado"
using System.Net.Http;
using var http = new HttpClient { BaseAddress = new Uri("https://api.mynexusapi.com") };
using HttpResponseMessage respuesta = await http.GetAsync("/estado");
Console.WriteLine($"{(int)respuesta.StatusCode} {await respuesta.Content.ReadAsStringAsync()}");
// Node.js 18 o superior. Guarda como estado.mjs y ejecuta: node estado.mjs
const res = await fetch('https://api.mynexusapi.com/estado');
console.log(res.status, await res.text());
<?php
$ch = curl_init('https://api.mynexusapi.com/estado');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$cuerpo = curl_exec($ch);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $estado . ' ' . $cuerpo . PHP_EOL;
# Resultado esperado: el estado del servicio y su disponibilidad de los últimos 90 días.
ecuafact estado-servicio
Respuesta#
La respuesta es 200 OK aunque el servicio esté degradado o caído: el estado va en el cuerpo.
{
"estado": "operativo",
"medidoEn": "2026-11-16T14:32:10Z",
"componentes": [
{
"nombre": "Ecuafact API",
"estado": "operativo"
}
],
"disponibilidad90Dias": 99.97,
"incidentes": [
{
"inicio": "2026-11-02T09:10:00Z",
"fin": "2026-11-02T09:42:00Z",
"impacto": "degradado",
"titulo": "Respuestas lentas en la emisión",
"detalle": "La emisión tardó más de lo habitual. No se perdió ningún comprobante."
}
]
}
| Campo | Tipo | Descripción |
|---|---|---|
estado |
string | Estado general del servicio. Puede ser operativo, degradado, caido o sin_datos. |
medidoEn |
string o null |
Momento de la última medición, en formato ISO 8601 (UTC). Es null si todavía no hay mediciones. |
componentes |
array | Componentes monitoreados, cada uno con nombre y estado. El servicio publica un único componente, Ecuafact API. |
disponibilidad90Dias |
number o null |
Porcentaje de minutos sin caída en los últimos 90 días. Es null si todavía no hay muestras. |
incidentes |
array | Incidentes de los últimos 90 días y los que siguen abiertos, del más reciente al más antiguo. Es una lista vacía si no hubo ninguno. |
incidentes[].inicio |
string | Inicio del incidente, en formato ISO 8601 (UTC). |
incidentes[].fin |
string | Fin del incidente. Se omite mientras el incidente sigue abierto. |
incidentes[].impacto |
string | degradado o caido. |
incidentes[].titulo |
string | Título breve del incidente. |
incidentes[].detalle |
string | Qué significó el incidente para tus integraciones. Se omite si no hay detalle. |
Valores de estado#
| Valor | Significado | Qué hacer |
|---|---|---|
operativo |
El servicio responde con normalidad. | No hagas nada. |
degradado |
El servicio responde, pero con lentitud o con errores en algunas peticiones. | Reintenta con espera, como se explica en Buenas prácticas, y vigila el incidente publicado. |
caido |
El servicio no está disponible. | Pausa los envíos masivos y reintenta más tarde. |
sin_datos |
No hay una medición reciente. No significa que el servicio esté caído. | Consulta de nuevo en un minuto. Si persiste, revisa la página de estado o escribe a soporte con el X-Correlation-Id de tu petición. |
La disponibilidad se mide sobre la aceptación de los comprobantes. La autorización del SRI es una dependencia externa que puede tardar o fallar sin que la API esté caída; en ese caso el comprobante queda recibido y sigue su curso, como se explica en Ciclo de vida del comprobante.
Límites de la consulta#
- Cada IP puede consultar
GET /estadohasta 60 veces por minuto. Para alertas propias basta con una consulta por minuto. - La respuesta se puede guardar hasta 30 segundos: llega con
Cache-Control: public, max-age=30.
Si superas el límite, la API responde 429 con el codEstado 5005 (limite_solicitudes) y la cabecera Retry-After con los segundos de espera.
{
"estado": "rechazado",
"codEstado": 5005,
"msgError": "Demasiadas solicitudes. Reintenta en un minuto.",
"errores": []
}
Estados de este endpoint#
| Código | HTTP | Cuándo ocurre | Qué hacer |
|---|---|---|---|
5005 (limite_solicitudes) |
429 | Tu IP superó las consultas por minuto permitidas. | Espera los segundos que indica Retry-After y consulta de nuevo. |
Siguientes pasos#
- Continuidad y salida: qué pasa con tus comprobantes y tu cupo cuando el servicio tiene un incidente.
- Buenas prácticas: cómo reintentar sin duplicar comprobantes.
- Errores: qué significan los errores 5xx y cuáles se reintentan.