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/EventoReclamoInsertarTipo: 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 camposTipoDocumento,DocumentoyNombresde 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
TipoReclamodebe 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:”.