Prerequisitos
Antes de realizar el registro del evento de recibo del bien o prestación del servicio, 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 recibo del bien o prestación del servicio
Request URL: https://{{Ambiente}}/API_FE/api/DocumentosElectronicos/EventoRecibimientoBienesInsertarTipo: 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
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, 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.
- 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) ni el de reclamo (031).
Si la factura de compra ya tiene registrado el acuse de recibo del bien o servicio, 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:”.