API de Enrolamiento
CAF

Consultar el último folio emitido para el tipo de documento.

POST
/v1/caf/{rut}/consulta/{tipoDocumento}

Consultar el último folio emitido para el tipo de documento.

Autorización

basic
headerAuthorizationBasic <token>

Parámetros de ruta

rut*string

RUT de la empresa.

tipoDocumento*integer

Tipo del documento DTE.

Formatoint32

Parámetros de query

ambiente?integer

Ambiente 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 no da error y corre en homologación.

Formatoint32
Por defecto1
Valor en01

Cuerpo del request

Datos del certificado.

application/json
  1. body

Datos del certificado digital.

Contrasenna*string

Contraseñ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*string

PFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.

Formatobyte

Cuerpo de la respuesta

Respuesta exitosa.

application/json
  1. response

Resultado de la consulta de uso folios.

UltimoAnulado?|

Ultimo folio anulado. (Puede ser nulo si ocurre algun error)

Formatoint64
UltimoAnuladoEstado?|

Posibles estados: OK; CODE_ERROR_ENTERPRISE_IS_MYPYME (la empresa usa el sistema de facturación del SII y no es posible ver los folios anulados); CODE_ERROR_CERTIFICATE_PERM (el titular del certificado no tiene permisos para ver los documentos emitidos); ERROR (error no controlado).

UltimoEnviado?|

Ultimo folio enviado. (Puede ser nulo si ocurre algun error)

Formatoint64
UltimoEnviadoEstado?|

Posibles estados: OK; NO_FOLIO_IN_6_MONTHS (no se encontraron documentos en los últimos 6 meses); CODE_ERROR_CERTIFICATE_PERM (el titular del certificado no tiene permisos para ver los documentos emitidos); ERROR (error no controlado).

curl --request POST \  --url 'https://api.enrolamiento.cl/v1/caf/1-9/consulta/1?ambiente=0' \  --header 'Accept: application/json' \  --header 'Authorization: Basic <base64 de usuario:apikey>' \  --header 'Content-Type: application/json' \  --data '{  "Contrasenna": "********",  "Data": "MIIC"}'
{  "UltimoAnulado": 1200,  "UltimoAnuladoEstado": "OK",  "UltimoEnviado": 1500,  "UltimoEnviadoEstado": "OK"}

Reintentos e idempotencia

Idempotente: sí. Repetirla con los mismos datos no duplica nada.

Qué hacerCódigos y status
Reintentar solo, con espera (automatico)409, 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.