Skip to content

FousSOI

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.

Start building freeBook a demo

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

What you can build on SOI

  • Get planillas disponibles para pago

    Build this

    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

    Build this

    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

    Build this

    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

    Build this

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

    Build this
    Starts
    Every weekday at 8:00
    Step 1
    For each aportante you name, get the planillas disponibles para pago.
    Step 2
    Keep the planillas with a payment deadline in the next 5 days.
    Step 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

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

  • Planilla totals by administradora, handed to accounting

    Build this
    Starts
    When your payroll system calls the workflow's webhook with a NIT and planilla number
    Step 1
    Read the planilla's summary by administradora.
    Step 2
    Have an AI step group the values by subsystem: salud, pensión, ARL, CCF and parafiscales.
    Step 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, 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.

OptionWhat it coversWhat 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 inPlanillas 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 handLiquidació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, How to make and pay the planilla, Guide to correction planillas (planilla N).

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

Other industries: GDRFA Dubai Smart Services, Sociálna poisťovňa e-Služby, Urssaf compte employeur, DOB NOW, Filogix Expert, Motus.

Frequently asked questions

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.

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.

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.

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.

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.

Put SOI behind an API call

Describe one job in Studio and see the method it builds, with 100 credits a month and no credit card, or book a demo and bring the sites your team signs in to.

Start building freeBook a demo

Read nextSIPAREDGI Servicios en Líneae-Tax 2.0GDRFA Dubai Smart ServicesHow methods workHow workflows run

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.