# Get your TRIBU-CR declarations and tax account by API

> Read your Declaraciones pendientes, the declarations you have filed and the Deuda pendiente in your Cuenta tributaria with one API call each. Or have a workflow check every taxpayer you represent each Monday and email you what is due.

Page: https://fous.com/automate/tribu-cr
Updated: 2026-11-12

Works with your own TRIBU-CR account. Fous is an independent product.

## What you can build on TRIBU-CR

### Get pending declarations

Reads the Pendientes tab under Declaraciones for one taxpayer: each form still to file, its period, its filing window and whether a Borrador (draft) exists.

- Takes: Taxpayer identification, declaration name (optional)
- Returns: Period, type, declaration, filing window start and end, status

### List filed declarations

Reads the Realizadas tab under Declaraciones, filtered by declaration name, type, period, status or Pagada (paid), and returns each declaration filed.

- Takes: Taxpayer identification, period, declaration name (optional), paid (optional)
- Returns: Declaration number, period, type, declaration, filing window, status, paid

### Read the Cuenta tributaria

Reads the Cuenta tributaria (tax account) for one taxpayer, under Deuda pendiente (amounts owed), Créditos disponibles (credits) or Cancelados (paid).

- Takes: Taxpayer identification, balance type
- Returns: Period, tax, amount, status, balance type

### Pay a pending debt from a registered account

Opens Pagar, selects one declaration's debt, sets the amount, chooses Pago con cuenta IBAN and the bank account, and confirms with Pagar.

- Takes: Taxpayer identification, declaration and period, amount (optional), IBAN account
- Returns: Declaration, period, amount paid, payment status

## Automate TRIBU-CR 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.

### Declarations due in the next 14 days, for each taxpayer

Starts: Every Monday at 7:00 in Costa Rica time

1. For each taxpayer you name, get the pending declarations from the Pendientes tab.
2. Keep the rows whose filing window ends within the next 14 days.
3. Email you the list, one section per taxpayer, with declaration, period and deadline.

### New Deuda pendiente, posted to your accounting system

Starts: Every weekday at 8:00 in Costa Rica time

1. For each taxpayer, read the Deuda pendiente tab of the Cuenta tributaria.
2. Keep the debts that were not there on the last run.
3. Post each one, with period, tax and amount, to your accounting system's webhook.

### VAT filing check after the monthly deadline

Starts: Every month on the 16th at 9:00 in Costa Rica time

1. For each taxpayer, list the filed declarations for last month's period.
2. Keep the taxpayers with no 150 - Impuesto al valor agregado declaration, or one not marked as paid.
3. Email you the taxpayers to follow up, with status and paid flag.

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 pending declarations” 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": "ovitribucr.hacienda.go.cr/get_pending_declarations",
    "input": {
      "taxpayer_id": "3101000000"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "taxpayer_id": "3101000000",
    "taxpayer_name": "Northwind Servicios S.A.",
    "declarations": [
      {
        "period": "202610",
        "type": "Autoliquidativa Original",
        "declaration": "150 - Impuesto al valor agregado",
        "window_start": "2026-11-01",
        "window_end": "2026-11-15",
        "status": null
      }
    ],
    "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.

## TRIBU-CR’s own options

Hacienda documents an API for comprobantes electrónicos: it receives signed invoices and receiver responses, reports their status and lists the comprobantes you have sent. Declarations, the Cuenta tributaria and payments are not part of it: you work with them in the Oficina Virtual (OVi).

| Option | What it covers | What it takes |
| --- | --- | --- |
| API de Comprobantes Electrónicos | Sends signed comprobante XML and receiver responses, returns each one's status (recibido, procesando, aceptado, rechazado, error) and lists sent comprobantes. | An OpenID Connect token sent as a bearer token, and comprobantes signed as XML. |
| Consulta pública de situación tributaria | A public check by cédula: identification data, compliance with payments and filing, método de facturación, obligations and economic activities. | No sign-in: the identification number and the code shown in an image. |
| The Oficina Virtual by hand | Declaraciones (Pendientes, Realizadas, Rectificar), Cuenta tributaria, Pagar, Buzón electrónico, Mis datos and Registro tributario. | An OVi user for each person, acting as Titular, Representante Legal or Autorizado. Payment by DTR from a registered IBAN account. |

Read on November 12, 2026: [API de Comprobantes Electrónicos](https://www.hacienda.go.cr/docs/ComprobantesElectronicosAPI.html), [Guías rápidas paso a paso para OVi y TRIBU-CR](https://www.hacienda.go.cr/docs/cGuiasRapidasPasoAPasoParaOViyTRIBU-CR.pdf), [TRIBU-CR at Ministerio de Hacienda](https://www.hacienda.go.cr/TRIBU-CR.html).

## Signing in to TRIBU-CR

On the Ingrese a su OVi screen you sign in with Usuario y contraseña (your identification and password) and a validation code sent to your registered email and mobile phone, or with Firma digital. With Fous you sign in once through TRIBU-CR's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Users are people, companies act through them**: An OVi user is created once by a natural person, who enters as Titular, Representante Legal or Autorizado. A titular grants an autorizado chosen services, and the autorizado picks the taxpayer's profile after signing in.
- **The password lasts 6 months**: A TRIBU-CR password has at least 14 characters, cannot repeat any of the last three, and is valid for 6 months. Plan for the renewal so scheduled runs keep working.
- **Filed declarations are corrected, not deleted**: A filed declaration cannot be deleted: you file a declaración rectificativa with Rectificar. Forms are saved as Borrador automatically and wait in Pendientes until you press Presentar.
- **Payment is by DTR only**: Débito en Tiempo Real, from a bank account registered in the OVi, is the only payment method there. A partial payment has to cover at least the legal interest, when it applies.

## 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)
- [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)
- [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), [UETS](/automate/uets), [net-entreprises.fr](/automate/net-entreprises-fr), [Texas811 Portal](/automate/texas811-portal), [Mercury Network](/automate/mercury-network), [NetDMR](/automate/netdmr).

## Frequently asked questions

### Does TRIBU-CR have an API?

Only for comprobantes electrónicos. Hacienda's API receives signed invoices and receiver responses, reports their status and lists sent comprobantes, with an OpenID Connect bearer token. Declarations, the Cuenta tributaria and payments are handled in the Oficina Virtual.

### How do I prove a declaration was filed?

Download the acuse de recibido or the declaration itself. Both are generated when you press Presentar, and the Descargar declaración button gives the filed form as a PDF.

### Can an accountant manage several companies with one OVi user?

Yes, as an Autorizado. Each titular or legal representative authorizes you under ¿Quién puede realizar trámites en mi nombre?, you accept by email, and you choose the taxpayer's profile after signing in. A workflow you build in Fous can loop over those taxpayers and run the same method for each.

### Where do I see what a company owes Hacienda?

In the Cuenta tributaria, under Deuda pendiente. Créditos disponibles shows balances in your favour and Cancelados shows the taxes paid and their payment receipts. Pending debts also appear on the OVi's main screen.

### Is Fous affiliated with the Ministerio de Hacienda?

No. Fous is an independent product. You use it with your own TRIBU-CR 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 TRIBU-CR (Ministerio de Hacienda). 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.