# Pull your Oficina Virtual CCSS planilla into your systems

> Read your planilla's invoice, its payment date and the billing reports from the Oficina Virtual CCSS with one API call each. A workflow can read the invoice each month on the 16th, when the CCSS says to check payment dates, and post it to accounting.

Page: https://fous.com/automate/oficina-virtual-ccss-sicere
Updated: 2026-11-12

Works with your own Oficina Virtual CCSS (SICERE) account. Fous is an independent product.

## What you can build on the Oficina Virtual

### Get the planilla invoice for a period

Reads the factura (invoice) for one billing period of your planilla, with the amount due and the payment date the Oficina Virtual shows.

- Takes: Billing period
- Returns: Employer, period, amount due, currency, payment date, paid or pending

### Get the billing reports for a period

Generates the reports under Generar los reportes de la facturación (billing reports) for one period and reads them worker by worker.

- Takes: Billing period
- Returns: Worker, ID number, salary reported, occupation, insurance class, amount billed

### Check earlier Grandes Clientes uploads

Reads Consulta Cargas Previas (earlier uploads) for planilla files sent in the Grandes Clientes format, with how each one was validated.

- Takes: Billing period (optional)
- Returns: File name, upload date, period, validation result, errors

### Add a new worker to the planilla

Uses Incluir un nuevo trabajador (add a new worker) to put a hire on your planilla with salary, occupation, jornada and clase de seguro.

- Takes: ID number, name, start date, salary, occupation, jornada, insurance class
- Returns: ID number, name, start date, salary, confirmation

## Automate the Oficina Virtual with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Planilla invoice and payment date, to accounting

Starts: Every month on the 16th at 8:00, Costa Rica time

1. Get the planilla invoice for the latest billing period.
2. Stop when the invoice is already paid.
3. Post the period, amount due and payment date to your accounting system's webhook.

### Billing reports: workers whose salary or class changed

Starts: When your payroll system calls the workflow's webhook with a billing period

1. Get the billing reports for the period your system sends.
2. Keep the workers whose salary or insurance class changed since the last run.
3. Email you the list with ID number, salary reported and amount billed.

### New results on your Grandes Clientes uploads

Starts: Every weekday at 7:00, Costa Rica time

