Reobtener el último CAF desde el SII para el ambiente indicado.
Reobtener el último CAF desde el SII para el ambiente indicado. El certificado se valida siempre contra el SII de producción, aunque el CAF se pida con ambiente=0: un certificado habilitado solo en el ambiente de certificación del SII queda rechazado, y el error habla del certificado y no del ambiente.
basicAuthorizationBasic <token>rut*stringRUT de la empresa.
tipoDocumento*integerTipo del documento DTE.
int32ambiente?integerAmbiente del SII: 0 = Homologación (certificación), 1 = Producción. Si se omite, opera en producción: páselo siempre explícito. Un valor que no se reconoce no da error: la operación corre en producción. Un número distinto de 0 y 1 tampoco da error y también corre en producción.
int32101descargarCafAntiguos?booleanSi se desea descargar CAF con más de 3 meses de antigüedad. Por omisión solo se devuelven CAF recientes.
falseDatos del certificado.
application/json- body
Datos del certificado digital.
Contrasenna*stringContraseña del PFX, en claro o cifrada con la clave de cifrado del perfil del cliente. Dato sensible: no se registra en logs del integrador.
Data*stringPFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.
byteLos bytes del CAF reobtenido. Si ya hay una solicitud de folios en curso para este RUT y tipo de documento, responde 429 (CAF_REQUEST_IN_PROGRESS) con el header Retry-After: reintentar pasados esos segundos.
response?stringapplication/jsonbytecurl --request POST \ --url 'https://api.enrolamiento.cl/v1/caf/1-9/reobtener/1?ambiente=0' \ --header 'Accept: application/json' \ --header 'Authorization: Basic <base64 de usuario:apikey>' \ --header 'Content-Type: application/json' \ --data '{ "Contrasenna": "********", "Data": "MIIC"}'"RWplbXBsbzogbm8gZXMgdW4gQ0FGIHJlYWwu"Reintentos e idempotencia
Idempotente: sí. Repetirla con los mismos datos no duplica nada.
| Qué hacer | Códigos y status |
|---|---|
Reintentar solo, con espera (automatico) | 409, 429, SII_ERROR_CXN |
Consultar el estado antes de repetir (manual) | CERT_ERROR, ERROR_GENERAL |
No repetir: corregir la causa (nunca) | CERT_REQUERIDO |
Un código que no figura en esta tabla se resuelve con la regla de respaldo.