📘 Documentación de Integración & Cabeceras HTTP

Cualquier aplicación cliente (Web, Flutter, Java, PHP, Node.js) puede consumir este servicio directamente sin restricciones de CORS.

1. Cabeceras HTTP Emitidas por el Servidor

Cabecera HTTP	Valor / Formato	Propósito para los Sistemas
Content-Type	application/json; charset=utf-8	Garantiza la entrega de datos en JSON con codificación UTF-8 para tildes y caracteres latinos.
Access-Control-Allow-Origin	*	Permite llamadas AJAX/fetch desde cualquier origen web o cliente frontend del ecosistema (CORS total).
Access-Control-Allow-Methods	GET, POST, OPTIONS	Métodos HTTP soportados por la API.
Access-Control-Allow-Headers	Content-Type, Authorization, x-api-key	Permite enviar autenticación Bearer, Basic o llaves API personalizadas en llamadas preflight CORS.
Content-Length	<número de bytes exacto>	Indica el tamaño exacto del cuerpo para que el navegador/cliente finalice la descarga al instante sin demoras.
Connection	close	Cierra el socket limpio al terminar cada petición para optimizar recursos concurrentes.

2. Respuestas y Códigos de Estado (HTTP Status)

Código HTTP	Significado	Estructura JSON de Retorno
200 OK	Datos encontrados con éxito	{ "exito": true, "identificacion": "...", "fuente": "SRI.php", "datos": { ... } }
400 Bad Request	Falta el parámetro obligatorio 'ruc'	{ "exito": false, "error": "Falta el parámetro obligatorio 'ruc'" }
404 Not Found	RUC / Cédula no registrado	{ "exito": false, "mensaje": "No se encontraron datos registrados..." }
503 Service Unavail.	Fallo temporal o timeout upstream	{ "exito": false, "mensaje": "Servicio externo del SRI temporalmente inalcanzable..." }

3. Ejemplos de Consumo desde Código