Crear una nueva certificación.
Crear una nueva certificación.
basicAuthorizationBasic <token>rut*stringRUT de la empresa
Datos iniciales de la certificación. Datos del certificado digital (opcional) y de los SETs a certificar.
application/json- body
Datos para crear una certificación: el certificado digital (PFX en base64 y su contraseña) y los sets a certificar.
CertData*stringPFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.
byteContrasenna*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.
Sets?array<>|Listado de sets a certificar.
TodosSets?booleanCertificar todos los sets posibles según el SII. Si es true, Sets se ignora.
Respuesta exitosa.
application/json- response
Datos de la certificación.
Actecos?array<>|Activiades economicas.
ClasificacionError?ClasificacionErrorClasificación del error, cuando la certificación está en estado de error.
int320123CodigoError?|Codigo de error.
Comentario?|Comentario del estado. Util cuando se encuentra en error.
Direccion?|Direccion (Leida desde el SII)
DireccionModificada?|Direccion modificada
DireccionRegional?|Direccion regional (Leida desde el SII)
DireccionRegionalModificada?|Direccion regional modificada
Estado?EstadoCertificacionEstado actual de la certificación.
int320123Etapa?EtapaCertificacionEtapa en que se encuentra la certificación.
int3201234Fecha?stringFecha de creacion.
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,7})?$FechaEstado?stringFecha del estado.
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,7})?$Giro?|Giro comercial (Leida desde el SII)
GiroModificado?|Giro comercial modificada
HorasEnEstado?|Horas completas (unidad: horas; se trunca hacia abajo: 3 h 59 min son 3) que la certificación lleva sin que cambie nada de lo que se ve en esta respuesta. Se mide desde la más reciente entre FechaEstado y la fecha del último CodigoError, en hora de Chile. Un desfase de reloj devuelve 0; null significa que la certificación no tiene ninguna fecha de referencia. Un cambio de PasoEnSII que no mueva el estado interno de la certificación no lo reinicia.
int32PasoEnSII?PasoCertificacionPaso en que se encuentra la certificación cuando su Etapa es ConfiguracionSII (2).
int32012345Productos?array<>|Listado de productos.
RUT?|RUT de la empresa que se certifica.
RazonSocial?|Razon social (Leida desde el SII)
RazonSocialModificada?|Razon social modificada
Reinicios?integerCuántas veces se reinició esta certificación a pedido de alguien (unidad: veces; entero mayor o igual a 0, nunca null). Cuenta los reinicios por la API y los del portal de administración; no cuenta los reintentos automáticos del proceso. El contador es por certificación y arranca en 0.
int32Servicios?array<>|Listado de servicios.
Sets?array<>|SETs para certificar.
curl --request POST \ --url https://api.enrolamiento.cl/v2/certificaciones/1-9/crear \ --header 'Accept: application/json' \ --header 'Authorization: Basic <base64 de usuario:apikey>' \ --header 'Content-Type: application/json' \ --data '{ "CertData": "MIIC", "Contrasenna": "********", "Sets": [ 33, 34 ], "TodosSets": false}'{ "Actecos": [ { "AffectoIva": "SI", "Codigo": "620200", "Nombre": "Actividades de consultoría informática" } ], "ClasificacionError": 0, "CodigoError": null, "Comentario": "API", "Direccion": "Calle Ejemplo 123, Santiago", "DireccionModificada": null, "DireccionRegional": "Santiago Centro", "DireccionRegionalModificada": null, "Estado": 1, "Etapa": 1, "Fecha": "2026-10-07T10:15:00", "FechaEstado": "2026-10-07T10:15:00", "Giro": "Desarrollo de software", "GiroModificado": null, "HorasEnEstado": 0, "PasoEnSII": 0, "Productos": [], "RUT": "11111111-1", "RazonSocial": "Comercial Ejemplo SpA", "RazonSocialModificada": null, "Reinicios": 0, "Servicios": [], "Sets": [ 33, 34 ]}Reintentos e idempotencia
Idempotente: no. Cada llamada tiene efecto propio.
| Qué hacer | Códigos y status |
|---|---|
Reintentar solo, con espera (automatico) | 409 |
Consultar el estado antes de repetir (manual) | CERT_ERROR, ERROR_GENERAL, SII_ERROR_CXN |
No repetir: corregir la causa (nunca) | CERTIFICACION_EXISTE_EN_OTRO_CLIENTE, CERT_REQUERIDO, DATOS_REQUERIDOS, INSUFICIENTE_SALDO, NO_CERTIFICATE, SET_AMBAS_BOLETAS_JUNTAS, SET_DTE_BOLETA_JUNTOS, SET_REQUERIDO |
Un código que no figura en esta tabla se resuelve con la regla de respaldo.