Errores
SSRF_BLOCKED (400)
La URL del webhook no es HTTPS o apunta a una dirección privada o interna.
HTTP 400 Bad Request
El webhook_url del body de POST /v1/invoices (o de POST /v1/sandbox/invoices) cae en uno
de estos casos, y la factura no se emite:
- No es HTTPS.
- Apunta a una IP privada o reservada (por ejemplo
10.x.x.x,192.168.x.xo127.0.0.1, y sus equivalentes IPv6). - Usa un nombre de host local o interno, como
localhost. - Su dominio resuelve a una IP privada o reservada.
También responde así al guardar en el dashboard el webhook de la cuenta o de un proyecto con una dirección privada o interna.
Ejemplo
{
"type": "https://docs.dtevia.com.gt/errors/ssrf-blocked",
"title": "SSRF_BLOCKED",
"status": 400,
"detail": "La URL del webhook apunta a una dirección IP privada o reservada"
}Cómo resolverlo
- Usá una URL HTTPS pública, cuyo dominio resuelva a una IP pública.
- Para probar en local, exponé tu endpoint con un túnel HTTPS (ngrok, Cloudflare Tunnel) en vez
de
localhosto una IP de tu red.
Otro puerto o credenciales en la URL
Una URL en otro puerto que el 443, o con usuario y contraseña, responde
VALIDATION_ERROR (422), no este error.
Ver Webhooks.