# Turn the DGII Oficina Virtual into an API

> Read Deudas pendientes (outstanding taxes), Declaraciones (filed returns) and Estatus de Solicitudes (request status) from the Oficina Virtual with one API call each. Or have a workflow check them every Monday and email you any new debt.

Page: https://fous.com/automate/oficina-virtual-dgii
Updated: 2026-11-12

Works with your own Oficina Virtual DGII account. Fous is an independent product.

## What you can build on the Oficina Virtual

### Get pending taxes

Reads Deudas pendientes under Consultas: the summary of taxes your RNC has not yet paid.

- Takes: Nothing
- Returns: Tax, form, period, amount owed, total

### List filed returns

Reads Declaraciones under Consultas: the returns presented since your obligations began, filtered to the tax and periods you ask for.

- Takes: Tax (optional), from period, to period
- Returns: Form, tax, period, filing date, amount

### Check request statuses

Reads Estatus de Solicitudes under Consultas: the requests you made in the Oficina Virtual, at local offices or at head office.

- Takes: Submitted since (optional)
- Returns: Request number, request type, date, status

### Request a compliance certificate

Opens Solicitar certificaciones and requests the Cumplimiento de Obligaciones Fiscales certificate (tax compliance certificate) for your RNC.

- Takes: Purpose or addressee (optional)
- Returns: Request number, certificate type, submitted date, status

## Automate the Oficina Virtual 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.

### New items in Deudas pendientes, every Monday

Starts: Every Monday at 8:00, Santo Domingo time

1. Get the pending taxes from Deudas pendientes.
2. Keep the items that were not there on the last run.
3. Email you each new item with its tax, form, period and amount owed.

### Changes in Estatus de Solicitudes, posted to your system

Starts: Every weekday at 9:00, Santo Domingo time

1. Check Estatus de Solicitudes for requests submitted in the last 90 days.
2. Keep the requests whose status changed since the last run.
3. Post request number, type, date and status to your webhook.

### Last month's Declaraciones, handed to accounting

Starts: On the 1st of every month at 8:00, Santo Domingo time

1. List the returns in Declaraciones for the last three periods.
2. Keep the returns with a filing date in the previous month, and stop when there are none.
3. Post form, tax, period, filing date and amount to your accounting system's webhook.

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 taxes” 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": "dgii.gov.do/get_pending_taxes",
    "input": {}
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "pending": [
      {
        "tax": "ITBIS",
        "form": "IT-1",
        "period": "2026-09",
        "amount_owed": 53606
      },
      {
        "tax": "Retenciones asalariados",
        "form": "IR-3",
        "period": "2026-10",
        "amount_owed": 12400
      }
    ],
    "currency": "DOP",
    "total": 66006
  }
}
```

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 Oficina Virtual’s own options

DGII publishes REST web services for electronic fiscal receipts (e-CF) only: sending e-CF, checking their result and status, voiding e-NCF and similar. They need a digital certificate and are used by taxpayers certified as electronic issuers. Your tax account, returns and formatos de envío are handled in the Oficina Virtual, which DGII offers free.

| Option | What it covers | What it takes |
| --- | --- | --- |
| e-CF web services | Autenticación, Recepción de e-CF, Consulta de resultado and Consulta de estado, Anulación de e-NCF, Consulta Directorio and Consulta timbre. | Certification as an Emisor Electrónico and a digital certificate to sign the Semilla. Each token lasts 1 hour. |
| Herramientas de Pre-validación | Downloadable tools that validate data files, such as Envío de Datos and Formato 656, before you send them. | A download from dgii.gov.do. The validated file is then sent through the Oficina Virtual. |
| The Oficina Virtual by hand | Consultas such as Cuenta Corriente, Deudas pendientes and Declaraciones, Formatos de Envío de Datos, returns, NCF requests and certificates. | Free. Your RNC or Cédula, a Clave and a security device. |

Read on November 12, 2026: [Documentación sobre e-CF](https://dgii.gov.do/cicloContribuyente/facturacion/comprobantesFiscalesElectronicosE-CF/Paginas/documentacionSobreE-CF.aspx), [Servicios de la Oficina Virtual (cartilla)](https://dgii.gov.do/publicacionesOficiales/bibliotecaVirtual/contribuyentes/oficinaVirtual/Documents/1-Cartilla%20Oficina%20Virtual.pdf), [Herramientas de Pre-validación](https://www.dgii.gov.do/herramientas/formularios/pre-validacion/Paginas/default.aspx).

## Signing in to the Oficina Virtual

The Oficina Virtual asks for your RNC or Cédula as Usuario and your Clave, then a code from your security device: a Tarjeta de Códigos, a Token (Grandes Contribuyentes only) or the Token Digital in the DGII Móvil app. With Fous you sign in through the Oficina Virtual's own sign-in with your own account. The login is sealed with AES-256 and never returned by the API or written to logs.

## Worth knowing

- **One account per RNC**: The Usuario is the taxpayer's RNC or Cédula, so each company you file for signs in with its own Usuario and Clave.
- **One security device at a time**: Adding a Token Digital disables any Tarjeta de Códigos or Token already linked to the account. After a password change, an account with no device must activate a Token Digital.
- **Your 606 can be read back**: Gastos NCF and Consulta Envíos 606 under Consultas show the expenses reported through the 606, so a method you build can check what DGII has on file against your own books.
- **e-CF starts in a test environment**: The e-CF services run in Pre-Certificación, where sends are kept 60 days, then Certificación, then Producción, where every send has fiscal validity.

## 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)
- [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: [KRA iTax](/automate/kra-itax), [Telemaco](/automate/telemaco), [Guichet unique des formalités d'entreprises](/automate/guichet-unique-des-formalites-d-entreprises), [eFileTexas](/automate/efiletexas), [AgentTRAX](/automate/agenttrax), [IRS e-Services](/automate/irs-e-services).

## Frequently asked questions

### Does Oficina Virtual DGII have an API?

Only for electronic fiscal receipts. DGII's e-CF web services send e-CF, return their result and status and void e-NCF, for certified electronic issuers with a digital certificate. Cuenta Corriente, Declaraciones and the formatos de envío are only in the Oficina Virtual.

### Where do I see what I owe DGII?

In Deudas pendientes under Consultas, which summarizes the taxes pending payment. Cuenta Corriente shows the state of each tax obligation, and Autorizaciones de Pago lists current, expired and used payment authorizations.

### How do I check that DGII received my 606?

Open Consulta Envíos 606 or Gastos NCF under Consultas: both show the expenses reported through the Formato de Envío de Compras de Bienes y Servicios (606). Documentos shows the annexes and returns you presented.

### Where do I follow an NCF request?

Solicitudes Comprobantes lists the NCF requests you made, and Estatus de Solicitudes shows the status of requests made in the Oficina Virtual, at local offices or at head office.

### Is Fous affiliated with the Dirección General de Impuestos Internos?

No. Fous is an independent product. You use it with your own Oficina Virtual 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 Oficina Virtual DGII (Dirección General de Impuestos Internos (DGII)). 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.