# Get your DIAN received invoices through an API

> Read your Documentos recibidos, Documentos enviados and the RADIAN events on each factura electrónica with one API call. A workflow can pass each morning's new supplier invoices to accounts payable and list the sales invoices still without an Acuse de recibo.

Page: https://fous.com/automate/facturacion-electronica-dian
Updated: 2026-11-12

Works with your own Facturación Electrónica DIAN account. Fous is an independent product.

## What you can build on the Sistema FE

### Get received documents

Reads Histórico > Documentos recibidos (received documents) in the Catálogo for a date range, with each document's CUFE and Estado RADIAN.

- Takes: Date range, tipo de documento (optional)
- Returns: CUFE, prefix and folio, document type, issuer NIT, issuer name, issue date, total, Estado RADIAN

### Get the RADIAN events on an invoice

Searches a factura electrónica by CUFE or prefix and folio and reads its Estado RADIAN and the list under Eventos de la factura electrónica.

- Takes: CUFE, or prefix and folio
- Returns: CUFE, Estado RADIAN, events with name and date

### List sent invoices without an Acuse de recibo

Reads Histórico > Documentos enviados (sent documents) for a date range and marks which invoices the buyer has not yet given an Acuse de recibo de la FEV.

- Takes: Date range
- Returns: CUFE, prefix and folio, buyer NIT, issue date, total, acuse de recibo received

### Register Acuse de recibo on a received invoice

In the Solución Gratuita, opens Histórico > Documentos recibidos, selects the invoice and associates the Acuse de recibo de la FEV event.

- Takes: CUFE, or prefix and folio
- Returns: CUFE, event, event date, Estado RADIAN

## Automate the Sistema FE 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 supplier invoices to accounts payable

Starts: Every weekday at 7:00, Bogotá time

1. Get the Documentos recibidos of the last seven days.
2. Keep the documents that were not there on the last run.
3. Post each one, with CUFE, prefix and folio, issuer NIT, issue date and total, to your ERP webhook.

### Sent invoices still waiting for an Acuse de recibo

Starts: Every weekday at 9:00, Bogotá time

1. List the Documentos enviados of the last 30 days without an Acuse de recibo de la FEV.
2. Stop when there are none.
3. Email you the list, grouped by buyer NIT, with prefix and folio, issue date and total.

### RADIAN status changes on open credit invoices

Starts: Every Monday at 8:00, Bogotá time