1. Check the earlier Grandes Clientes uploads for the latest billing period.
2. Keep the files that were not there on the last run.
3. Email you each file's name, upload date, validation result and errors.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get the planilla invoice for a period” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "aissfa.ccss.sa.cr/get_planilla_invoice",
    "input": {
      "period": "2026-10"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "employer": "Acme Servicios S.A.",
    "period": "2026-10",
    "amount_due": 2864310,
    "currency": "CRC",
    "payment_date": "2026-11-18",
    "status": "pending"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The Oficina Virtual’s own options

The CCSS's employer pages describe no API. Employers file the planilla in the Oficina Virtual worker by worker, or upload it as a file in the Grandes Clientes format, which the Oficina Virtual validates itself. The CCSSmóvil app uses the same account to consult and pay pending invoices.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Grandes Clientes file upload | The whole planilla in one file, validated on upload, with earlier uploads listed under Consulta Cargas Previas. | A file from your payroll system in the Grandes Clientes format, with the file name and coding the CCSS sets. |
| CCSSmóvil | Consult and pay pending invoices for cuotas obrero-patronales as an employer, and have your orden patronal sent by email. | The app on your phone and your Oficina Virtual account. |
| The Oficina Virtual by hand | Hires, exits, salary changes, incapacidades, invoicing, billing reports, payment, convenios de pago and planilla adjustments. | An Oficina Virtual account for the employer. |

Read on November 12, 2026: [CCSS: information and services for employers](https://www.ccss.sa.cr/patronos), [CCSSmóvil](https://www.ccss.sa.cr/ccssmovil/), [Oficina Virtual CCSS sign-in](https://aissfa.ccss.sa.cr/afiliacion/).

## Signing in to the Oficina Virtual

The Oficina Virtual signs you in with your Usuario (user name) and password, or with a Certificado digital (digital certificate). A forgotten password is regenerated with Olvidó su contraseña, and CCSSmóvil takes the same account. With Fous you sign in once through the Oficina Virtual's own sign-in with your own account: the login is sealed with AES-256 and never returned by the API or written to logs.

## Worth knowing

- **A fixed filing window every month**: The planilla is presented from the 26th of each month to the fourth business day of the next. Employers filing as Grandes Clientes have until the third business day.
- **Check the payment date from the 16th**: The CCSS tells employers to verify their payment date in the Oficina Virtual from the 16th to the 20th of each month. A monthly workflow can read it on the 16th.
- **Low salaries are raised to the BMC**: Salaries below ¢346,789.00 for SEM and ¢324,590.00 for IVM are adjusted to the base mínima contributiva (BMC), so the amount billed can differ from the salary you reported.
- **The IVM rate is 11.66% until 2028**: From January 2026 to December 2028 the IVM contribution is 11.66%. Keep it in mind when you compare the amount billed with your own payroll.

## More in Government: Latin America

- [Mis Comprobantes](https://fous.com/automate/mis-comprobantes.md)
- [Facturación Electrónica DIAN](https://fous.com/automate/facturacion-electronica-dian.md)
- [Simplificación Registral](https://fous.com/automate/simplificacion-registral.md)
- [ARCA - servicios con Clave Fiscal](https://fous.com/automate/arca-servicios-con-clave-fiscal.md)
- [Portal Empresarial INFONAVIT](https://fous.com/automate/portal-empresarial-infonavit.md)
- [SIFERE Web](https://fous.com/automate/sifere-web.md)
- [Declaración en Línea (F.931)](https://fous.com/automate/declaracion-en-linea-f-931.md)
- [AFPnet](https://fous.com/automate/afpnet.md)
- [ARBA](https://fous.com/automate/arba.md)
- [SEACE](https://fous.com/automate/seace.md)
- [SECOP II](https://fous.com/automate/secop-ii.md)
- [BPS Servicios en Línea](https://fous.com/automate/bps-servicios-en-linea.md)
- [IESS - Portal de Empleadores](https://fous.com/automate/iess-portal-de-empleadores.md)
- [SUIR](https://fous.com/automate/suir.md)
- [Previred](https://fous.com/automate/previred.md)
- [Aportes en Línea](https://fous.com/automate/aportes-en-linea.md)
- [SOI](https://fous.com/automate/soi.md)
- [SIPARE](https://fous.com/automate/sipare.md)
- [DGI Servicios en Línea](https://fous.com/automate/dgi-servicios-en-linea.md)
- [e-Tax 2.0](https://fous.com/automate/e-tax-2-0.md)
- [Agencia Virtual SAT](https://fous.com/automate/agencia-virtual-sat.md)
- [Oficina Virtual DGII](https://fous.com/automate/oficina-virtual-dgii.md)
- [Portal del SAT (Factura Electrónica)](https://fous.com/automate/portal-del-sat-factura-electronica.md)
- [SII (Mi SII)](https://fous.com/automate/sii-mi-sii.md)
- [SRI en Línea](https://fous.com/automate/sri-en-linea.md)
- [SUNAT Operaciones en Línea (SOL)](https://fous.com/automate/sunat-operaciones-en-linea-sol.md)
- [TRIBU-CR](https://fous.com/automate/tribu-cr.md)
- [Declaraciones y Pagos (SAT)](https://fous.com/automate/declaraciones-y-pagos-sat.md)
- [DIAN MUISCA](https://fous.com/automate/dian-muisca.md)

Other industries: [EmaraTax](/automate/emaratax), [e-ΕΦΚΑ](/automate/e-efka), [Planning Portal](/automate/planning-portal), [Sunshine 811](/automate/sunshine-811), [HSBC UK for Intermediaries](/automate/hsbc-uk-for-intermediaries), [FLAG](/automate/flag).

## Frequently asked questions

### Does Oficina Virtual CCSS (SICERE) have an API?

Not one the CCSS describes for employers. You file the planilla in the Oficina Virtual by hand or as a file in the Grandes Clientes format, and you can consult and pay invoices in CCSSmóvil. With Fous you build methods on the Oficina Virtual with your own account and call them from code.

### When can I present the planilla?

From the 26th of each month to the fourth business day of the next month. Employers filing in the Grandes Clientes format have until the third business day.

### Why is the amount billed higher than the salary I reported?

Salaries below the base mínima contributiva are adjusted to it: ¢346,789.00 for SEM and ¢324,590.00 for IVM. The IVM contribution is 11.66% from January 2026 to December 2028.

### Can I pay the planilla invoice from my phone?

Yes. CCSSmóvil lets an employer consult and pay pending invoices for cuotas obrero-patronales, and it signs in with the same account as the Oficina Virtual.

### Is Fous affiliated with Caja Costarricense de Seguro Social (CCSS)?

No. Fous is an independent product. You use it with your own Oficina Virtual account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Oficina Virtual CCSS (SICERE) (Caja Costarricense de Seguro Social (CCSS)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.