# Turn BPS Servicios en Línea into an API

> Read the Resultado de envíos (submission results) of your nóminas (payroll declarations), pending obligations and any RUT's Certificado Común (clearance certificate) in one API call each. Each weekday, a workflow can email you the envíos Con Errores.

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

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

## What you can build on BPS

### Check Declaración nominada results

Reads Resultado de envíos in Declaración nominada (payroll declarations) for a date range and type: each envío's state, result and the actions offered.

- Takes: From date, to date, declaration type (optional)
- Returns: Sent at, period, file, type, aportación and empresa, state, result, observations or errors, factura available

### Get pending obligations and payments

Reads Consultar obligaciones pendientes, financiación de deudas y pagos realizados: obligations due and overdue, and the payments already made.

- Takes: Company, from period (optional)
- Returns: Period, concept, due date, amount, overdue or not, payments made with date and amount

### Check a RUT's Certificado Común

Uses Consultar vigencia del certificado común (check a common certificate's validity) to see, from a RUT alone, whether that contributor has one in force.

- Takes: RUT
- Returns: RUT, in force or not, the details the result shows

### Send a nómina file

In Declaración nominada, uses Envío de archivo with a Tipo de Declaración, attaches a file or .zip made with ATYRO or your own software and sends it.

- Takes: Declaration type, file or .zip
- Returns: Sent at, period, file, type, state, result

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

### Envíos Con Errores or with observations, each morning

Starts: Every weekday at 8:00

1. Check Declaración nominada results for the last 7 days.
2. Keep the envíos whose result is Con Errores, Ok/Observaciones or Acceso Denegado and that were not there on the last run.
3. Email you each one with its period, file, empresa, result and the errors or observations.

### Pending BPS obligations, every week

Starts: Every Monday at 7:30

1. For each company you name, get the pending obligations and payments.
2. Keep the obligations that are overdue or fall due within the next 7 days.
3. Post company, period, concept, due date and amount to your accounting system's webhook.

### Certificado Común changes on your list of RUTs

Starts: Every weekday at 9:00

1. For each RUT on your list, check its Certificado Común with Consultar vigencia del certificado común.
2. Keep the RUTs whose answer changed since the last run.
3. Email you the RUT and whether its certificate is now in force.

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 “Check Declaración nominada results” 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": "bps.gub.uy/check_declaracion_nominada_results",
    "input": {
      "from": "2026-11-01",
      "to": "2026-11-12",
      "type": "Nóminas"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "envios": [
      {
        "sent_at": "2026-11-10T16:42:00-03:00",
        "period": "2026-10",
        "file": "acme_nomina_202610.txt",
        "type": "N",
        "aportacion_empresa": "Industria y Comercio / Acme Servicios S.A.",
        "state": "Terminada",
        "result": "Ok/Observaciones",
        "observations": [
          "Line 14: health insurance code differs from the registered activity"
        ],
        "factura_available": true
      }
    ],
    "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.

## BPS’s own options

BPS's guides for employers describe no API. Nóminas, rectificativas and deducciones go through the online service Declaración nominada, typed in or sent as files made with ATYRO, BPS's free program, or with your own software following BPS's file format. Obligations, facturas and certificates are separate online services used through a browser.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Envío de archivo in Declaración nominada | Sends nóminas, rectificativas, sustituciones or deducciones as one file or a .zip of several, then shows each envío's state and result. | A usuario personal BPS with permission for the company, and a file from ATYRO or your own software. |
| ATYRO and the Formato de archivo de declaraciones | ATYRO generates declaration files. Your own software can write them to BPS's published format and check them with its format verifier. | ATYRO is free from BPS. The format document and verifier are published on bps.gub.uy. |
| BPS Servicios en Línea by hand | Declaración nominada, GAFI ingreso and egreso de actividad, obligations, facturas and certificates, each as its own online service. | A usuario personal BPS, obtained in person, or Cédula Electrónica or Usuario gub.uy, plus delegated permissions. |

Read on November 12, 2026: [Instructivo: envío de archivos (Declaración nominada)](https://www.bps.gub.uy/22920/), [Medios para generar nóminas, rectificativas y deducciones](https://www.bps.gub.uy/10182/medios-para-generar-nominas-rectificativas-y-deducciones.html), [Servicios en línea para empresas](https://serviciosenlinea.bps.gub.uy/ServiciosEnLineaWeb/servicios?escr=EMPRESA).

## Signing in to BPS

BPS signs you in with a usuario personal BPS and its contraseña, or with Cédula Electrónica or Usuario gub.uy. The usuario personal belongs to one person and a company gives it permissions through Delegar permisos de empresas. With Fous you sign in once through BPS's own sign-in with your usuario personal and contraseña: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **One usuario per person, permissions per company**: A usuario personal BPS is unique to one person and is obtained in person at Abitab, Red Pagos, Anda or a BPS branch. Without delegated permission for a company, an envío returns Acceso Denegado.
- **Results arrive after the envío**: An envío is first En proceso. Its result, Ok, Ok/Observaciones or Con Errores, and the links to the factura or multas appear later in Resultado de envíos, so read results in a separate step.
- **A sustitución is allowed only once**: A validated nómina can be replaced once, until its due date, and only if nothing has been paid and no declaración jurada de no pago was filed. Deducciones cannot share a .zip with nóminas or rectificativas.
- **The Certificado Común lasts 180 days**: It is valid for 180 calendar days from the day after issue and carries an electronic signature. You can opt in to automatic renewal. The timbre profesional fee is added to your next obligations factura under code 113.

## 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)
- [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)
- [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: [ZATCA e-Services](/automate/zatca-e-services), [Prozorro](/automate/prozorro), [Guichet unique des formalités d'entreprises](/automate/guichet-unique-des-formalites-d-entreprises), [Odyssey File & Serve](/automate/odyssey-file-and-serve), [Barclays Mortgage Hub](/automate/barclays-mortgage-hub), [EFTPS](/automate/eftps).

## Frequently asked questions

### Does BPS Servicios en Línea have an API?

Not one that BPS documents: its guides for employers describe no API. You type declarations into Declaración nominada or send files made with ATYRO or your own software in BPS's published format. Obligations, facturas and certificates are browser services. With Fous you can build methods that read them and return JSON.

### How do I know whether my nómina was accepted?

Look at Resultado de envíos in Declaración nominada. Each envío shows its state and a result: Ok, Ok/Observaciones, Con Errores or Acceso Denegado, with links to the errors, the factura and any multas or notificaciones. You can filter by date range and declaration type.

### Can I file a nómina late online?

Yes, up to two months after the due date, or up to four months for rural companies, according to BPS's page on presenting declaraciones nominadas. Late filing brings the sanctions BPS lists. Due dates are in BPS's contribution calendar.

### How can I check whether a supplier has a valid Certificado Común?

Use Consultar vigencia del certificado común, which needs only the RUT. A Certificado Común is valid for 180 days from the day after it is issued. A workflow can check a list of RUTs on a schedule and email you the ones whose status changed.

### Is Fous affiliated with Banco de Previsión Social?

No. Fous is an independent product. You use it with your own usuario personal BPS, 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 BPS Servicios en Línea (Banco de Previsión Social (BPS)). 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.