> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registro (aceptación expresa)

El servicio permite a los usuarios registrar el evento RADIAN **033 - Aceptación expresa 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 **Aprobada**.

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](https://tech.sedierp.com/quickstart.md).

## Prerequisitos

Antes de realizar el registro del evento de aceptación expresa, se debe contar con los siguientes datos:

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)
* Número de documento y CUFE de la factura de compra electrónica registrada en la plataforma
* Evento de recibo del bien o prestación del servicio (032) registrado sobre la factura de compra
* Datos de la persona autorizada que emite el evento

## Registrar evento de aceptación expresa

**Request URL:** https\://\{\{Ambiente}}/API\_FE/api/DocumentosElectronicos/EventoAceptacionExpresaInsertar\
**Tipo:** POST \
**Content Type:** application/json

**NumeroFacturaCompra** `string` *required*

Número de documento (prefijo y consecutivo) de la factura de compra.

**CUFE** `string` *required*

CUFE de la factura de compra.

**UsuarioEmail** `string` *required*

Email del usuario de la plataforma que envía el evento.

**Observaciones** `string`

Observaciones con referencia al evento (máx. 500 caracteres).

**Persona** `object` *required*

Persona autorizada que emite el evento.

**propiedades**

**TipoDocumento** `string` *required*

Código del tipo de documento de identificación de la persona.

| Código | Significado |
| - | - |
| 11 | Registro civil |
| 12 | Tarjeta de identidad |
| 13 | Cédula de ciudadanía |
| 21 | Tarjeta de extranjería |
| 22 | Cédula de extranjería |
| 31 | NIT |
| 41 | Pasaporte |
| 42 | Documento de identificación extranjero |
| 47 | PEP |
| 50 | NIT de otro país |
| 91 | NUIP |

**Documento** `string` *required*

Número de identificación de la persona, sin puntos, sin comas y sin espacios.

**Nombres** `string` *required*

Nombres de la persona.

**Apellidos** `string`

Apellidos de la persona.

```bash theme={null}
curl --location 'https://nsx.sedierp.com/API_FE/api/DocumentosElectronicos/EventoAceptacionExpresaInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN_JWT>' \
--data '{
	"NumeroFacturaCompra": "FE1520",
	"CUFE": "1a99889fdccdf6325f42cc1218ad6180cb2918127833092729c619210545c52212bca287f64cada80181198c5354a70a",
	"UsuarioEmail": "compras@empresa.com",
	"Observaciones": "Mercancía recibida a satisfacción",
	"Persona": {
		"TipoDocumento": "13",
		"Documento": "1032456789",
		"Nombres": "LAURA",
		"Apellidos": "MARTINEZ"
	}
}'
```

### 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 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.
* La factura de compra debe ser electrónica y estar registrada en la DIAN.
* La factura de compra debe tener registrado el evento de recibo del bien o prestación del servicio (032).
* La factura de compra no debe tener registrado el evento de reclamo (031).

> [!NOTE]
>
> Si la factura de compra ya tiene registrado el evento de aceptación expresa, 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

**TipoSalida** `string`

Resultado de la operación: "OK" o "Error".

**Codigo** `int`

Código único del evento registrado o existente (ID). Retorna -1 cuando ocurre un error.

**Descripcion** `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:".

```json Request theme={null}
{
  "NumeroFacturaCompra": "FE1520",
  "CUFE": "1a99889fdccdf6325f42cc1218ad6180cb2918127833092729c619210545c52212bca287f64cada80181198c5354a70a",
  "UsuarioEmail": "compras@empresa.com",
  "Observaciones": "Mercancía recibida a satisfacción",
  "Persona": {
    "TipoDocumento": "13",
    "Documento": "1032456789",
    "Nombres": "LAURA",
    "Apellidos": "MARTINEZ"
  }
}
```

```json Exitosa theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 7715,
    "Descripcion": "Transacción Exitosa"
}
```

```json Existente theme={null}
{
    "TipoSalida": "OK",
    "Codigo": 7715,
    "Descripcion": "Transacción Exitosa, el evento ya se encuentra regitrado"
}
```

```json Error theme={null}
{
    "TipoSalida": "Error",
    "Codigo": -1,
    "Descripcion": "Error: No se puede enviar el evento de ACEPTACIÓN por que no hay un evento de RECIBIMIENTO DE BIENES registrado."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.