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

# Aval (035)

`POST /radian/aval`

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.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)