DIAN Events (030-034) & RADIAN Circulation (035-044)

DIAN Events & RADIAN (Factoring)

JCFlow provides full support for incoming credit invoices and their constitution as negotiable securities in the DIAN RADIAN system. Issue the 3 mandatory events for tax deductibility and manage electronic endorsements for factoring.

3 Mandatory Events

030 (Acknowledgment), 032 (Goods Receipt), and 033/034 (Acceptance) required by DIAN.

RADIAN Title Registration (035)

Registers invoices in DIAN official registry for free negotiation and liquidity.

Endorsements & Legitimate Holder

Endorsements in property (036), guarantee (037) and real-time history tracking.

1. Incoming Vendor Invoices Event Flow

For credit purchases to be tax-deductible in income tax and VAT, the buyer must register these events in sequence:

POST/v1/api/eventos/cargar-documento

Uploads the XML of an incoming invoice to initiate the validation cycle.

POST/v1/api/eventos/acuse-recibo

Event 030 — Electronic Invoice Receipt Acknowledgment.

POST/v1/api/eventos/recibo-bien

Event 032 — Receipt of Goods or Services Rendered.

POST/v1/api/eventos/aceptacion-expresa

Event 033 — Express Acceptance of invoice by buyer.

POST/v1/api/eventos/aceptacion-tacita

Event 034 — Tacit Acceptance (by issuer after 3 business days without dispute).

POST/v1/api/eventos/reclamo

Event 031 — Dispute/Rejection against the invoice.

Parameters for Acknowledgment / Goods Receipt

Field	Type	Required	Description
cufe	string	Yes	CUFE of the vendor electronic invoice
id_empresa	integer	No	Recipient company ID (or inferred from API Key)
notes	string	No	Additional acknowledgment notes or remarks

Parameters for Invoice Dispute

Field	Type	Required	Description
cufe	string	Yes	CUFE of the invoice to dispute
motivo	string	Yes	01 = Undelivered doc, 02 = Undelivered goods, 03 = Non-compliant goods, 04 = Unrendered service
notes	string	No	Detailed explanation for the commercial rejection

Request Example — Receipt Acknowledgment

CURL

curl -X POST "https://api.jcflow.com.co/v1/api/eventos/acuse-recibo" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk_test_tu_api_key_aqui" \
  -d '{
    "cufe": "a7c8e9f0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef012345678",
    "notes": "Acuse de recibo conforme de la factura FEV-492"
  }'

Successful Response

JSON

{
  "success": true,
  "message": "Evento 030 (Acuse de Recibo) emitido y validado exitosamente ante DIAN",
  "data": {
    "cufe": "a7c8e9f0123456789abcdef0123456789abcdef...",
    "codigo_evento": "030",
    "nombre_evento": "Acuse de recibo de Factura Electrónica de Venta",
    "cude_evento": "cude_del_evento_radian_emitido_dian_9876543210...",
    "fecha_evento": "2026-08-29T12:00:00-05:00",
    "estado_dian": "Aceptado"
  }
}

Try EndpointPOST /eventos/acuse-recibo

Your API Key

Request Body (JSON)

2. Electronic Factoring & Circulation in RADIAN

Once a credit invoice receives the 3 mandatory events (030, 032, 033/034), it becomes a negotiable security title and can circulate in secondary markets via electronic endorsements.

GET/v1/api/radian/facturas-elegibles

Lists invoices with all 3 events ready to be registered or traded in RADIAN.

POST/v1/api/radian/registrar-evento

Registers a RADIAN circulation event (035 Title Registration, 036 Property Endorsement, 037 Guarantee, 038 Procurement).

GET/v1/api/radian/hoja-de-vida/:cufe

Queries full chronological history of endorsements and the current Legitimate Title Holder.

Parameters for RADIAN Endorsement

Field	Type	Required	Description
cufe	string	Yes	CUFE of the invoice registered as a security title
codigo_evento	string	Yes	036 = Endorsement in Property, 037 = Endorsement in Guarantee, 038 = Endorsement in Procurement
endosatario	object	Yes	Data of the financial entity or Fintech receiving the title
condiciones_financieras	object	No	Discount rate, disbursed value, agreed maturity date
observaciones	string	No	Reference to factoring or assignment agreement

Property Endorsement Example (Factoring)

CURL

curl -X POST "https://api.jcflow.com.co/v1/api/radian/registrar-evento" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk_test_tu_api_key_aqui" \
  -d '{
    "cufe": "a7c8e9f0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef012345678",
    "codigo_evento": "036",
    "endosatario": {
      "tipo_documento": "31",
      "numero_documento": "900987654",
      "dv": "8",
      "nombre": "Fintech Factor Liquidez Colombia S.A.S.",
      "calidad_tenedor": "ENDOSATARIO_EN_PROPIEDAD"
    },
    "condiciones_financieras": {
      "valor_nominal_factura": 45000000,
      "porcentaje_anticipo": 90,
      "valor_desembolsado": 40500000,
      "tasa_descuento_mensual": 1.45,
      "fecha_vencimiento_pago": "2026-10-15"
    },
    "observaciones": "Endoso en propiedad según contrato de factoring marco No. 2026-FT-089"
  }'