---
title: "Endoso en garantía (038)"
method: POST
path: "/radian/guarantee-endorsement"
tags: ["RADIAN"]
---

# Endoso en garantía (038)

`POST /radian/guarantee-endorsement`

Endpoint para crear un evento de Endoso en Garantía en el RADIAN. Este evento endosa una factura electrónica de venta como título valor.

Tipos de endoso:
- **01**: En garantía
- **02**: En garantía en blanco

## Request body

- object — Objeto con la información para crear un evento de Endoso en Garantía (038).<br><i>Evento RADIAN 038 - Endoso en garantía</i>
  - `number` string, required — Número del endoso, el valor es alfanumérico, no se puede repetir el numero para el tipo de evento.
  - `type` '01' | '02', required — <b>Tipo de operación</b>, acepta uno de los siguientes códigos:<br><b>01</b>: En garantía<br><b>02</b>: En garantía en blanco
  - `companyId` string, required — Id de la empresa en la que se generará el endoso de garantía. Se utiliza para validar la existencia de la compañía en la base de datos y obtener los datos de la compañía. ⚠️ Importante: La información en la base de datos debe estar completa y actualizada.
  - `endorsedAmount` number, required — <b>Valor sobre el cual el Endosante participará en el endoso.</b><br>Corresponde al monto que el endosante transfiere o endosa dentro de la operación, ya sea de forma total o parcial respecto al valor de la factura.<br><i>Campo oficial DIAN &lt;CorporateStockAmount&gt;</i>
  - `issuerParty` IssuerParty[] — Grupo de información del Adquiriente/Deudor de la Factura Electrónica referenciada.<br><i>Campo oficial DIAN &lt;IssuerParty&gt;</i> — unresolved $ref
  - `notes` object[], required — Información adicional que se quiera agregar en el evento.<br> ⚠️ Importante: Se deberá enviar al menos un elemento donde especifique si el endoso es por garantía, en prenda u otra equivalente.<br><i>Campo oficial DIAN &lt;Note&gt;</i>

## Other responses

- `201` — unresolved $ref
- `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)