Previred
Planillas de cotizaciones pagadas, el desglose por trabajador, la deuda previsional y el archivo para el F30-1, sincronizados a la caché de Emisso. Con el comprobante en PDF.
Con la clave de Previred, previred sincroniza hacia el plano persistido de Emisso las cotizaciones previsionales de una empresa: las planillas que se pagaron, lo que cotizó cada trabajador, la deuda pendiente, el archivo con que se saca el Certificado F30-1, el certificado oficial de cada trabajador y el estado actual de sus nóminas. Las tools de consulta y de descarga las leen de esa caché sin esperar al portal. El conn_… de la conexión dice qué empresa lees y viaja en toda llamada (en REST, el header X-Connect-Connection).
Previred es el único sistema del catálogo que además guarda documentos: el comprobante en PDF de cada planilla, que es la prueba de pago que piden la Dirección del Trabajo, las mutuales y cualquier auditoría, y el archivo para el F30-1.
Qué necesitas para conectar
La guía Conectar Previred recorre el alta desde el panel, con una demo animada de la pantalla real.
En el enlace de conexión la persona entrega la Clave Previred, en tres campos:
| Campo | Qué es |
|---|---|
| RUT de acceso | El RUT de la persona que entra a previred.com. |
| Clave Previred | Su clave del portal. |
| RUT de la empresa | La empresa que esta conexión va a leer. |
El acceso solo lee, y desde el dashboard se revoca en el acto. La clave no pasa por tu código: la entrega quien la tiene, en un enlace que sirve una sola vez.
Antes de pedir la clave, revisa quién administra la empresa
En Previred una empresa está asignada a un RUT de usuario, y con mucha frecuencia es el del contador, no el del dueño. Si conectas con una clave que no la administra, la sincronización responde connection_credential_required explicando exactamente eso.
La salida correcta no es quitarle la empresa al contador. El portal ofrece hacerlo, pero pide acertar el monto del último pago y le avisa a él por correo. Lo que corresponde es pedirle que cree un usuario secundario para la integración. Está en el portal, en Remuneraciones, bajo «Usuarios». Así cada uno conserva su acceso.
Los alcances
| Alcance | Qué trae | Tool que lo lee |
|---|---|---|
planillas | Una planilla por institución previsional, con su folio, el monto pagado y el enlace al comprobante en PDF | previred.planillas.consultar |
cotizaciones | Lo que cotizó cada trabajador: renta imponible, monto y días trabajados | previred.cotizaciones.consultar |
deuda | Las dos mitades de «¿estoy al día?»: declaraciones sin pago (DNP) y nóminas cuyo plazo corre y aún no se pagan | previred.deuda.consultar |
f301 | El archivo de 106 campos con que la Dirección del Trabajo emite el Certificado F30-1 | previred.f301.consultar |
certificados | El certificado oficial de cotizaciones de cada trabajador, en PDF | previred.certificados.consultar |
empresas | Las empresas que esta credencial administra en Previred | previred.empresas.consultar |
nominas | Las nóminas actuales de la empresa: nombre, período, total, cuadratura y si requieren actualización o cálculo, están bloqueadas o se pueden seleccionar. Es una foto del momento, sin historia | previred.nominas.consultar |
Qué alcances quedan habilitados se decide por conexión, desde el dashboard.
Si Previred sólo entrega las nóminas por pagar, nominas queda partial, con motivo
nominas_por_pagar y completo: false. Emisso conserva las nóminas anteriores y vuelve a revisarlas
en la próxima sincronización. Ese resultado no confirma que no existan otras nóminas ni exige cambiar la clave.
Sincronizar
curl -X POST https://connect.emisso.ai/api/v1/tools/previred.conexion.sincronizar/execute \
-H "Authorization: Bearer connect_sk_..." \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"periodo":"2026-06","alcances":["planillas","cotizaciones","deuda","f301","certificados","empresas"]}}'Respuesta de encolado (200, metadatos recortados):
{
"data": {
"periodo": "2026-06",
"estado": "encolado",
"jobId": "sjb_9f2kc0q8w1m4x7t3p6b5d",
"yaEnCurso": false
},
"meta": {
"request_id": "req_...",
"tool_id": "previred.conexion.sincronizar",
"plane": "read"
}
}La llamada acepta el trabajo y responde antes del login. Sigue data.jobId con
GET /api/v1/syncs/{jobId} hasta que termine y revisa los alcances en data.outcomes:
succeeded puede incluir alcances parciales o fallidos. La guía de seguimiento
explica la espera, los errores y el caso yaEnCurso: true con jobId: null.
Para esta llamada, outcomes queda así (recortado):
"outcomes": [
{ "alcance": "planillas", "status": "ok", "recordsSynced": 4 },
{ "alcance": "cotizaciones", "status": "ok", "recordsSynced": 4 },
{ "alcance": "deuda", "status": "ok", "recordsSynced": 0, "detalle": "Previred no reporta deuda pendiente para esta empresa." },
{ "alcance": "f301", "status": "ok", "recordsSynced": 1 },
{ "alcance": "certificados", "status": "ok", "recordsSynced": 12 },
{ "alcance": "empresas", "status": "ok", "recordsSynced": 3 }
]Un login basta para todos los alcances.
Del 10 al 13 de cada mes, Previred está en su período de pago: Emisso no sincroniza de forma automática y solo acepta cargar el mes actual y los dos anteriores, que son los tres del alta. Los meses más antiguos se pueden cargar desde el 14, cuando todo vuelve a la normalidad. Si pides uno de esos meses en esos días, la API responde 400 validation_error con el mensaje «Del 10 al 13 de cada mes, Previred solo acepta el mes actual y los dos anteriores. Los meses más antiguos se pueden cargar desde el 14.»
Antes de depender de los datos
Un pago se abre en varias planillas
Pagar las cotizaciones de un mes genera una planilla por institución previsional: la AFP, la Isapre o Fonasa, el seguro de cesantía, la mutual, la caja de compensación. Cada una tiene su propio folio y su propio monto. Ver cuatro filas para un período con un solo trabajador es lo normal, no una duplicación.
El folio es un identificador de 16 dígitos que emite Previred, y es la identidad de la planilla en Emisso. Se guarda entero y opaco: no intentes descomponerlo, porque los folios reales no siguen un patrón parejo.
El período vacío casi nunca significa «no cotizó»
Las cotizaciones de un mes se declaran y pagan entre el día 10 y el 13 del mes siguiente, y la planilla aparece timbrada hasta 24 horas después del pago. Un período reciente sin planillas casi siempre significa «todavía no se paga», no «esta empresa no cotiza». Cuando el sync termina en cero, el campo detalle de su resultado lo dice con todas sus letras para que no se transmita como un hecho.
Entre el 10 y el 13 no sincronizamos solos
Esos cuatro días vencen las cotizaciones de todo el país y Previred concentra la carga de Chile entero. La sincronización programada se salta esa ventana a propósito. No se pierde nada: en esos días el período corriente todavía no tiene planillas pagadas, así que traería lo mismo que el día 9. Un sync manual del mes actual o de los dos anteriores sigue funcionando si lo necesitas; cargar meses más antiguos queda disponible desde el 14.
«¿Estoy al día?» son dos cosas distintas
El alcance deuda trae dos tipos de fila y conviene no confundirlos.
dnp es una declaración sin pago: la empresa declaró lo que debía y no lo pagó. Viene con su
institución y el total a pagar (montoTotal), sin desglose: Previred no separa lo nominal de los
reajustes, así que montoNominal y cargosLegales vienen en null. Ese total es el del momento de
la sincronización, porque Previred lo recalcula según el día en que se pague.
Cada DNP tiene además un plazo para pagarse por Previred, distinto por institución, y llega en
venceEl (AAAA-MM-DD). Pasado ese día la deuda sigue, pero se paga por otro canal: la cobranza de la
AFP, «Pago de Deudas y Regularizaciones» o, para el Seguro Social, su estudio jurídico. Las filas
por_pagar traen venceEl en null: su plazo es el día 13, para todas.
por_pagar es una nómina cuyo plazo todavía corre. Aparece apenas se genera la planilla y
desaparece cuando se paga. Ahí institucion dice "Todas" y solo llega montoTotal, porque el
portal muestra un total por nómina sin desglosarlo por institución. Si hay varias nóminas del mismo
período, montoTotal es la suma de todas ellas en una fila "Todas".
La consulta muestra la deuda vigente en la última sincronización completa. Una deuda que deja de
aparecer se retira de la consulta; si la sincronización falla, se conserva la última observación
completa, con su fecha observadoEn.
El plazo vence el día 13 del mes siguiente al de las remuneraciones, y no se corre por feriado.
Una fila por_pagar del período anterior después de esa fecha ya es una deuda, aunque Previred aún no
la haya movido a DNP.
El comprobante en PDF
Cada planilla trae su comprobante. planillas.consultar dice en comprobanteDisponible si el PDF ya está guardado, y comprobante.descargar lo entrega para el folio que le pidas como un enlace firmado de vida corta. Está pensado para seguirlo o descargarlo en el momento, no para guardarlo: caduca a los pocos minutos y no sirve como enlace compartible. El documento trae RUT, nombres y rentas de los trabajadores, y esa vida corta es deliberada.
Si comprobanteDisponible viene en false, el PDF todavía no se ha descargado; la planilla es válida igual y el siguiente sync lo reintenta.
El enlace dentro de la consulta se retira el 14 de octubre de 2026
Hasta esa fecha, planillas.consultar, f301.consultar y certificados.consultar siguen trayendo comprobanteUrl, archivoUrl y certificadoUrl. Desde ese día las consultas traen solo los datos y la disponibilidad, y el enlace se pide de a uno con comprobante.descargar, f301.descargar o certificado.descargar. Firmar el documento de cada fila en cada consulta era trabajo desperdiciado cuando lo que se buscaba eran los datos.
El desglose por trabajador sale del comprobante
Previred no publica en pantalla lo que cotizó cada persona: ese detalle vive dentro del PDF. Emisso lo extrae al sincronizar, así que cotizaciones.consultar responde igual de rápido que las demás consultas.
Dos consecuencias que conviene conocer. Los días trabajados solo llegan cuando la institución los informa. Lo hace el Seguro Social y no las demás, así que en el resto quedan en null, que es la verdad y no un hueco. Y el montoCotizacion de cada fila cuadra con el total que su planilla declara: si alguna vez no cuadrara, la sincronización falla en vez de guardar un número dudoso.
El archivo para el F30-1
El F30-1 es el Certificado de Cumplimiento de Obligaciones Laborales y Previsionales. Si tu empresa trabaja como contratista, tu mandante te lo va a pedir todos los meses antes de pagarte: la Ley 20.123 lo hace responsable solidario de tus cotizaciones, así que sin ese papel te retiene el pago.
La Dirección del Trabajo lo emite en línea a partir de un archivo que subes, y ese archivo lo genera Previred. El alcance f301 lo trae en cada sync; f301.consultar dice en archivoDisponible si está guardado, y f301.descargar lo entrega como enlace firmado de vida corta.
Emisso entrega el archivo con que se pide el certificado, no el certificado. Ese último paso es de la Dirección del Trabajo y sigue siendo tuyo.
Tres cosas que conviene saber. El archivo cubre una nómina, así que un período con dos nóminas trae dos archivos. Se identifica por el nombre que la nómina tiene en Previred, y si dos del mismo período se llaman igual la sincronización falla y te lo dice: preferimos eso a mezclar dos archivos en uno. Y el contenido son 106 campos por trabajador, con RUT, nombres y rentas, que es la razón de que el enlace caduque a los pocos minutos.
El certificado de cotizaciones
Es el documento que Previred firma y que una persona pide cuando tiene que probar lo que se le cotizó: para un crédito, un trámite previsional o un juicio laboral. El alcance certificados guarda uno vigente por trabajador; certificados.consultar dice en certificadoDisponible si está guardado, y certificado.descargar entrega el PDF por el RUT del trabajador.
El certificado cubre la ventana más ancha que Previred permite, 36 meses, terminando en el período que sincronizaste; periodoDesde y periodoHasta lo dicen. No se elige el rango, y es a propósito: la fila es «el certificado vigente de esta persona», así que cada sincronización lo reemplaza por uno un mes más nuevo en vez de acumular uno por mes.
Viene activado, y es el alcance que más tarda
Previred emite el certificado de a un trabajador por vez, así que en una empresa grande este alcance alarga la sincronización. Si no vas a usar los documentos, puedes desactivarlo; si lo que necesitas son los montos, cotizaciones.consultar los tiene sin descargar nada.
Hay una segunda razón para desactivarlo si no lo usas. Previred a veces pone el servicio en modo diferido, que envía un correo al empleador con el documento adjunto. Emisso no usa ese modo: cuando el portal lo declara, la sincronización de este alcance falla y te lo dice. Un conector de solo lectura no manda correos a nombre de nadie.
Qué otras empresas ve esta clave
En Previred una misma clave suele administrar varias empresas, sobre todo si es la del contador. El alcance empresas guarda ese listado y empresas.consultar lo devuelve, lo que responde de una vez la pregunta de onboarding: «¿qué más puedo conectar con esta clave?».
El listado llega junto con el resto de la sincronización; incluir ese alcance no agrega consultas a Previred.
La lista muestra las empresas a las que puede acceder la clave. Para leer los datos de cada empresa necesitas crear su propia conexión, identificada por su conn_….
Filtrar por trabajador
cotizaciones.consultar y certificados.consultar aceptan rutTrabajador. El RUT nunca queda legible en la base de Emisso: se guarda cifrado y el filtro corre sobre un índice ciego. Mándalo sin puntos y con guion (12345678-5).
Errores que vas a ver
| Código | Qué significa | Qué hacer |
|---|---|---|
428 connection_credential_required | La clave no sirve, está bloqueada o vencida, o la empresa no está asignada a ese usuario de Previred. El mensaje distingue los casos. | Si es la clave, emite un enlace de reconexión. Si es la asignación, pide un usuario secundario a quien administre la empresa. |
409 connection_busy | La conexión está en uso o el servicio alcanzó temporalmente su capacidad. | Espera unos segundos y reintenta. No reconectes ni vuelvas a ingresar credenciales. |
502 upstream_error | El portal falló de forma transitoria, o devolvió algo que no era el documento esperado. | Reintenta más tarde. El portal es lento cuando genera comprobantes. |
El envelope de cada código está en el catálogo de errores.
Lo que este conector no hace
No paga. Previred no cierra el pago dentro de su propio sitio: la orden se genera ahí y el dinero se mueve en el portal del banco, con las credenciales y el segundo factor del banco. Ningún software del mercado automatiza ese tramo, y Emisso tampoco lo intenta.
No carga nóminas. Declarar una nómina es escribir en Previred, y este conector solo lee.
Próximos pasos
- Cada tool, con su contrato completo: referencia de
previred. - La separación entre escribir la caché y leerla: Sincronizar y consultar.
- Saber de cada sync sin preguntar: Webhooks.
Notta
Emite facturas y notas ante el SII desde tus agentes. Autorizas una vez en Notta con tu propia cuenta: no hay ninguna API key que crear ni pegar.
Tesorería General de la República
Los convenios de pago de una empresa con la Tesorería: resoluciones, estado de pago, cuotas pagadas y por pagar, y deudas acogidas, con la Clave Tributaria del SII.