Recibo HTML o “Error interno” en vez de JSON

Síntoma: HTTP 500 con una página HTML

La respuesta llega con content-type: text/html y una página titulada “Error interno”, en lugar de un JSON. Las causas, en orden de frecuencia:

1. La estructura del request no es la que espera el recurso. Es la causa más común. Si el JSON pasa las validaciones básicas pero un campo va en el nivel equivocado o con un valor inválido, la operación puede fallar de forma no controlada. Revisa Errores 400: estructura del request.

2. El proxy no está bien configurado. Revisa Errores de proxy.

3. Estás usando un recurso para algo que no hace. Por ejemplo, los recursos del Portal MiPYME solo generan borradores: intentar emitir un documento real por esa vía no va a funcionar, y las lecturas del mismo producto seguirán respondiendo 200. Ese contraste —todas las lecturas bien, la escritura con 500— es la firma de este caso.

4. Una intermitencia puntual del recurso. Ocurre y la corregimos. Un caso real: el recurso de PDF de BHE recibidas devolvía 500 con la consulta correctamente formada, y se corrigió del lado de la plataforma.

Síntoma: HTTP 404 con una página HTML

La ruta no existe. Revisa:

• La URL base: https://app.apigateway.cl/api/v2/, no apigateway.cl ni www.apigateway.cl.
• Una barra final de más: un / sobrante antes de los parámetros de query, como .../225415/?fecha_emision=..., hace que la ruta no calce.
• El formato del período: 202605, no 2026-05.
• Que el recurso exista en la versión que usas: los paths de /api/v1 no existen en /api/v2 y viceversa.

Síntoma: la respuesta llega vacía aunque el Content-Length indique contenido

Se ha reportado en recursos de Legacy consultados de forma incorrecta. En los casos revisados, la causa fue la forma de consumir el recurso: método de autenticación equivocado o estructura del body que el recurso no espera. Contrasta tu request con el ejemplo de la documentación de la API V1.

Antes de reportarlo

Si tras revisar la documentación el error persiste, genera un ticket con el cURL real que estás enviando, la respuesta exacta y la fecha y hora de los intentos. Revisa qué datos enviar.