Toda respuesta fallida de la API de folios trae dos campos: error, legible, con lo que dijo el SII; y error_code, un vocabulario cerrado.
Programa contra el código, no contra el texto. El texto viene del portal del SII, cambia sin aviso y a veces dice lo contrario de lo que pasa: su página de rechazo dice “inténtelo más tarde” incluso cuando la causa es permanente.
La tabla
Cuándo reintentar, en concreto
Los códigos marcados No son terminales: la misma llamada va a fallar igual las veces que la hagas, y cada intento gasta requests contra tu RUT ante el SII, que penaliza por contribuyente. Cuando eso pasa deja de responderte todo lo de esa empresa, no solo el timbraje.
sii_unavailable sí se reintenta, pero con espera creciente y siempre con la misma Idempotency-Key si estabas timbrando: así te devolvemos el pedido original en vez de pedir un rango nuevo.
Nunca reintentes un timbraje con una clave nueva “por si acaso”. Un folio timbrado no se devuelve: si el primero sí llegó al SII, el segundo te quema otro rango.
El estado authorized_without_caf
No es un error, y por eso no tiene error_code. Significa que el SII autorizó tu rango y falló al entregar el archivo: esos folios ya salieron de tu stock. Nosotros recuperamos el CAF; tú no vuelvas a pedir ese mismo rango. 