Turn the SUIR into an API

What you can build on the SUIR

• Get TSS payment notices

  Build this

  Reads Consultas > Estado de Cuenta (account statement) for the status you choose, and opens each notice's reference number and its Detalle empleados (detail by employee).

  Takes

  Notification status (optional), period (optional)

  Returns

  Reference number, period, status, total due, workers in Detalle empleados

• Read a payroll's workers

  Build this

  Reads Consultas > Consulta de Nóminas (payroll lookup) and opens Detalle for the nómina you name, listing the workers registered in it.

  Takes

  Payroll key or name

  Returns

  Payroll key, payroll name, worker name, document type, document number, salario cotizable

• Check file submissions

  Build this

  Reads Gestión de archivos > Consulta de envíos (submission lookup) and, for a rejected envío, opens its number for the reason.

  Takes

  Sent since (optional)

  Returns

  Submission number, process type, sent date, status, valid records, rejection reason

• Report a worker's exit

  Build this

  Fills in Novedades > Salida de trabajadores (worker exits) for one worker in the nómina you name and applies the novedad.

  Takes

  Payroll, cédula, exit date, salario cotizable, tipo de ingreso

  Returns

  Cédula, worker name, payroll, exit date, confirmation message

Automate the SUIR 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.

• New TSS payment notice, before the payment deadline

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Get the TSS payment notices from the Estado de Cuenta.

  Step 2

  Keep the notices that were not there on the last run.

  Step 3

  Email you each one with its reference number, period, status and total due.

• Rejected file submissions, with the reason

  Build this

  Starts

  Every weekday at 16:00

  Step 1

  Check the file submissions in Consulta de envíos sent since yesterday.

  Step 2

  Keep the envíos that were rejected.

  Step 3

  Post each one, with its process type and rejection reason, to your payroll system's webhook.

• Payroll changes since last month, before you pay

  Build this

  Starts

  Monthly on the 21st at 9:00

  Step 1

  For each payroll you name, read its workers in Consulta de Nóminas.

  Step 2

  Keep the workers who are new, gone or have a changed salario cotizable since the last run.

  Step 3

  Email you the list, one section per payroll, to check against your own records.

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 TSS payment notices” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "suir.gob.do/get_payment_notices",
    "input": {
      "status": "Vigente"
    }
  }'

{
  "status": "completed",
  "data": {
    "employer": "Acme Distribuidora SRL",
    "notices": [
      {
        "reference_number": "4821-0937-1156-2208",
        "period": "2026-10",
        "status": "Vigente",
        "total_due": 214860.35,
        "currency": "DOP",
        "employees": [
          {
            "name": "Ana Martínez",
            "document_number": "00100000001",
            "salario_cotizable": 58000
          }
        ],
        "employee_count": 18
      }
    ],
    "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 SUIR’s own options

The TSS does not publish an API for employers. Payroll changes go in through the SUIR itself, typed one worker at a time or uploaded as a .TXT file generated from the TSS's Excel templates. Notices, payrolls and certificates are read on the SUIR's screens, which are open 24 hours a day, 7 days a week.

Read on November 12, 2026: TSS Guía de Usuario 2026, Instructivo novedades interactivas y plantilla de autodeterminación, Instructivo seguridad de acceso al SUIR y uso de la CLASS.

Signing in to the SUIR

The SUIR signs in a representative with the employer's RNC or cédula, the representative's own document number and their CLASS. Sensitive options, such as Envío de archivo and Mantenimiento de nóminas, ask for a code by text message first. With Fous you sign in once through the SUIR'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

The CLASS expires every 45 days

The SUIR warns you from 15 days before. If the CLASS is not changed in time, the user is blocked until it is recovered. More than five wrong attempts block access for 24 hours.

Notices from the 20th, payment by the 3rd

The notificación de pago is generated from the 20th of each month and is due by the third working day of the next month. A late payment adds a 0.3% surcharge plus the CCI return rate.

Not every representative sees the notice

A representante normal cannot see the notificación de pago, and an administrador must have the nómina assigned to see it. Sign in with an account that has the payrolls you need.

Upload the .TXT, then check the envío

The SUIR takes the .TXT file the template generates, not the Excel file. Consulta de envíos shows whether each envío was processed or rejected, and its number opens the rejection reason.

More in Government: Latin America

• Mis Comprobantes
• Facturación Electrónica DIAN
• Simplificación Registral
• ARCA - servicios con Clave Fiscal
• Portal Empresarial INFONAVIT
• SIFERE Web
• Declaración en Línea (F.931)
• AFPnet
• ARBA
• SEACE
• SECOP II
• BPS Servicios en Línea
• IESS - Portal de Empleadores
• Oficina Virtual CCSS (SICERE)
• Previred
• Aportes en Línea
• SOI
• SIPARE
• DGI Servicios en Línea
• e-Tax 2.0
• Agencia Virtual SAT
• Oficina Virtual DGII
• Portal del SAT (Factura Electrónica)
• SII (Mi SII)
• SRI en Línea
• SUNAT Operaciones en Línea (SOL)
• TRIBU-CR
• Declaraciones y Pagos (SAT)
• DIAN MUISCA

Other industries: Mudad, PUE ZUS, Chorus Pro, Texas811 Portal, NatWest Intermediary Solutions, HUD Secure Systems.