1. For each CUFE on your list, get the Estado RADIAN and the events of the invoice.
2. Keep the invoices whose events changed since the last run.
3. Post CUFE, Estado RADIAN and the new events to your 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 received documents” 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": "catalogo-vpfe.dian.gov.co/get_received_documents",
    "input": {
      "from": "2026-11-09",
      "to": "2026-11-11",
      "document_type": "Factura electrónica"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "documents": [
      {
        "cufe": "a3f9c2e17b0d4e8a9c51f2d6b7e04a1c88d3e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
        "prefix": "NW",
        "folio": "48213",
        "document_type": "Factura electrónica",
        "issuer_nit": "900123456",
        "issuer_name": "Northwind Suministros S.A.S.",
        "issue_date": "2026-11-10",
        "total": 4876500,
        "estado_radian": "Acuse de recibo de la FEV"
      }
    ],
    "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 Sistema FE’s own options

DIAN offers SOAP web services that receive facturas electrónicas, notes and events from software that has passed its set de pruebas, plus Envíos por lote asíncrono (asynchronous batch sending) set up under Configuración. Without your own software you can use a proveedor tecnológico or DIAN's free Solución Gratuita. Reviewing sent and received documents is done in the Catálogo, with lists downloaded as .xlsx.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Validación previa web services (SOAP) | Transmit facturas electrónicas, notas débito and crédito and other documents to DIAN for validation; Envíos por lote asíncrono under Configuración. | Software propio enabled by a set de pruebas (2 invoices, 1 debit note, 1 credit note) and a valid X.509 certificate from an ONAC-authorized entity. |
| Proveedor tecnológico | A technology provider's software issues and transmits your documents. | Selected as your modo de operación in Registro y Habilitación. |
| Solución Gratuita DIAN | Issue factura electrónica de venta, nómina electrónica and documento soporte, and register RADIAN events on received invoices. | Free. A free digital certificate valid for one year, requested from the habilitación environment. |
| The Catálogo by hand | Histórico: Documentos enviados, Documentos recibidos and Descarga de listados (.xlsx); RADIAN search by CUFE and the Certificado de existencia. | Registration in the RUT and a sign-in as Empresa (Representante legal) or Persona. |

Read on November 12, 2026: [Nuevo diseño del Sistema de Facturación Electrónica (DIAN)](https://www.dian.gov.co/impuestos/factura-electronica/Documents/Nuevo-Diseno-Sistema-de-Facturacion-Electronica.pdf), [Registro y selección del modo de operación (DIAN)](https://www.dian.gov.co/impuestos/factura-electronica/Documents/Registro-y-Seleccion-del-Modo-de-Operacion-Factura-Electronica.pdf), [Conocimientos requeridos VP Fac-e (DIAN)](https://www.dian.gov.co/impuestos/factura-electronica/Documents/Conocimientos_requeridos_vp_face.pdf).

## Signing in to the Sistema FE

You enter the Sistema FE as Empresa (Representante legal) or as Persona, and DIAN sends a Token Acceso DIAN to the email address registered in the RUT: a link with a time limit that opens the system. With Fous you sign in once through DIAN's own sign-in with your own account, the login is sealed with AES-256, the emailed sign-in link is handled, and an expired session is signed back in.

## Worth knowing

- **Habilitación and Producción are separate**: The Sistema FE has two environments. Documents in Habilitación are tests; only Producción has fiscal value, and documents made in the Solución Gratuita are kept separately in each.
- **Events go in a fixed order**: Acuse de recibo de la FEV comes first, then Recibo del bien o prestación del servicio, then Aceptación expresa or Reclamo. Reclamo and acceptance apply only to invoices on credit.
- **Accepted invoices take no more notes**: Once an invoice is accepted, expressly or tacitly, no debit or credit note can be applied to it. If the buyer registers neither acceptance nor Reclamo within three days, the issuer may register Aceptación tácita.
- **Events need their own setup**: To register events in the Solución Gratuita you need an active digital certificate and a manual numbering range for each event type, created in Producción.

## More in Government: Latin America

- [Mis Comprobantes](https://fous.com/automate/mis-comprobantes.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)
- [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: [CIPC eServices](/automate/cipc-eservices), [EUDR Information System](/automate/eudr-information-system), [Companies House WebFiling](/automate/companies-house-webfiling), [Texas811 Portal](/automate/texas811-portal), [Mercury Network](/automate/mercury-network), [FINRA Gateway](/automate/finra-gateway).

## Frequently asked questions

### Does Facturación Electrónica DIAN have an API?

Yes, for transmitting documents: DIAN's SOAP web services take facturas electrónicas, notes and events from software that has passed the set de pruebas and holds a valid X.509 certificate. Reviewing what you sent and received is done in the Catálogo under Histórico, with lists downloaded as .xlsx.

### How do I see the invoices issued to my company?

Open Histórico > Documentos recibidos in the Catálogo. Descarga de listados gives the documents as an .xlsx file. With Fous, a method you build reads the same list and returns it as JSON, and a workflow can post new documents to your ERP's webhook each morning.

### How do I check the RADIAN events on a factura electrónica?

In Histórico, search it by CUFE, prefix and folio, NIT receptor, date range, document type, result or Estado RADIAN, open the result and look under Eventos de la factura electrónica. The Certificado de existencia lists every event associated with the invoice.

### When does a factura electrónica become a título valor?

When it has the events Acuse de recibo de la FEV, Recibo del bien o prestación del servicio, and Aceptación expresa or tácita associated. Reclamo and acceptance apply only to invoices with a credit negotiation type.

### Is Fous affiliated with DIAN?

No. Fous is an independent product. You use it with your own Sistema FE access, 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 Facturación Electrónica DIAN (Dirección de Impuestos y Aduanas Nacionales (DIAN)). 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.