Get your DIAN received invoices through an API

What you can build on the Sistema FE

• Get received documents

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

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

  Build this

  Starts

  Every weekday at 7:00, Bogotá time

  Step 1

  Get the Documentos recibidos of the last seven days.

  Step 2

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

  Step 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

  Build this

  Starts

  Every weekday at 9:00, Bogotá time

  Step 1

  List the Documentos enviados of the last 30 days without an Acuse de recibo de la FEV.

  Step 2

  Stop when there are none.

  Step 3

  Email you the list, grouped by buyer NIT, with prefix and folio, issue date and total.

• RADIAN status changes on open credit invoices

  Build this

  Starts

  Every Monday at 8:00, Bogotá time

  Step 1

  For each CUFE on your list, get the Estado RADIAN and the events of the invoice.

  Step 2

  Keep the invoices whose events changed since the last run.

  Step 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, 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.

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"
    }
  }'

{
  "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.

Read on November 12, 2026: Nuevo diseño del Sistema de Facturación Electrónica (DIAN), Registro y selección del modo de operación (DIAN), Conocimientos requeridos VP Fac-e (DIAN).

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
• 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)
• SUIR
• 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: CIPC eServices, EUDR Information System, Companies House WebFiling, Texas811 Portal, Mercury Network, FINRA Gateway.