Skip to content

FousBPS Servicios en Línea

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.

Start building freeBook a demo

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

    Build this

    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

    Build this

    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

    Build this

    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

    Build this

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

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

  • Pending BPS obligations, every week

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

  • Certificado Común changes on your list of RUTs

    Build this
    Starts
    Every weekday at 9:00
    Step 1
    For each RUT on your list, check its Certificado Común with Consultar vigencia del certificado común.
    Step 2
    Keep the RUTs whose answer changed since the last run.
    Step 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, 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.

OptionWhat it coversWhat it takes
Envío de archivo in Declaración nominadaSends 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 declaracionesATYRO 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 handDeclaració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), Medios para generar nóminas, rectificativas y deducciones, Servicios en línea para empresas.

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

Other industries: ZATCA e-Services, Prozorro, Guichet unique des formalités d'entreprises, Odyssey File & Serve, Barclays Mortgage Hub, EFTPS.

Frequently asked questions

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.

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.

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.

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.

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.

Put BPS Servicios en Línea 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 nextIESS - Portal de EmpleadoresOficina Virtual CCSS (SICERE)SUIRZATCA e-ServicesHow methods workHow workflows run

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.