# Turn your SOI PILA planillas into an API

> Build a method that reads your SOI planillas disponibles para pago (planillas ready to pay) or a planilla's totals by administradora, and call it from code. A workflow can check every aportante you manage each weekday and email you what is unpaid.

Page: https://fous.com/automate/soi
Updated: 2026-11-12

Works with your own SOI account. Fous is an independent product.

## What you can build on SOI

### Get planillas disponibles para pago

Reads Planillas disponibles para pago for one aportante (contributor), found by its document type and number: the planillas that are generated and waiting to be paid.

- Takes: Document type, document number
- Returns: Planilla number, planilla type, period, value to pay, payment deadline

### Read a planilla's summary by administradora

Switches to the aportante with Cambiar Aportante, opens the planilla and reads its values per administradora for salud, pensión, ARL, CCF and parafiscales.

- Takes: Aportante NIT, planilla number
- Returns: Planilla number, type, period, administradora, subsystem, value, total to pay

### Project a planilla's payment at a date

Uses Proyecte su pago (project your payment) on an unpaid planilla to calculate what it will cost on a later date, intereses por mora (late interest) included.

- Takes: Aportante NIT, planilla number, payment date
- Returns: Planilla number, payment date, contributions, late interest, total to pay

### Upload the monthly planilla E from Excel

In Gestionar planillas > Por archivo, uploads your filled Excel template as a planilla E (empleados) for a period and selects Finalizar to get its number.

- Takes: Aportante NIT, Excel file, period
- Returns: Validation result, differences found, planilla number, total to pay

## Automate SOI 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.

### Planillas still unpaid, every aportante you manage

Starts: Every weekday at 8:00

1. For each aportante you name, get the planillas disponibles para pago.
2. Keep the planillas with a payment deadline in the next 5 days.
3. Email you the list, one section per aportante, with planilla number, period, value and deadline.

### Late interest on overdue planillas, posted to your ERP

Starts: Every Monday at 9:00

1. For each aportante, get the planillas disponibles para pago.
2. Keep the planillas whose payment deadline has passed.
3. For each one, project the payment at today's date.
4. Post planilla number, contributions, intereses por mora and total to your ERP webhook.

### Planilla totals by administradora, handed to accounting

Starts: When your payroll system calls the workflow's webhook with a NIT and planilla number

1. Read the planilla's summary by administradora.
2. Have an AI step group the values by subsystem: salud, pensión, ARL, CCF and parafiscales.
3. Post the grouped totals and the planilla number to your accounting system's webhook.

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 disponibles para pago” 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": "servicio.nuevosoi.com.co/get_planillas_disponibles",
    "input": {
      "document_type": "NIT",
      "document_number": "900000001"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "aportante": "Acme S.A.S.",
    "document_type": "NIT",
    "document_number": "900000001",
    "planillas": [
      {
        "planilla_number": "8800000001",
        "planilla_type": "E",
        "period": "2026-10",
        "value_to_pay": 18452300,
        "currency": "COP",
        "payment_deadline": "2026-11-14"
      }
    ],
    "count": 1
  }
}
```

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.

## SOI’s own options

SOI's help centre documents no API for contributors. A planilla is made in the portal, typed in En Línea or uploaded as an Excel template or a flat file in the format of Resolución 2388 de 2016. Companies with up to 3 employees can also have SOI's call centre make it for them, and payment receipts and certificates can be looked up without signing in.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Por archivo (file upload) | Upload a planilla as SOI's Excel template or a flat file; SOI validates it and returns an Excel report of any differences. | A SOI account. Flat files follow Resolución 2388 de 2016; above 99,999 type 2 records, split the file in two. |
| Planilla asistida (assisted planilla) | SOI's advisers make the planilla by phone and give you its number, value and payment deadline. | A company with 3 or fewer employees. Call centre on weekdays 7:00 to 18:00 and Saturdays 8:00 to 12:00. |
| Lookups without signing in | Planillas disponibles para pago, Soportes de pago (payment receipts) and Certificados por cotizante, the certificates as PDF or by email. | The aportante's document, then the planilla number and administradora, or the employee's document, EPS and period. |
| SOI by hand | Liquidación Activos En Línea or por archivo, unpaid and recent planillas, corrections with planilla N and payment by PSE. | A company account: the company's document, the user's document and a password. |

Read on November 12, 2026: [SOI help centre for companies](https://www.soi.com.co/empresa-centro-de-ayuda), [How to make and pay the planilla](https://www.soi.com.co/empresa-como-hacer-y-pagar-la-planilla), [Guide to correction planillas (planilla N)](https://www.soi.com.co/documents/1174804/1295500/instructivo+liquidacion+planillas+de+correccion.pdf/1c4160cf-2ddd-cc8c-3737-afd4f7697809?t=1681329491732).

## Signing in to SOI

SOI signs a company in with three things: the company's document (such as its NIT), the user's own document and a password of 6 to 15 letters and digits. One user and password can manage several aportantes. With Fous you sign in once through SOI's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **One password, several aportantes**: The same user and password reach several aportantes, and you move between them with Cambiar Aportante, so a method takes the aportante's NIT as an input. Only an Administrador can add users or change company data.
- **The file is validated before it gets a number**: SOI checks an uploaded planilla against the Ministry of Health's data and shows any differences as an Excel report. Only after you select Finalizar does the planilla get its number.
- **Corrections use a planilla N**: A paid planilla is corrected with a planilla N, and the base planilla must have been paid through SOI. Novedades (changes) that do not change the value must be reported before the last business day of the month of timely payment.
- **Paying elsewhere changes the planilla number**: Pago Otros Canales can be enabled only when your bank account is blocked, and it changes the planilla number. A planilla you track by its number then appears under the new one.

## 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)
- [Aportes en Línea](https://fous.com/automate/aportes-en-linea.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: [GDRFA Dubai Smart Services](/automate/gdrfa-dubai-smart-services), [Sociálna poisťovňa e-Služby](/automate/socialna-poistovna-e-sluzby), [Urssaf compte employeur](/automate/urssaf-compte-employeur), [DOB NOW](/automate/dob-now), [Filogix Expert](/automate/filogix-expert), [Motus](/automate/motus).

## Frequently asked questions

### Does SOI have an API?

Not one that SOI documents for contributors. Its help centre describes making planillas in the portal, uploading them as an Excel template or a flat file in the Resolución 2388 de 2016 format, and assisted planillas by phone for companies with up to 3 employees.

### Can I upload my payroll software's PILA file to SOI?

Yes. In Por archivo you can upload a flat file that follows Resolución 2388 de 2016, or fill in SOI's Excel template (Nuevo formato) for a planilla E. SOI validates it, shows any differences as an Excel report and gives the planilla a number when you select Finalizar.

### How do I get an employee's contribution certificate from SOI?

Use Certificados por cotizante, which works without signing in. Enter the aportante's document, the employee's document, their EPS and the payment period, then download the PDF or have it sent by email.

### How do I correct a planilla I have already paid?

Make a planilla N, from Planillas Recientes with Corregir or from Liquidación Activos. The base planilla must have been paid through SOI. You enter the corrected values, and SOI assigns a new planilla number to pay or, when the difference is zero, to send to the administradoras.

### Is Fous affiliated with ACH Colombia?

No. Fous is an independent product. You use it with your own SOI 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 SOI (ACH Colombia). 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.