# Turn the IESS Portal de Empleadores into an API

> Read your comprobantes de pago, pending Mora Patronal and the Certificado de Obligaciones Patronales from the IESS employer portal with one API call each. Or build a workflow that checks last month's planilla de aportes on the 2nd and emails you if unpaid.

Page: https://fous.com/automate/iess-portal-de-empleadores
Updated: 2026-11-12

Works with your own IESS - Portal de Empleadores account. Fous is an independent product.

## What you can build on the IESS employer portal

### Get comprobantes de pago

Reads Generación, Consulta e Impresión de Comprobantes (payment slips) for the comprobante type you pick, such as planillas de aportes or fondos de reserva.

- Takes: Comprobante type, period (optional)
- Returns: Comprobante type, period, comprobante number, amount, status

### Check Mora Patronal

Reads Consulta Mora Patronal (employer arrears), which lists the obligations still pending payment for your RUC.

- Takes: Nothing
- Returns: Obligation type, period, amount, total pending

### Get the Certificado de Obligaciones Patronales

Requests the Certificado de Obligaciones Patronales (compliance certificate) for a RUC and reads whether that employer registers mora with the IESS.

- Takes: RUC
- Returns: RUC, employer name, registers mora or not, issue date, valid until

### Send an aviso de entrada

In Aviso de Entrada y Salida, opens Registro de novedades, adds the worker and sends the aviso with relación de trabajo, actividad sectorial, denominación and sueldo.

- Takes: Worker cédula, start date, relación de trabajo, actividad sectorial, denominación, sueldo
- Returns: Worker cédula, novedad number, start date, sueldo, status

## Automate the IESS employer portal 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.

### Last month's unpaid planilla de aportes, by email

Starts: Every month on the 2nd at 8:00

1. Get the comprobantes de pago of type planilla de aportes for last month.
2. Keep the comprobantes that are not yet paid.
3. Email you the comprobante number, period and amount of each.

### New Mora Patronal, posted to your finance system

Starts: Every Monday at 7:00

1. Check Mora Patronal for your employer account.
2. Keep the obligations that were not there on the last run.
3. Post each one, with type, period and amount, to your finance system's webhook.

### Compliance certificates for every RUC on your list

Starts: Every month on the 1st at 9:00

1. For each RUC you name, get the Certificado de Obligaciones Patronales.
2. Keep the RUCs that register mora with the IESS.
3. Email you the list with each employer's name, RUC and issue date.

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 comprobantes de 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": "www.iess.gob.ec/get_comprobantes_de_pago",
    "input": {
      "comprobante_type": "planilla de aportes",
      "period": "2026-10"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "ruc": "1790000000001",
    "employer": "Acme Ecuador S.A.",
    "comprobantes": [
      {
        "type": "planilla de aportes",
        "period": "2026-10",
        "comprobante_number": "000000000123",
        "amount": 8452.37,
        "currency": "USD",
        "status": "pendiente"
      }
    ],
    "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.

## The IESS employer portal’s own options

The IESS's pages for employers list no API or web service. Hires, exits, salary changes and other novedades are entered in the employer portal, one at a time or in bulk through Cargas Batch, and comprobantes de pago are generated, consulted and printed there. Payment can be made online, at banks and Servipagos, by credit card or by Débito Bancario.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Cargas Batch | Mass registration of the novedades that affect your workers' historia laboral, instead of entering them one by one. | An employer account on the portal and its clave de empleador. |
| Débito Bancario | Paying your IESS obligations by bank debit. | An employer account on the portal. |
| Public Certificado de Obligaciones Patronales | A PDF certificate saying whether a RUC registers mora with the IESS, valid for 30 days. | Only the RUC. No sign-in and no cost. |
| The IESS employer portal by hand | Avisos de entrada y salida, Registro de novedades, comprobantes de pago, Mora Patronal and fondos de reserva, open 24 hours. | Your cédula and clave de empleador. No cost. |

Read on November 12, 2026: [IESS: Empleadores](https://www.iess.gob.ec/empleadores/), [Generación, consulta e impresión de comprobante de pago (IESS-035-01-06)](https://www.gob.ec/sites/default/files/sign/procedure-IESS-035-01-06-20260808212121-20225802-signed.pdf), [Solicitud de certificado de cumplimiento de obligaciones patronales](https://www.gob.ec/iess/tramites/emision-certificado-cumplimiento-obligaciones-patronales).

## Signing in to the IESS employer portal

The IESS employer portal signs you in with your cédula (or código de identificación para extranjeros) and your clave de empleador, which is personal and recovered on the portal or requested in person. With Fous you sign in once through the portal'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

- **Avisos have short deadlines**: The aviso de entrada is due within the first 15 days of work. Salary changes, a worker's exit and other novedades are due within 3 days of happening.
- **After 45 days, a novedad goes to a counter**: A novedad registered past 45 days is extemporánea: it starts on the portal, then needs a request with its novedad number and supporting documents, filed in person.
- **Regenerating a planilla has a cut-off**: To fix a planilla de aportes you first annul its comprobantes, and fondos de reserva planillas if needed. Regeneration can be requested only until the 15th of the month after next.
- **The certificate is public and lasts 30 days**: The Certificado de Obligaciones Patronales needs only a RUC, downloads as a PDF and is valid for 30 days. A blank certificate means nothing is registered for that number.

## 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)
- [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)
- [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: [uFiling](/automate/ufiling), [TRACES NT](/automate/traces-nt), [Companies House WebFiling](/automate/companies-house-webfiling), [LOOP](/automate/loop), [Halifax Intermediaries Online](/automate/halifax-intermediaries-online), [FBI NICS E-Check](/automate/fbi-nics-e-check).

## Frequently asked questions

### Does the IESS Portal de Empleadores have an API?

No. The IESS's pages for employers list no API or web service. You register novedades in the portal, one by one or in bulk with Cargas Batch, and generate comprobantes de pago there. The Certificado de Obligaciones Patronales can be requested with only a RUC.

### How do I get the comprobante de pago for the planilla de aportes?

In the portal, open Generación, Consulta e Impresión de Comprobantes, choose the comprobante type, check its detail, generate it and download or print it. The same screen covers fondos de reserva, extensión de salud, títulos de crédito and acuerdos de pagos parciales.

### Can I check whether a contractor or supplier is up to date with the IESS?

Yes. The Certificado de Obligaciones Patronales is requested with the employer's RUC and says whether it registers mora with the IESS. It downloads as a PDF and is valid for 30 days. You can build a workflow that requests it every month for each RUC on your list.

### What happens if I miss the deadline for an aviso?

The novedad can still be entered, but past 45 days it becomes a novedad extemporánea: you start it on the portal, then file a request and supporting documents in person. Registering novedades on time also avoids glosas.

### Is Fous affiliated with the Instituto Ecuatoriano de Seguridad Social (IESS)?

No. Fous is an independent product. You use it with your own IESS employer 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 IESS - Portal de Empleadores (Instituto Ecuatoriano de Seguridad Social (IESS)). 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.