---
title: "Aval (035)"
method: POST
path: "/radian/aval"
tags: ["RADIAN"]
---

# Aval (035)

`POST /radian/aval`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/radian/aval`
- Auth: HTTP bearer

Endpoint para crear un evento de Aval en el RADIAN. El Aval es una garantía de pago de la factura electrónica como título valor.

## Request body

- object: Objeto con la información para crear un evento de Aval (035)
  - `number` string, required: Número del Aval que se emite, el valor es alfanumérico y único por evento dentro de la misma compañia.
  - `companyId` string, required: Id interno de la empresa en la que se generará el Aval. ⚠️ Importante: La información en la base de datos debe estar completa y actualizada.
  - `associatedDocument` object, required: Objeto que contiene la información del documento de referencia del Aval.<br><i>Campo oficial DIAN &lt;DocumentReference&gt;</i>
    - `prefix` string: Prefijo del documento referenciado.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
    - `number` string, required: Número del documento referenciado.<br><i>Campo oficial DIAN &lt;ID&gt;</i>
    - `uuid` string, required: CUFE del documento referenciado.<br><i>Campo oficial DIAN &lt;UUID&gt;</i>
  - `endorsedFEAmount` number, required: Corresponde al valor total de la factura electrónica de venta como título valor que se va a avalar.<br><i>Campo oficial DIAN &lt;InformacionAvalar&gt;</i>
  - `issuerParty` object[]: Grupo para informar a las personas que son avaladas.
    - `identification` string, required: Número de identificación del o los avalados, sin guiones ni dv.<br><i>Campo oficial DIAN &lt;CompanyID&gt;</i>
    - `identificationType` string, required: Tipo de identificación fiscal. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN.<br><i>Campo oficial DIAN &lt;@schemeName&gt;</i>
    - `dv` string: DV del NIT del avalado.<br><i>Campo oficial DIAN &lt;@schemeID&gt;</i>
    - `organizationType` 1 | 2, required: Identificador de tipo de organización jurídica de la persona o empresa. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN. Persona Jurídica y asimiladas (1). Persona Natural y asimiladas (2)<br><i>Campo oficial DIAN &lt;@schemeVersionID&gt;</i>
    - `name` string, required: Nombre o Razón Social del avalado.<br><i>Campo oficial DIAN &lt;RegistrationName&gt;</i>
    - `guaranteedAmount` number, required: Valor por el cual se avala.<br><i>Campo oficial DIAN &lt;CorporateStockAmount&gt;</i>
  - `notes` string[]: Información adicional que se quiera agregar en el evento.<br><i>Campo oficial DIAN &lt;Note&gt;</i>

## Response `201`

Respuesta exitosa con la información del evento RADIAN

- object
  - `event` object: Objeto que representa un evento RADIAN
    - `id` string: ID único del evento
    - `type` object: Tipo de evento RADIAN
      - `code` string, required: Código del tipo de evento RADIAN
      - `value` string, required: Nombre corto del tipo de evento (ej. Aval, Inscripción RADIAN)
    - `number` string: Consecutivo interno del evento
    - `associatedDocuments` string[]: Lista de documentos asociados al evento
    - `cude` string: CUDE del evento
    - `date` string, date-time: Fecha de creación del evento
    - `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT': Estado técnico del evento
    - `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED': Estado legal ante la DIAN
    - `governmentResponse` object: Respuesta de la DIAN
      - `code` string
      - `message` string
      - `errorMessages` unknown[]
        - unknown
  - `files` object
    - `xml` string: URL presignada para descargar el XML firmado

## Other responses

- `400`: Objeto que representa una respuesta de error por validaciones
- `404`: Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500`: Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)