# Get your Aportes en Línea planillas through an API

> Read your planillas in Liquidaciones (settlements), your Empleados (employees) and your reports from Aportes en Línea with one API call each. Then have a workflow check each weekday which planillas of the period are still unpaid before the PSE cut-off.

Page: https://fous.com/automate/aportes-en-linea
Updated: 2026-11-12

Works with your own Aportes en Línea account. Fous is an independent product.

## What you can build on Aportes en Línea

### Get planillas from Liquidaciones

Reads the Liquidaciones (settlements) tab of the Portal Empleador: the planillas to pay and, with incluir planillas pagadas, the ones already paid.

- Takes: Period (optional), include paid planillas (yes or no)
- Returns: Planilla number, period, planilla type, employees, total, paid or pending

### Get the Empleados list

Reads the Empleados (employees) tab: each worker registered for your company, with the novedades already reported for them.

- Takes: Nothing
- Returns: Document type, document number, name, tipo de cotizante, novedades

### Generate a predetermined report

Opens Informes Personalizados (custom reports), picks one under Informes Predeterminados, fills in its fields and reads its row in Historial informes generados.

- Takes: Report name, the fields that report asks for (such as period)
- Returns: Report name, requested at, status, download link

### Add a novedad to an employee

Finds the employee on the Empleados tab, selects Opciones and Adicionar Novedad, and records the novedad you give.

- Takes: Document number, novedad type, start date, end date (optional)
- Returns: Document number, name, novedad type, dates, saved or not

## Automate Aportes en Línea 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.

### Unpaid planillas of the period, before the PSE cut-off

Starts: Every weekday at 8:00, Bogotá time

1. Get the planillas in Liquidaciones for the current period, without the paid ones.
2. Stop when none is pending.
3. Email you each pending planilla with its number, period, type and total.

### Paid planillas, handed to accounting

Starts: Every weekday at 19:00, Bogotá time

1. Get the planillas in Liquidaciones for the current period, including the paid ones.
2. Keep the planillas that are paid now and were pending on the last run.
3. Post planilla number, period, type and total to your accounting system's webhook.

### Employees added or gone since last month

Starts: Monthly, on the 20th at 9:00, Bogotá time

1. Get the Empleados list.
2. Keep the employees that were not there on the last run, and those that are gone.
3. Email you both lists to check against your payroll before you liquidate the period.

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 planillas from Liquidaciones” 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": "empresas.aportesenlinea.com/get_planillas",
    "input": {
      "period": "2026-11",
      "include_paid": true
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "company": "Acme S.A.S.",
    "planillas": [
      {
        "planilla_number": "9481203367",
        "period": "2026-11",
        "planilla_type": "E",
        "employees": 42,
        "total": 18734500,
        "currency": "COP",
        "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.

## Aportes en Línea’s own options

Aportes en Línea gives employers the Portal Empleador, where planillas are liquidated by hand, from a flat file or Excel, or through its Excel add-in, and paid by PSE or in person. Its Datos en línea service has an API, but it is for querying people's and employers' contribution data, not for filing, paying or reading your own planillas.

| Option | What it covers | What it takes |
| --- | --- | --- |
| File upload and the Excel add-in | Cargar Archivo Plano and Cargar Archivo Excel liquidate a planilla from a file; the add-in adds an Aportes en Línea tab to Excel. | A Portal Empleador account and the add-in installed as a COM complement in Excel. |
| Datos en línea | Person, employer, novedades and historia laboral data with 24 months of history, by API, batch .csv or web portal. | Datos en línea, a service apart from the Portal Empleador; it does not liquidate or pay planillas. |
| The Portal Empleador by hand | Empleados, novedades, Liquidaciones, payment, corrections and Informes Predeterminados. | A user and password for the company's registration. |

Read on November 12, 2026: [Seguridad Social ebook (Aportes en Línea)](https://webserver-portalesaportesenlinea-prd.lfr.cloud/documents/d/home/e-book-2026-1-), [Datos en línea](https://www.aportesenlinea.com/datos-en-linea/inicio), [PILA for employers](https://www.aportesenlinea.com/empresas/productos/pila).

## Signing in to Aportes en Línea

The Portal Empleador at empresas.aportesenlinea.com signs you in with a user and password, and the password must have 8 to 16 characters with a special character and a capital letter. With Fous you sign in once through the site's own sign-in with your own account. The login is sealed with AES-256, never shown to code or AI agents, and when the session expires Fous signs back in.

## Worth knowing

- **PSE payments have a daily cut-off**: PSE payments run Monday to Friday until 4:30 p.m., with extra hours from 6:30 p.m. to 11:59 p.m. A payment made later, on a weekend or holiday is credited the next business day.
- **Planilla N sin pago has a monthly deadline**: A correction planilla without payment must be generated and confirmed before the last business day of the month, by 4:30 p.m.
- **Three or more workers means paying online**: Employers with 3 or more colaboradores must pay the PILA by electronic means, not in person.
- **Reports arrive in a history list**: A report from Informes Predeterminados is requested with Generar Informe and downloaded later from Historial informes generados. Reports per planilla are under Liquidaciones, with Ver.

## 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)
- [Oficina Virtual CCSS (SICERE)](https://fous.com/automate/oficina-virtual-ccss-sicere.md)
- [SUIR](https://fous.com/automate/suir.md)
- [Previred](https://fous.com/automate/previred.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: [CIPC eServices](/automate/cipc-eservices), [SGK İşveren Sistemi](/automate/sgk-isveren-sistemi), [net-entreprises.fr](/automate/net-entreprises-fr), [Accela Citizen Access](/automate/accela-citizen-access), [Santander for Intermediaries](/automate/santander-for-intermediaries), [IRIS Taxpayer Portal](/automate/iris-taxpayer-portal).

## Frequently asked questions

### Does Aportes en Línea have an API?

Not for employers' own planillas. Its Datos en línea service offers an API and batch .csv queries of person, employer, novedades and labor history data. Liquidating, paying and reading your planillas happens in the Portal Empleador, with file uploads and an Excel add-in.

### Can I get a contribution certificate without signing in?

Yes. The Certificado de aportes page in Autoservicio generates a PILA or Cesantías certificate from a document type and number, the document's issue date, the EPS and a starting year. The Soporte de pago page emails a payment receipt for a clave de pago.

### Can several branches be handled from one user?

Yes. A user with the tesorería profile can associate a sucursal to a multiusuario under Empleador and Usuarios, with Adicionar Registro.

### Is Fous affiliated with Aportes en Línea S.A.?

No. Fous is an independent product. It works through the Portal Empleador with your own account and 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 Aportes en Línea (Aportes en Línea S.A.). 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.