Skip to main content
El servicio permite a los usuarios registrar el evento RADIAN 031 - Reclamo de la factura electrónica de venta sobre una factura de compra recibida, en línea en formato JSON. Al registrar el evento, la factura de compra queda en estado de aprobación Rechazada y se le asocia el tipo de reclamo enviado. El método de solicitud es POST y se requiere un encabezado “Authorization” para la autenticación, que debe contener un token JWT obtenido previamente del servicio de autenticación.

Prerequisitos

Antes de realizar el registro del evento de reclamo, se debe contar con los siguientes datos:
  • Token solicitado mediante el API de autenticación
  • Número de documento y CUFE de la factura de compra electrónica registrada en la plataforma
  • Datos de la persona autorizada que emite el evento

Registrar evento de reclamo

Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/EventoReclamoInsertar
Tipo: POST
Content Type: application/json
string
required
Número de documento (prefijo y consecutivo) de la factura de compra.
string
required
CUFE de la factura de compra.
string
required
Email del usuario de la plataforma que envía el evento.
string
required
Código DIAN del tipo de reclamo.
string
Observaciones con referencia al evento (máx. 500 caracteres).
object
required
Persona autorizada que emite el evento.

Validaciones

El servicio realiza las siguientes validaciones antes de registrar el evento. Si alguna no se cumple, no se registra el evento y se retorna el error correspondiente.
  • NumeroFacturaCompra, CUFE, TipoReclamo, y los campos TipoDocumento, Documento y Nombres de la persona son obligatorios.
  • La factura de compra debe estar registrada en la plataforma con el número de documento y el CUFE enviados.
  • El TipoReclamo debe corresponder a uno de los códigos de la tabla.
  • La factura de compra debe ser electrónica y estar registrada en la DIAN.
  • La factura de compra no debe tener registrado el evento de aceptación expresa (033).
Si la factura de compra ya tiene registrado el evento de reclamo, el servicio no registra un nuevo evento: retorna el código del evento existente con la descripción “Transacción Exitosa, el evento ya se encuentra regitrado”.

Respuesta

string
Resultado de la operación: “OK” o “Error”.
int
Código único del evento registrado o existente (ID). Retorna -1 cuando ocurre un error.
string
“Transacción Exitosa” cuando el registro es correcto, “Transacción Exitosa, el evento ya se encuentra regitrado” cuando el evento ya existía, o el detalle del error precedido de “Error:”.