Eventos DIAN (030-034) & Circulación RADIAN (035-044)

Eventos DIAN y RADIAN (Factoring)

La plataforma JCFlow ofrece cobertura completa para la recepción de facturas electrónicas a crédito y su constitución en título valor negociable en el sistema RADIAN de la DIAN. Permite emitir los 3 eventos obligatorios para deducción fiscal y operar endosos electrónicos para factoring.

3 Eventos Obligatorios

030 (Acuse), 032 (Recibo Bien) y 033/034 (Aceptación Expresa o Tácita) exigidos por la DIAN.

RADIAN Título Valor (035)

Inscribe facturas en el registro oficial de la DIAN para libre negociación y liquidez.

Endosos & Tenedor Legítimo

Endosos en propiedad (036), garantía (037) y consulta de hoja de vida en tiempo real.

1. Ciclo de Recepción de Facturas de Proveedores

Para que las compras a crédito sean deducibles de renta e IVA descontable, el adquiriente debe registrar estos eventos en orden:

POST/v1/api/eventos/cargar-documento

Carga el XML de una factura recibida para iniciar el ciclo de validación.

POST/v1/api/eventos/acuse-recibo

Evento 030 — Acuse de recibo de la Factura Electrónica de Venta.

POST/v1/api/eventos/recibo-bien

Evento 032 — Recibo del bien o prestación del servicio.

POST/v1/api/eventos/aceptacion-expresa

Evento 033 — Aceptación expresa de la factura por parte del comprador.

POST/v1/api/eventos/aceptacion-tacita

Evento 034 — Aceptación tácita (por el emisor tras 3 días hábiles sin reclamo).

POST/v1/api/eventos/reclamo

Evento 031 — Reclamo contra la factura (rechazo por inconformidad o no entrega).

Parámetros para Emitir Acuse / Recibo de Bien

Campo	Tipo	Requerido	Descripción
cufe	string	Sí	CUFE de la factura electrónica del proveedor
id_empresa	integer	No	ID de la empresa receptora (o inferida de la API Key)
notes	string	No	Observaciones o notas adicionales del acuse

Parámetros para Reclamo (Rechazo)

Campo	Tipo	Requerido	Descripción
cufe	string	Sí	CUFE de la factura a reclamar
motivo	string	Sí	01 = Documento no entregado, 02 = Mercancía no entregada, 03 = Mercancía no cumple, 04 = Servicio no prestado
notes	string	No	Detalle explicativo del rechazo comercial

Ejemplo de Petición — Acuse de Recibo

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

Respuesta Exitosa

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

Probar EndpointPOST /eventos/acuse-recibo

Tu API Key

Request Body (JSON)

2. Circulación y Factoring Electrónico en RADIAN

Una vez una factura a crédito tiene los 3 eventos obligatorios (030, 032, 033/034), queda constituida como Título Valor y puede circular en el mercado secundario mediante endosos electrónicos.

GET/v1/api/radian/facturas-elegibles

Lista las facturas que ya tienen los 3 eventos y están listas para inscribir o negociar en RADIAN.

POST/v1/api/radian/registrar-evento

Registra un evento de circulación RADIAN (035 Registro, 036 Endoso en Propiedad, 037 Garantía, 038 Procuración).

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

Consulta la trazabilidad cronológica de todos los endosos y el Tenedor Legítimo actual del título.

Parámetros para Endoso en RADIAN

Campo	Tipo	Requerido	Descripción
cufe	string	Sí	CUFE de la factura inscrita como título valor
codigo_evento	string	Sí	036 = Endoso en Propiedad, 037 = Endoso en Garantía, 038 = Endoso en Procuración
endosatario	object	Sí	Datos de la entidad financiera o Fintech que recibe el título
condiciones_financieras	object	No	Tasa de descuento, valor desembolsado, fecha pactada
observaciones	string	No	Referencia al contrato de factoring o cesión

Ejemplo de Endoso en Propiedad (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"
  }'