Presentaciones electrónicas¶
Configuración → Planilla → Impuestos y cumplimiento → Presentaciones electrónicas lista las presentaciones periódicas de tu país de cumplimiento: el período que vence ahora, su fecha límite, el estado que registraste, la referencia de la agencia y la constancia. Para Costa Rica también genera el archivo CCSS SICERE.
En resumen
Para: administradores de planilla y el contador que presenta ante la agencia.
Tiempo: 5 minutos por período.
Resultado: archivo oficial generado, presentación controlada y constancia guardada.
Qué hace la consola y qué no¶
La consola trabaja en tres niveles, declarados por obligación:
| Nivel | Qué significa |
|---|---|
| API | Un conector presenta ante la agencia y guarda el acuse. Hoy solo lo usa la planilla del INS de Costa Rica. |
| Archivo oficial | La consola genera el archivo oficial, tú lo subes al portal de la agencia y registras la constancia. El SICERE de Costa Rica funciona así. |
| Manual | La consola controla el vencimiento, la referencia y la evidencia; la presentación se hace en el portal de la agencia. |
4Geeks no presenta en tu nombre. No hay agregadores intermediarios: el cliente siempre aporta su certificado y su autorización, y el cliente sube el archivo (o autoriza la conexión API cuando existe). El enlace de la constancia es obligatorio en la práctica: es lo que prueba la presentación.
El calendario de presentaciones¶
Cada obligación tiene agencia, alcance (seguridad social, renta, otro), periodicidad (mensual, anual, evento), nivel de entrega y regla de vencimiento. La consola:
- calcula el período que vence ahora (el mes que acaba de terminar en las obligaciones mensuales);
- calcula la fecha límite con fines de semana y feriados del país;
- la marca Vencida, Vence pronto (en 7 días) o Próxima;
- guarda una línea de tiempo de cada cambio de estado (
pending → generated → submitted → accepted/rejected) enpayroll_filing_events.
Registrar una presentación¶
- Abre la obligación en la lista.
- Haz clic en Registrar (o Actualizar).
- Elige el estado: Pendiente, Generada, Presentada, Aceptada o Rechazada.
- Completa la referencia (folio o número de planilla de la agencia), la URL de la constancia y una nota opcional.
- Guarda.
La fila guarda quién lo cambió y cuándo; la auditoría conserva el historial. Una presentación rechazada conserva el motivo en la nota.
Costa Rica: el archivo CCSS SICERE¶
El flujo de “Grandes Clientes” de la CCSS recibe un archivo ANSI de longitud fija. La consola lo construye con los datos de planilla y la configuración siguiente.
1. Configurar SICERE¶
En la tarjeta Archivo CCSS SICERE, define:
| Campo | Formato | Notas |
|---|---|---|
| Número patronal | 18 dígitos | Tipo de patrono, cédula jurídica, segregado y sector, tal como está registrado en la CCSS |
| Sucursal | 4 dígitos | Sucursal de la CCSS a la que está adscrito el patrono |
| Segregado | 3 dígitos, opcional | Solo si el patrono tiene números segregados |
| Código de ocupación por defecto | 4 dígitos | Se usa cuando el empleado no tiene un código específico |
| Tipo de identificación por defecto | 0 nacional, 7 extranjero | Se usa cuando el empleado no tiene un tipo específico |
| Clase de seguro por defecto | C o A | C = SEM, IVM y Banco Popular; A = pensionado (SEM y Banco Popular) |
| Clase y horas de jornada por defecto | EXT/ACU/DIU/MIX/NOC/VES/PAR + 2 dígitos | Se usa cuando el empleado no tiene una jornada específica |
Los valores por defecto son respaldo. Los códigos reales son de cada empleado: en el formulario del empleado (solo Costa Rica) define el código de ocupación CCSS, el tipo de identificación CCSS y la clase de seguro CCSS.
2. Generar el archivo¶
- Selecciona el período (la consola propone el mes anterior).
- Haz clic en Generar archivo SICERE.
- La consola valida cada registro. Si falta algo (una cédula, un código de ocupación), lista el problema y no genera el archivo.
- El archivo se descarga con el nombre oficial
pla_<patronal>[-<segregado>]_<MMAAAA>.txt, en ANSI (Windows-1252). - La presentación pasa a Generada y guarda el nombre del archivo y su SHA-256.
3. Subir y registrar la constancia¶
Sube el archivo en la Oficina Virtual de la CCSS (Grandes Clientes → Validación y Carga de Archivos), espera la validación oficial y luego registra Presentada o Aceptada con la referencia de la CCSS y el enlace de la constancia.
La CCSS valida; la consola no
Un archivo generado no es una presentación aceptada. El LOG de la CCSS es la autoridad final: revísalo, corrige lo que indique y vuelve a subir si hace falta.
Qué contiene el archivo¶
El layout sigue el Manual de Usuario Sistema de Grandes Clientes GF-DSCR-P004-M001 v2.04, sección 9:
| Registro | Longitud | Contenido |
|---|---|---|
| 25 | 30 (31 con suspensión) | Número patronal, sucursal, período AAAAMM; una S en la posición 31 suspende el número |
| 35 | 174 | Uno por movimiento: tipo y número de identificación, apellidos, nombre, ocupación (4), salario en céntimos (15), clase de seguro, tipo de cambio, horas y clase de jornada, código de cambio, fechas de inicio y fin |
| 15 | 33 | Control: PAT, fecha de generación, total de registros 25 y total de registros 35 |
Tipos de movimiento: IC inclusión, SA cambio de salario, OC cambio de ocupación, JO cambio de jornada, CS cambio de clase de seguro, PE permiso sin goce, IN incapacidad/licencia, EX exclusión. La consola deriva IC, SA, EX, IN y PE de los datos de planilla; los cambios de ocupación y jornada están soportados por el generador pero siguen siendo manuales.
Un mes sin movimientos es válido: el archivo lleva el registro 25 y el control 15 con cero registros 35.
Canales por país¶
| País | Agencia principal | Canal hoy |
|---|---|---|
| Argentina | ARCA (SICOSS/F931, Libro de Sueldos Digital) | Archivo oficial; API con certificado del cliente es posible |
| Bolivia | Gestora Pública / CNS / SIN | Archivo o portal |
| Brasil | eSocial / Receita Federal / FGTS Digital | API con certificado A1/A3 del cliente (aún no implementada) |
| Chile | Previred / SII | Archivo Previred; API del SII con certificado |
| Colombia | Operador PILA / DIAN | Archivo o portal del operador |
| Costa Rica | CCSS SICERE / INS / Hacienda | Archivo SICERE generado por la consola; API del INS |
| Ecuador | IESS / SRI | Archivo (batch) o portal |
| El Salvador | ISSS / AFP / MH | Archivo o portal |
| Guatemala | IGSS / SAT | Archivo o portal |
| Honduras | IHSS / SAR / DEI | Archivo o portal |
| México | IMSS-INFONAVIT (SUA/IDSE) / SAT | Archivo SUA y portal IDSE |
| Nicaragua | INSS / DGI | Manual o archivo |
| Panamá | CSS (SIPE) / DGI | Archivo o portal |
| Paraguay | IPS / SET | Archivo o portal |
| Perú | SUNAT PLAME / AFPnet | Archivo o portal |
| República Dominicana | TSS SUIR / DGII | Archivo o portal |
| Uruguay | BPS / DGI | Portal |
| Venezuela | IVSS / SENIAT | Manual |
Solución de problemas¶
| Síntoma | Causa y solución |
|---|---|
| No aparece “Generar archivo SICERE” | El país de cumplimiento no es Costa Rica o SICERE aún no está configurado. |
| El archivo no se genera y la pantalla lista problemas | Falta una cédula, un código de ocupación o una licencia sin fecha fin. Corrige el empleado o la licencia y genera de nuevo. |
| “Sin movimientos” | El mes no tiene inclusiones, cambios de salario, exclusiones, licencias ni permisos. La consola igual genera el archivo 25 + 15. |
| La CCSS rechaza el archivo | Revisa el nombre del archivo, que sea ANSI y las longitudes de los registros; luego compara con el LOG de la CCSS. La consola no presenta ni valida ante la CCSS. |
| La constancia no se guarda | La URL de la evidencia debe empezar con http:// o https://. |
Preguntas frecuentes¶
¿La consola sube el archivo a la CCSS?
No. Genera el archivo, guarda su hash y controla el estado. Tú lo subes en la Oficina Virtual de la CCSS y registras la constancia.
¿Puedo usar un intermediario o agregador?
No, por decisión de producto. Donde la agencia no tiene API pública, la consola se queda en archivo oficial + evidencia. El cliente aporta el certificado y la autorización para cualquier API directa.
¿Qué pasa si cambio una tasa después de generar el archivo?
El archivo es un snapshot: no cambia. Si el cambio afecta el período, genéralo de nuevo antes de subirlo; el nuevo archivo tiene otro hash y la presentación se actualiza.
¿Dónde se guarda la evidencia?
La constancia es una URL que registras en la presentación; el nombre del archivo generado y su SHA-256 se guardan en la fila. Conserva el archivo en tu propio repositorio documental.
¿El archivo SICERE sirve para la primera planilla?
La primera planilla la genera la CCSS. El archivo de la consola reporta movimientos desde los períodos siguientes.
Relacionado¶
¿Aún tienes dudas? Pregunta en Discord o explora los tutoriales.