Get your Aportes en Línea planillas through an API

What you can build on Aportes en Línea

• Get planillas from Liquidaciones

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

  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 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

  Build this

  Starts

  Every weekday at 8:00, Bogotá time

  Step 1

  Get the planillas in Liquidaciones for the current period, without the paid ones.

  Step 2

  Stop when none is pending.

  Step 3

  Email you each pending planilla with its number, period, type and total.

• Paid planillas, handed to accounting

  Build this

  Starts

  Every weekday at 19:00, Bogotá time

  Step 1

  Get the planillas in Liquidaciones for the current period, including the paid ones.

  Step 2

  Keep the planillas that are paid now and were pending on the last run.

  Step 3

  Post planilla number, period, type and total to your accounting system's webhook.

• Employees added or gone since last month

  Build this

  Starts

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

  Step 1

  Get the Empleados list.

  Step 2

  Keep the employees that were not there on the last run, and those that are gone.

  Step 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, 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.

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
    }
  }'

{
  "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.

Read on November 12, 2026: Seguridad Social ebook (Aportes en Línea), Datos en línea, PILA for employers.

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
• Facturación Electrónica DIAN
• Simplificación Registral
• ARCA - servicios con Clave Fiscal
• Portal Empresarial INFONAVIT
• SIFERE Web
• Declaración en Línea (F.931)
• AFPnet
• ARBA
• SEACE
• SECOP II
• BPS Servicios en Línea
• IESS - Portal de Empleadores
• Oficina Virtual CCSS (SICERE)
• SUIR
• Previred
• SOI
• SIPARE
• DGI Servicios en Línea
• e-Tax 2.0
• Agencia Virtual SAT
• Oficina Virtual DGII
• Portal del SAT (Factura Electrónica)
• SII (Mi SII)
• SRI en Línea
• SUNAT Operaciones en Línea (SOL)
• TRIBU-CR
• Declaraciones y Pagos (SAT)
• DIAN MUISCA

Other industries: CIPC eServices, SGK İşveren Sistemi, net-entreprises.fr, Accela Citizen Access, Santander for Intermediaries, IRIS Taxpayer Portal.